Telegram — Search messages in a conversation
Input
query requiredThe text to search for inside the conversation.
peerId requiredThe conversation to search in, as returned by get_inbox. Required — this script drives the per-conversation search box, not Telegram's global search.
count optionalMaximum results to return from what the search dropdown has rendered.
Default: 30Output
count requiredHow many results were returned.
query requiredThe query that was searched.
peerId requiredThe peer id that was searched, read back from the address bar.
results requiredMatching messages in the order the search dropdown lists them (most recent first). Empty when nothing matched.
chatTitle optionalThe conversation title from the header, for a human-readable cross-check against peerId.
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 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.