Тип данных User

Объект, представляющий пользователя или бота Telegram с основной информацией и настройками.

Описание

Этот объект представляет пользователя или бота Telegram.

Поле Тип Описание
id Integer Уникальный идентификатор этого пользователя или бота. Это число может иметь более 32 значащих битов, и некоторые языки программирования могут испытывать трудности/скрытые дефекты при его интерпретации. Но оно имеет не более 52 значащих битов, поэтому 64-битное целое число или тип с плавающей запятой двойной точности безопасны для хранения этого идентификатора.
is_bot Boolean True, если этот пользователь является ботом
first_name String Имя пользователя или бота
last_name String Опционально. Фамилия пользователя или бота
username String Опционально. Имя пользователя (username) пользователя или бота
language_code String Опционально. IETF language tag языка пользователя
is_premium True Опционально. True, если этот пользователь является пользователем Telegram Premium
added_to_attachment_menu True Опционально. True, если этот пользователь добавил бота в меню вложений
can_join_groups Boolean Опционально. True, если бота можно приглашать в группы. Возвращается только в getMe.
can_read_all_group_messages Boolean Опционально. True, если режим конфиденциальности отключен для бота. Возвращается только в getMe.
supports_inline_queries Boolean Опционально. True, если бот поддерживает inline-запросы. Возвращается только в getMe.
can_connect_to_business Boolean Опционально. True, если бот может быть подключен к аккаунту Telegram Business для получения его сообщений. Возвращается только в getMe.
has_main_web_app Boolean Опционально. True, если бот имеет основное Веб-приложение. Возвращается только в getMe.

Примеры

json

{
  "id": 123456789,
  "is_bot": false,
  "first_name": "John",
  "last_name": "Doe",
  "username": "johndoe",
  "language_code": "en",
  "is_premium": true,
  "added_to_attachment_menu": false,
  "can_join_groups": true,
  "can_read_all_group_messages": false,
  "supports_inline_queries": false,
  "can_connect_to_business": true,
  "has_main_web_app": false
}

История изменений

  • API 3.0. Обновлен объект User: Добавлено поле language_code
  • API 3.3. Обновлен объект User: Добавлено поле is_bot
  • API 4.6. Обновлен объект User: Добавлены поля can_join_groups, can_read_all_group_messages, supports_inline_queries
  • API 6.1. Обновлен объект User: Добавлены поля is_premium и added_to_attachment_menu
  • API 7.2. Обновлен объект User: Добавлено поле can_connect_to_business
  • API 7.8. Обновлен объект User: Добавлено поле has_main_web_app
  • API 9.3. Обновлен объект User: Добавлено поле has_topics_enabled для определения включен ли режим тем форума для бота в личных чатах.

Дополнительно

  • getMe - Метод проверки токена бота, возвращающий основную информацию о нём в виде объекта User.
Комментарии