Skip to content

User

This object represents a Telegram user or bot.

15 fields, 3 required.

Used by

Fields

id number Required
Unique identifier for this user or bot. This number may have more than 32 significant bits and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a 64-bit integer or double-precision float type are safe for storing this identifier.

is_bot boolean Required
True, if this user is a bot.

first_name string Required
User’s or bot’s first name.

last_name string
User’s or bot’s last name.

username string
User’s or bot’s username.

language_code string
IETF language tag of the user’s language.

is_premium boolean
True, if this user is a Telegram Premium user.

added_to_attachment_menu boolean
True, if this user added the bot to the attachment menu.

can_join_groups boolean
True, if the bot can be invited to groups. Returned only in getMe.

can_read_all_group_messages boolean
True, if privacy mode is disabled for the bot. Returned only in getMe.

supports_inline_queries boolean
True, if the bot supports inline queries. Returned only in getMe.

can_connect_to_business boolean
True, if the bot can be connected to a Telegram Business account to receive its messages. Returned only in getMe.

has_main_web_app boolean
True, if the bot has a main Web App. Returned only in getMe.

has_topics_enabled boolean
True, if the bot has forum topic mode enabled in private chats. Returned only in getMe.

allows_users_to_create_topics boolean
True, if the bot allows users to create and delete topics in private chats. Returned only in getMe.