Update

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

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

Типы событий

Чтобы добавить новые события в подписку или изменить старые, используйте POST /subscriptions

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

update_type
string

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

chat_id
integer <int64>
ID чата или канала, куда был добавлен бот. Как получить ID — на странице «Получение ID чата или канала»

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

user_id
integer <int64>
Идентификатор пользователя или бота

first_name
string
Отображаемое имя пользователя или бота

last_name
string Nullableoptional
Отображаемая фамилия пользователя. Для ботов это поле не возвращается

username
string Nullable
Никнейм бота или уникальное публичное имя пользователя. В случае с пользователем может быть null, если тот недоступен или имя не задано

is_bot
boolean
true, если это бот

last_activity_time
integer <int64>
Время последней активности пользователя или бота в MAX (Unix timestamp в миллисекундах). Если пользователь отключил в настройках профиля мессенджера MAX возможность видеть, что он в сети, поле может не возвращаться

name
string Nullable
Устаревшее поле, скоро будет удалено

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

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

JSON
{
    "update_type": "bot_added",
    "timestamp": 0,
    "chat_id": 0,
    "user": {
        "user_id": 0,
        "first_name": "string",
        "last_name": "string",
        "username": "string",
        "is_bot": true,
        "last_activity_time": 0,
        "name": "string"
    },
    "is_channel": true
}