Описание
Этот объект представляет входящее обновление.
В любом данном обновлении может присутствовать не более одного из опциональных параметров.
| Поле | Тип | Описание |
|---|---|---|
| update_id | Integer | Уникальный идентификатор обновления. Идентификаторы обновлений начинаются с определенного положительного числа и увеличиваются последовательно. Этот идентификатор становится особенно полезным при использовании webhooks, поскольку позволяет игнорировать повторяющиеся обновления или восстанавливать правильную последовательность обновлений, если они вышли из порядка. Если новых обновлений нет как минимум неделю, идентификатор следующего обновления будет выбран случайным образом вместо последовательного |
| 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 | Опционально. Новый входящий inline запрос |
| chosen_inline_result | ChosenInlineResult | Опционально. Результат inline запроса, который был выбран пользователем и отправлен его собеседнику. Пожалуйста, ознакомьтесь с нашей документацией по сбору отзывов для получения подробной информации о том, как включить эти обновления для вашего бота |
| callback_query | CallbackQuery | Опционально. Новый входящий callback запрос |
| shipping_query | ShippingQuery | Опционально. Новый входящий запрос на доставку. Только для инвойсов с гибкой ценой |
| pre_checkout_query | PreCheckoutQuery | Опционально. Новый входящий предплатежный запрос. Содержит полную информацию о checkout |
| purchased_paid_media | PaidMediaPurchased | Опционально. Пользователь приобрел платный медиа-контент с непустым payload, отправленным ботом в неканальном чате |
| 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 | Опционально. Буст был удален из чата. Бот должен быть администратором в чате, чтобы получать эти обновления |
| managed_bot | ManagedBotUpdated | Опционально. Был создан новый бот для управления текущим ботом, или изменен токен или владелец управляемого бота |
Примеры
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
- API 9.6. Обновлен объект Update: Добавили поле managed_bot к классу Update
Дополнительно
- Message - Это основной объект, представляющий сообщение в Telegram, который содержит информацию об отправителе, чате, контенте (текст, медиа, служебные данные) и различные метаданные.
- BusinessConnection - Объект, описывающий подключение Telegram-бота к бизнес-аккаунту с информацией о пользователе, правах и статусе соединения.
- BusinessMessagesDeleted - Объект, уведомляющий о удалении сообщений из чата бизнес-аккаунта, с информацией о подключении, чате и идентификаторах удалённых сообщений.
- MessageReactionUpdated - Объект, описывающий изменение реакции пользователя на сообщение в чате.
- MessageReactionCountUpdated - Объект, уведомляющий об изменении количества реакций на сообщение с анонимными реакциями.
- InlineQuery - Объект представляет входящий инлайн-запрос от пользователя, содержащий идентификатор, отправителя, текст запроса и опциональные параметры.
- ChosenInlineResult - Объект представляет результат инлайн-запроса, выбранный пользователем и отправленный в чат.
- CallbackQuery - Объект представляет входящий запрос от нажатия кнопки обратного вызова в инлайн-клавиатуре и содержит информацию о запросе, отправителе и связанных данных.
- ShippingQuery - Объект содержит информацию о запросе пользователя на расчёт стоимости доставки товара.
- PreCheckoutQuery - Объект содержит информацию о запросе предварительной проверки оплаты, включая данные о пользователе, валюте, сумме и деталях заказа.
- PaidMediaPurchased - Объект содержит информацию о покупке платного медиаконтента пользователем.
- Poll - Объект, содержащий информацию об опросе, включая вопрос, варианты ответов, настройки и результаты голосования.
- PollAnswer - Объект, содержащий информацию о выбранных вариантах ответа пользователя в неанонимном опросе.
- ChatMemberUpdated - Объект, описывающий изменение статуса участника чата, включая информацию о чате, инициаторе изменения, предыдущих и новых данных участника.
- ChatJoinRequest - Объект, представляющий запрос пользователя на вступление в чат, содержащий информацию о чате, пользователе и пригласительной ссылке.
- ChatBoostUpdated - Объект представляет информацию о добавленном или изменённом бусте в чате.
- ChatBoostRemoved - Объект, описывающий удалённый буст чата с информацией о чате, идентификаторе, времени удаления и источнике.
- ManagedBotUpdated - Этот объект используется для информирования текущего бота о событиях, связанных с управляемым ботом: его создании, смене токена или смене владельца. Содержит информацию как о самом боте, так и о пользователе, выполнившем действие.