Telegram — Get the signed-in account's profile
Input
None
Output
loggedIn requiredWhether this browser has a usable Telegram session. False is a normal result, not a failure, so this can be polled on a schedule without the check counting against its own health.
phone optionalThe phone number on the account, as Telegram formats it for display (e.g. "+33 6 79 34 83 25"). Null if the settings screen showed no phone row, or when there is no session.
evidence optionalOnly set when loggedIn is false: what proved the session absent, so a genuine signed-out reading can be told from a broken run.
displayName optionalThe account's display name — first and last name combined, as shown under the avatar. Null when there is no session.
statusLabel optionalThe presence line beneath the name, verbatim. This one IS translated ("online", "last seen recently", …), so treat it as a display string and do not branch on its text.
FAQ
Get Telegram inbox
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.
Send Telegram message or document
Send a text message, a document, or a document with a caption to a Telegram conversation identified by its peer id (the id get_inbox returns), optionally as a reply. Confirms the send by finding the outgoing bubble in the conversation afterwards rather than trusting the click, reading back the document's filename and size and requiring the quoted-message embed when a reply was asked for, and reports whether the same message or file was already there plus which account sent it. Refuses conversations with no composer, such as broadcast channels you do not administer.
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.