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 — only after the empty list has held steady long enough to rule out a list that is still loading. An unresolvable peer id throws instead.
peerId requiredThe peer id that was actually opened, read back from the address bar.
messages requiredMessages oldest-first, as the conversation displays them.
chatTitle optionalThe conversation title shown in the header, for a human-readable cross-check against peerId.
FAQ
Telegram — Download a message's media
Pull the bytes of a document, photo or video attached to a Telegram message, given its conversation peer id and message id, returned as base64 plus the filename Telegram stores it under. Drives the message's own Download action and reads the file out of the app rather than relying on a browser download, and refuses a message that carries no media. Two side effects worth knowing: opening the conversation marks it read, and Telegram also saves the file to the browser's download folder. Note that photos are Telegram's re-encoded JPEG, not the original upload; documents come back byte-for-byte.
Telegram — List conversations
List the conversations in the Telegram Web chat list, newest first: each one's name, its peer id (the handle every other Telegram script uses to open it), the last message preview, the time shown on the row, and the unread count. Scrolls to load older conversations up to the requested count. Returns an empty list when the account has no conversations, which is a real answer rather than a failure.
Telegram — List a group's members
List the members of a Telegram group, each with their user id, display name, role label and presence, read from the group's own info panel. Returns the member total Telegram reports alongside the rows actually read, so a partially loaded list is visible rather than silently short. Refuses a conversation that exposes no member list at all, which is what a broadcast channel does for anyone who is not an admin. Note that opening the conversation marks it read.