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.
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 — Search messages in a conversation
Search inside one Telegram conversation using the conversation's own search box, and return the matching messages: the chat they are in, the date label shown on the result, and the matched text. Returns an empty list when nothing matches, which is a real answer. Note the result rows carry no message id, so results cannot be fed straight to delete or react — use get_conversation for ids. Searching across all chats is a separate Telegram surface and is not covered here.
Telegram — Get the signed-in account's profile
Read the profile of the Telegram account this browser is signed in as: its display name, the phone number on the account, and the presence label shown beneath the name. Useful for confirming which account a run will act as before doing anything that writes. Does not include username, bio or birthday — Telegram keeps those behind its Edit profile form rather than on the settings screen.