Тип данных Update | Telegram Bot API

Описание

Этот объект представляет входящее обновление.
В любом конкретном обновлении может присутствовать не более одного из необязательных параметров.

Поле	Тип	Описание
update_id	Integer	Уникальный идентификатор обновления. Идентификаторы обновлений начинаются с определённого положительного числа и увеличиваются последовательно. Этот идентификатор особенно полезен при использовании setWebhook, так как позволяет игнорировать повторяющиеся обновления или восстанавливать правильную последовательность обновлений, если они нарушены. Если новых обновлений нет как минимум неделю, то идентификатор следующего обновления будет выбран случайным образом, а не последовательно.
message	Message	Необязательное. Новое входящее сообщение любого типа — текст, фото, стикер и т.д.
edited_message	Message	Необязательное. Новая версия сообщения, которое известно боту и было отредактировано. Это обновление иногда может вызываться изменениями в полях сообщения, которые либо недоступны, либо не используются вашим ботом.
channel_post	Message	Необязательное. Новое входящее сообщение в канале любого типа — текст, фото, стикер и т.д.
edited_channel_post	Message	Необязательное. Новая версия сообщения в канале, которое известно боту и было отредактировано. Это обновление иногда может вызываться изменениями в полях сообщения, которые либо недоступны, либо не используются вашим ботом.
business_connection	BusinessConnection	Необязательное. Бот был подключён к бизнес-аккаунту или отключён от него, либо пользователь отредактировал существующее подключение с ботом.
business_message	Message	Необязательное. Новое сообщение от подключённого бизнес-аккаунта.
edited_business_message	Message	Необязательное. Новая версия сообщения от подключённого бизнес-аккаунта.
deleted_business_messages	BusinessMessagesDeleted	Необязательное. Сообщения были удалены из подключённого бизнес-аккаунта.
message_reaction	MessageReactionUpdated	Необязательное. Реакция на сообщение была изменена пользователем. Бот должен быть администратором в чате и явно указать `"message_reaction"` в списке allowed_updates, чтобы получать эти обновления. Обновление не приходит для реакций, установленных ботами.
message_reaction_count	MessageReactionCountUpdated	Необязательное. Реакции на сообщение с анонимными реакциями были изменены. Бот должен быть администратором в чате и явно указать `"message_reaction_count"` в списке allowed_updates, чтобы получать эти обновления. Обновления группируются и могут отправляться с задержкой до нескольких минут.
inline_query	InlineQuery	Необязательное. Новый входящий инлайн-запрос.
chosen_inline_result	ChosenInlineResult	Необязательное. Результат инлайн-запроса, который был выбран пользователем и отправлен его собеседнику. Подробнее о том, как включить эти обновления для вашего бота, смотрите в нашей документации по сбору обратной связи.
callback_query	CallbackQuery	Необязательное. Новый входящий callback-запрос.
shipping_query	ShippingQuery	Необязательное. Новый входящий запрос на доставку. Только для счетов с гибкой ценой.
pre_checkout_query	PreCheckoutQuery	Необязательное. Новый входящий предварительный запрос на оплату. Содержит полную информацию о платеже.
purchased_paid_media	PaidMediaPurchased	Необязательное. Пользователь приобрёл платный медиафайл с непустым полезным содержимым, отправленным ботом в неканальном чате.
poll	Poll	Необязательное. Новое состояние опроса. Боты получают обновления только об остановленных вручную опросах и опросах, отправленных самим ботом.
poll_answer	PollAnswer	Необязательное. Пользователь изменил свой ответ в неанонимном опросе. Боты получают новые голоса только в опросах, отправленных самим ботом.
my_chat_member	ChatMemberUpdated	Необязательное. Статус бота как участника чата был обновлён в чате. Для личных чатов это обновление приходит только тогда, когда пользователь блокирует или разблокирует бота.
chat_member	ChatMemberUpdated	Необязательное. Статус участника чата был обновлён в чате. Бот должен быть администратором в чате и явно указать `"chat_member"` в списке allowed_updates, чтобы получать эти обновления.
chat_join_request	ChatJoinRequest	Необязательное. Была отправлена заявка на вступление в чат. Бот должен иметь право администратора can_invite_users в чате, чтобы получать эти обновления.
chat_boost	ChatBoostUpdated	Необязательное. Буст чата был добавлен или изменён. Бот должен быть администратором в чате, чтобы получать эти обновления.
removed_chat_boost	ChatBoostRemoved	Необязательное. Буст был удалён из чата. Бот должен быть администратором в чате, чтобы получать эти обновления.

Примеры

json

{
  "update_id": 123456789,
  "message": {
    "message_id": 1,
    "from": {
      "id": 987654321,
      "is_bot": false,
      "first_name": "John",
      "last_name": "Doe",
      "username": "johndoe",
      "language_code": "en"
    },
    "chat": {
      "id": 987654321,
      "first_name": "John",
      "last_name": "Doe",
      "username": "johndoe",
      "type": "private"
    },
    "date": 1609459200,
    "text": "Hello, bot!"
  }
}

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

API 2.1.. Обновлен объект Update: Добавлено поле edited_message
API 2.3. Обновлен объект Update: Добавлены поля channel_post и edited_channel_post для получения обновлений о постах в каналах
API 3.0. Обновлен объект Update: Добавлены новые типы обновлений shipping_query и pre_checkout_query
API 4.2. Обновлен объект Update: Добавлено поле poll для получения обновлений опросов
API 4.3. Обновлен объект Update: Боты теперь получают edited_message даже при изменении только reply_markup
API 4.6. Обновлен объект Update: Добавлено поле poll_answer
API 5.1. Обновлен объект Update: Добавлены поля my_chat_member и chat_member для обновлений статуса участников
API 5.4. Обновлен объект Update: Добавлено поле chat_join_request
API 7.0. Обновлен объект Update: Добавлено поле message_reaction
API 7.2. Обновлен объект Update: Добавлены поля business_connection, business_message, edited_business_message, deleted_business_messages
API 7.10. Обновлен объект Update: Добавлено поле purchased_paid_media

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

setWebhook - Метод для установки URL-адреса вебхука, на который Telegram будет отправлять HTTPS POST-запросы с обновлениями для вашего бота.
Message - Это основной объект, представляющий сообщение в Telegram, который содержит информацию об отправителе, чате, контенте (текст, медиа, служебные данные) и различные метаданные.
BusinessConnection - Объект, описывающий подключение Telegram-бота к бизнес-аккаунту с информацией о пользователе, правах и статусе соединения.
BusinessMessagesDeleted - Объект, уведомляющий о удалении сообщений из чата бизнес-аккаунта, с информацией о подключении, чате и идентификаторах удалённых сообщений.
MessageReactionUpdated - Объект, описывающий изменение реакции пользователя на сообщение в чате.
MessageReactionCountUpdated - Объект, уведомляющий об изменении количества реакций на сообщение с анонимными реакциями.
InlineQuery - Объект представляет входящий инлайн-запрос от пользователя, содержащий идентификатор, отправителя, текст запроса и опциональные параметры.
ChosenInlineResult - Объект представляет результат инлайн-запроса, выбранный пользователем и отправленный в чат.
CallbackQuery - Объект представляет входящий запрос от нажатия кнопки обратного вызова в инлайн-клавиатуре и содержит информацию о запросе, отправителе и связанных данных.
ShippingQuery - Объект содержит информацию о запросе пользователя на расчёт стоимости доставки товара.
PreCheckoutQuery - Объект содержит информацию о запросе предварительной проверки оплаты, включая данные о пользователе, валюте, сумме и деталях заказа.
PaidMediaPurchased - Объект содержит информацию о покупке платного медиаконтента пользователем.
Poll - Объект, содержащий информацию об опросе, включая вопрос, варианты ответов, настройки и результаты голосования.
PollAnswer - Объект, содержащий информацию о выбранных вариантах ответа пользователя в неанонимном опросе.
ChatMemberUpdated - Объект, описывающий изменение статуса участника чата, включая информацию о чате, инициаторе изменения, предыдущих и новых данных участника.
ChatJoinRequest - Объект, представляющий запрос пользователя на вступление в чат, содержащий информацию о чате, пользователе и пригласительной ссылке.
ChatBoostUpdated - Объект представляет информацию о добавленном или изменённом бусте в чате.
ChatBoostRemoved - Объект, описывающий удалённый буст чата с информацией о чате, идентификаторе, времени удаления и источнике.