Update

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

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

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

Типы событий

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

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

- bot_stopped — пользователь остановил бота – выбрал соответствующее действие в настройках бота в МАКС

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

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

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

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

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

- dialog_removed — пользователь удалил диалог с ботом

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

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

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

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

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

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

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

update_type
string

bot_added

timestamp
integer <int64>

Unix-время, когда произошло событие

chat_id
integer <int64>

ID чата, куда был добавлен бот

user
object User

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

is_channel
boolean

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

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

JSON

Скопировать

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