Тип данных 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, если privacy-mode отключен для бота. Возвращается только в getMe.
supports_inline_queries Boolean Опционально. True, если бот поддерживает инлайн-запросы. Возвращается только в getMe.
can_connect_to_business Boolean Опционально. True, если бота можно подключить к аккаунту Telegram Business для получения его сообщений. Возвращается только в getMe.
has_main_web_app Boolean Опционально. True, если у бота есть главное Web App. Возвращается только в getMe.
has_topics_enabled Boolean Опционально. True, если у бота включен режим тем форума в приватных чатах. Возвращается только в getMe.
allows_users_to_create_topics Boolean Опционально. True, если бот позволяет пользователям создавать и удалять темы в приватных чатах. Возвращается только в getMe.
can_manage_bots 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 для определения включен ли режим тем форума для бота в личных чатах.
  • API 9.4. Обновлен объект User: Добавлено поле allows_users_to_create_topics
  • API 9.6. Обновлен объект User: Добавили поле can_manage_bots к классу User

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

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