Telegram — Read a conversation's messages
Input
peerId requiredThe conversation's peer id, as returned by get_inbox (e.g. "-1001928149680"). Passed straight to Telegram's own deep link, so it must be the id and not a display name.
count optionalHow many of the most recent messages to return, scrolling upward to load older ones.
Default: 30Output
count requiredHow many messages were returned.
state required"ready" when message bubbles rendered; "empty" for a conversation that resolved (it has a title) but holds no messages. An unresolvable peer id throws instead, so it can never be confused with either.
peerId requiredThe peer id that was actually opened, read back from the address bar so the caller can confirm it matches the request.
messages requiredMessages oldest-first, as the conversation displays them. Empty for a conversation that exists but holds no messages.
chatTitle optionalThe conversation title shown in the header, for a human-readable cross-check against peerId.
