Telegram — Get a person's contact info
Input
peerId requiredThe person's Telegram user id — a positive integer, e.g. "93372553". get_group_members returns exactly this as each member's userId. Group and channel ids are negative and are refused, since they have no contact info. Your own id is refused too — Telegram routes it to Saved Messages; use get_own_profile for yourself.
Output
name requiredThe person's display name as the profile renders it.
peerId requiredThe user id that was actually opened, read back from the address bar.
verified_on_page requiredTrue when the fields were read from a rendered profile panel, rather than an empty panel being reported as a profile with no details.
bio optionalThe bio / about text, or null when empty. For a bot this is its description.
phone optionalThe phone number as Telegram displays it, or null when no phone row is shown. Null does NOT mean the person has no phone — Telegram only shows it for contacts who share it, so treat null as "not visible to this account". Unverified against a populated row: the account used for development has no contacts, so only the absent case was observed.
username optionalTheir @username without the leading @, or null when they have none. Located by the panel's mention icon, not by the translated "Username" label beside it.
statusLabel optionalThe line under the name — presence for a person (online, last seen recently), or the monthly-user count for a bot. Telegram's own wording, so translated: treat as display text, not a state to branch on.
FAQ
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. When this browser is not signed in to Telegram Web, the run fails with a signed-out error that says to sign in there. Does not include username, bio or birthday: Telegram keeps those behind its Edit profile form rather than on the settings screen.
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.
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.