Get Telegram inbox
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" when the app shell mounted and the chat list then STAYED empty for a hold period (4s with the list container mounted, 12s without), which is how an account with no conversations looks - reported rather than treated as a failure. The hold is what distinguishes it from an account still syncing, whose list fills during the hold; a run that never settles either way throws instead, as does being signed out, so neither can be confused with "empty". Renamed from "empty-or-syncing" in v2: that hedge existed only because v1 could not tell the two states apart.
FAQ
Get Telegram conversation
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.