Update

Объект Update описывает возможные события в чате или канале. Может возвращаться в следующих случаях:

Вы подписались на обновления через Webhook — при наступлении события МАКС пришлёт POST-запрос /subscriptions, который содержит объект Update
Вы отправили GET-запрос /updates для получения обновлений через Long Polling — в ответ вернётся объект Update

Получение обновлений с помощью Long Polling ограничено по скорости и сроку хранения событий — этот способ не подходит для production-окружения. Рекомендуем на всех этапах работы использовать Webhook

Типы событий

- bot_added — бот добавлен в чат или канал

- bot_started — пользователь впервые начал общение с ботом или возобновил после остановки — нажал соответствующую кнопку в настройках бота в МАКС

- bot_stopped — пользователь остановил или удалил бота через настройки бота в МАКС. Во втором случае одновременно с bot_stopped возвращается событие dialog_removed

- bot_removed — бот удалён из чата или канала

- chat_title_changed — пользователь изменил название чата или канала

- dialog_cleared — пользователь очистил историю диалога с ботом

- dialog_muted — пользователь отключил уведомления в диалоге с ботом

- dialog_unmuted — пользователь включил уведомления в диалоге с ботом

- dialog_removed — пользователь удалил диалог с ботом. Вместе с этим событием одновременно возвращается bot_stopped — при удалении диалога бот останавливается автоматически

- message_callback — пользователь нажал на кнопку в чате или канале

- message_created — пользователь отправил новое сообщение или опубликовал пост

- message_edited — пользователь отредактировал сообщение в чате, пост в канале

- message_removed — пользователь удалил сообщение из чата или канала

- comment_created — пользователь или бот опубликовал новый комментарий. Для бота на свои действия события не приходят

- comment_edited — пользователь или бот изменил комментарий в канале. Обратите внимание, боты могут изменять только свои комментарии. Для бота на свои действия события не приходят

- comment_removed — пользователь или бот удалил комментарий. Для бота на свои действия события не приходят

- user_added — в чат или канал добавлен или перешёл по ссылке новый пользователь

- user_removed — пользователь удалён или покинул чат или канал

bot_admin_permissions_changed — изменены права бота-администратора

Свойства объекта Update

update_type
string

bot_added

timestamp
integer <int64>

Unix timestamp в миллисекундах, когда произошло событие

chat_id
integer <int64>

ID чата или канала, куда был добавлен бот. Как получить ID — в разделе «Получение chat_id»

user
object User

Пользователь, добавивший бота в чат

is_channel
boolean

Указывает, что бот добавлен в канал, а не в чат

Пример объекта

JSON

Скопировать

{
    "update_type": "bot_added",
    "timestamp": 0,
    "chat_id": 0,
    "user": { ... },
    "is_channel": true
}