Telegram — List conversations
Input
count optionalMaximum conversations to return, scrolling the chat list to load older ones.
Default: 30Output
chats requiredConversations in the order the chat list shows them (most recent activity first). Empty when the account has none.
count requiredHow many conversations were returned.
state required"ready" when the chat list rendered rows. "empty-or-syncing" when the app shell mounted but no rows appeared, which is how an account with no conversations looks - report it rather than treating an empty list as a failure. Being signed out throws instead, so it can never be confused with either.
FAQ
Telegram — Read a conversation's messages
Open one Telegram conversation by its peer id (the id get_inbox returns) and read its messages in chronological order: message id, text, the time shown on the bubble, whether it carries media, and — for channel posts — the exact view and forward counts. Scrolls upward to load older messages up to the requested count. Returns an empty list for a conversation with no messages, which is a real answer rather than a failure.
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 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.