Update
Объект Update описывает возможные события в чате или канале. Может возвращаться в следующих случаях:
-
Вы подписались на обновления через Webhook — при наступлении события MAX пришлёт POST-запрос
/subscriptions, который содержит объектUpdate -
Вы отправили GET-запрос /updates для получения обновлений через Long Polling — в ответ вернётся объект
Update
Получение обновлений с помощью Long Polling ограничено по скорости и сроку хранения событий — этот способ не подходит для production-окружения. Рекомендуем на всех этапах работы использовать Webhook
Типы событий
Чтобы добавить новые события в подписку или изменить старые, используйте POST /subscriptions
-
bot_added— бот добавлен в чат или канал -
bot_started— пользователь впервые начал общение с ботом или возобновил после остановки — нажал соответствующую кнопку в настройках бота в MAX -
bot_stopped— пользователь остановил или удалил бота через настройки бота в MAX. Во втором случае одновременно с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— изменены права бота-администратора в канале или групповом чате. Событие возвращается пока только через Webhook – для Long Polling недоступно
Свойства объекта Update
Start
true, если это бот
до 512 символов
Дополнительные данные из диплинков, переданные при запуске бота. Подробнее о диплинках — в разделе FAQ
true, если это бот
true, если это бот
true, если это бот
true, если это бот
true, если это бот
true, если это бот
true, если это бот
true, если это бот
null, если оно было удалено к моменту, когда бот получил это событие
Отправитель сообщения: пользователь или бот
Обратите внимание:
- Все параметры в объекте относятся к отправителю сообщения
- Объект отсутствует, если сообщение отправлено в канал
true, если это бот
Получатель сообщения: пользователь или бот (для диалога), канал или чат
Обратите внимание: все параметры в объекте относятся к получателю сообщения
Возможные значения в enum: "chat" "channel" "dialog"
Тип чата:
chat— групповой чатchannel— канал или комментарий к посту (для вызовов методов группы/comments)dialog— диалог
Возможные значения в enum: "forward" "reply"
Тип связанного сообщения:
"reply"— ответ на сообщение в чате"forward"— пересланное сообщение в чате
true, если это бот
type = forward. Как получить ID — на странице «Получение ID чата или канала»
attachment, описанных в схеме ниже
Если поле пустое или равно null, изменений не произойдёт. Если массив пуст, все вложения будут удалены
expires — если он истёк, ссылку необходимо запросить повторно. Доступно в веб-клиентe и на Android
URL вложения, который возвращается в объекте Update после отправки сообщения в чат или канал
В случае с вложенным видео прямую ссылку также можно получить с помощью метода GET /videos/{-videoToken-}
token, если вы пытаетесь повторно использовать одно и то же вложение в другом сообщении
Результат загрузки аудиосообщения или аудиофайла
Если пользователь отправил боту аудиосообщение, то ответах на запросы получения информации о сообщениях вернётся тип audio
URL вложения, который возвращается в объекте Update после отправки сообщения в чат или канал
В случае с вложенным видео прямую ссылку также можно получить с помощью метода GET /videos/{-videoToken-}
token, если вы пытаетесь повторно использовать одно и то же вложение в другом сообщении
URL вложения, который возвращается в объекте Update после отправки сообщения в чат или канал
В случае с вложенным видео прямую ссылку также можно получить с помощью метода GET /videos/{-videoToken-}
token, если вы пытаетесь повторно использовать одно и то же вложение в другом сообщении
URL вложения, который возвращается в объекте Update после отправки сообщения в чат или канал
В случае с вложенным видео прямую ссылку также можно получить с помощью метода GET /videos/{-videoToken-}
true, если это бот
от 1 до 128 символов
Видимый текст кнопки. Чтобы он отображался полностью, рекомендуем не превышать заданное количество символов в зависимости от размещения текста: 20 символов — при одной кнопке в ряду, 10 — при двух, 5 — при трёх, 3 — при четырёх
до 1024 символов
Токен кнопки
2048 символов
true, отправляет местоположение без запроса подтверждения пользователя
Если false, возвращает модальное окно с дополнительным уточнением об отправке местоположения
до 1024 символов
Текст, который будет скопирован
от 1 символа
URL, прикреплённый к сообщению для предпросмотра медиавложения
Тип элемента разметки. Может быть жирный, курсив, ~зачеркнутый~, подчеркнутый, моноширинный, выделенный, цитата, заголовок, ссылка или упоминание пользователя
Обратите внимание: в тексте комментариев не поддерживаются гиперссылки и упоминания пользователей
от 1 до 2048 символов
URL ссылки
@username упомянутого пользователя
null, если сообщение содержит только пересланное сообщение
attachment, описанных в схеме ниже
Если поле пустое или равно null, изменений не произойдёт. Если массив пуст, все вложения будут удалены
expires — если он истёк, ссылку необходимо запросить повторно. Доступно в веб-клиентe и на Android
URL вложения, который возвращается в объекте Update после отправки сообщения в чат или канал
В случае с вложенным видео прямую ссылку также можно получить с помощью метода GET /videos/{-videoToken-}
token, если вы пытаетесь повторно использовать одно и то же вложение в другом сообщении
Результат загрузки аудиосообщения или аудиофайла
Если пользователь отправил боту аудиосообщение, то ответах на запросы получения информации о сообщениях вернётся тип audio
URL вложения, который возвращается в объекте Update после отправки сообщения в чат или канал
В случае с вложенным видео прямую ссылку также можно получить с помощью метода GET /videos/{-videoToken-}
token, если вы пытаетесь повторно использовать одно и то же вложение в другом сообщении
URL вложения, который возвращается в объекте Update после отправки сообщения в чат или канал
В случае с вложенным видео прямую ссылку также можно получить с помощью метода GET /videos/{-videoToken-}
token, если вы пытаетесь повторно использовать одно и то же вложение в другом сообщении
URL вложения, который возвращается в объекте Update после отправки сообщения в чат или канал
В случае с вложенным видео прямую ссылку также можно получить с помощью метода GET /videos/{-videoToken-}
true, если это бот
от 1 до 128 символов
Видимый текст кнопки. Чтобы он отображался полностью, рекомендуем не превышать заданное количество символов в зависимости от размещения текста: 20 символов — при одной кнопке в ряду, 10 — при двух, 5 — при трёх, 3 — при четырёх
до 1024 символов
Токен кнопки
2048 символов
true, отправляет местоположение без запроса подтверждения пользователя
Если false, возвращает модальное окно с дополнительным уточнением об отправке местоположения
до 1024 символов
Текст, который будет скопирован
от 1 символа
URL, прикреплённый к сообщению для предпросмотра медиавложения
Тип элемента разметки. Может быть жирный, курсив, ~зачеркнутый~, подчеркнутый, моноширинный, выделенный, цитата, заголовок, ссылка или упоминание пользователя
Обратите внимание: в тексте комментариев не поддерживаются гиперссылки и упоминания пользователей
от 1 до 2048 символов
URL ссылки
@username упомянутого пользователя
Отправитель сообщения: пользователь или бот
Обратите внимание:
- Все параметры в объекте относятся к отправителю сообщения
- Объект отсутствует, если сообщение отправлено в канал
true, если это бот
Получатель сообщения: пользователь или бот (для диалога), канал или чат
Обратите внимание: все параметры в объекте относятся к получателю сообщения
Возможные значения в enum: "chat" "channel" "dialog"
Тип чата:
chat— групповой чатchannel— канал или комментарий к посту (для вызовов методов группы/comments)dialog— диалог
Возможные значения в enum: "forward" "reply"
Тип связанного сообщения:
"reply"— ответ на сообщение в чате"forward"— пересланное сообщение в чате
true, если это бот
type = forward. Как получить ID — на странице «Получение ID чата или канала»
attachment, описанных в схеме ниже
Если поле пустое или равно null, изменений не произойдёт. Если массив пуст, все вложения будут удалены
expires — если он истёк, ссылку необходимо запросить повторно. Доступно в веб-клиентe и на Android
URL вложения, который возвращается в объекте Update после отправки сообщения в чат или канал
В случае с вложенным видео прямую ссылку также можно получить с помощью метода GET /videos/{-videoToken-}
token, если вы пытаетесь повторно использовать одно и то же вложение в другом сообщении
Результат загрузки аудиосообщения или аудиофайла
Если пользователь отправил боту аудиосообщение, то ответах на запросы получения информации о сообщениях вернётся тип audio
URL вложения, который возвращается в объекте Update после отправки сообщения в чат или канал
В случае с вложенным видео прямую ссылку также можно получить с помощью метода GET /videos/{-videoToken-}
token, если вы пытаетесь повторно использовать одно и то же вложение в другом сообщении
URL вложения, который возвращается в объекте Update после отправки сообщения в чат или канал
В случае с вложенным видео прямую ссылку также можно получить с помощью метода GET /videos/{-videoToken-}
token, если вы пытаетесь повторно использовать одно и то же вложение в другом сообщении
URL вложения, который возвращается в объекте Update после отправки сообщения в чат или канал
В случае с вложенным видео прямую ссылку также можно получить с помощью метода GET /videos/{-videoToken-}
true, если это бот
от 1 до 128 символов
Видимый текст кнопки. Чтобы он отображался полностью, рекомендуем не превышать заданное количество символов в зависимости от размещения текста: 20 символов — при одной кнопке в ряду, 10 — при двух, 5 — при трёх, 3 — при четырёх
до 1024 символов
Токен кнопки
2048 символов
true, отправляет местоположение без запроса подтверждения пользователя
Если false, возвращает модальное окно с дополнительным уточнением об отправке местоположения
до 1024 символов
Текст, который будет скопирован
от 1 символа
URL, прикреплённый к сообщению для предпросмотра медиавложения
Тип элемента разметки. Может быть жирный, курсив, ~зачеркнутый~, подчеркнутый, моноширинный, выделенный, цитата, заголовок, ссылка или упоминание пользователя
Обратите внимание: в тексте комментариев не поддерживаются гиперссылки и упоминания пользователей
от 1 до 2048 символов
URL ссылки
@username упомянутого пользователя
null, если сообщение содержит только пересланное сообщение
attachment, описанных в схеме ниже
Если поле пустое или равно null, изменений не произойдёт. Если массив пуст, все вложения будут удалены
expires — если он истёк, ссылку необходимо запросить повторно. Доступно в веб-клиентe и на Android
URL вложения, который возвращается в объекте Update после отправки сообщения в чат или канал
В случае с вложенным видео прямую ссылку также можно получить с помощью метода GET /videos/{-videoToken-}
token, если вы пытаетесь повторно использовать одно и то же вложение в другом сообщении
Результат загрузки аудиосообщения или аудиофайла
Если пользователь отправил боту аудиосообщение, то ответах на запросы получения информации о сообщениях вернётся тип audio
URL вложения, который возвращается в объекте Update после отправки сообщения в чат или канал
В случае с вложенным видео прямую ссылку также можно получить с помощью метода GET /videos/{-videoToken-}
token, если вы пытаетесь повторно использовать одно и то же вложение в другом сообщении
URL вложения, который возвращается в объекте Update после отправки сообщения в чат или канал
В случае с вложенным видео прямую ссылку также можно получить с помощью метода GET /videos/{-videoToken-}
token, если вы пытаетесь повторно использовать одно и то же вложение в другом сообщении
URL вложения, который возвращается в объекте Update после отправки сообщения в чат или канал
В случае с вложенным видео прямую ссылку также можно получить с помощью метода GET /videos/{-videoToken-}
true, если это бот
от 1 до 128 символов
Видимый текст кнопки. Чтобы он отображался полностью, рекомендуем не превышать заданное количество символов в зависимости от размещения текста: 20 символов — при одной кнопке в ряду, 10 — при двух, 5 — при трёх, 3 — при четырёх
до 1024 символов
Токен кнопки
2048 символов
true, отправляет местоположение без запроса подтверждения пользователя
Если false, возвращает модальное окно с дополнительным уточнением об отправке местоположения
до 1024 символов
Текст, который будет скопирован
от 1 символа
URL, прикреплённый к сообщению для предпросмотра медиавложения
Тип элемента разметки. Может быть жирный, курсив, ~зачеркнутый~, подчеркнутый, моноширинный, выделенный, цитата, заголовок, ссылка или упоминание пользователя
Обратите внимание: в тексте комментариев не поддерживаются гиперссылки и упоминания пользователей
от 1 до 2048 символов
URL ссылки
@username упомянутого пользователя
Отправитель сообщения: пользователь или бот
Обратите внимание:
- Все параметры в объекте относятся к отправителю сообщения
- Объект отсутствует, если сообщение отправлено в канал
true, если это бот
Получатель сообщения: пользователь или бот (для диалога), канал или чат
Обратите внимание: все параметры в объекте относятся к получателю сообщения
Возможные значения в enum: "chat" "channel" "dialog"
Тип чата:
chat— групповой чатchannel— канал или комментарий к посту (для вызовов методов группы/comments)dialog— диалог
Возможные значения в enum: "forward" "reply"
Тип связанного сообщения:
"reply"— ответ на сообщение в чате"forward"— пересланное сообщение в чате
true, если это бот
type = forward. Как получить ID — на странице «Получение ID чата или канала»
attachment, описанных в схеме ниже
Если поле пустое или равно null, изменений не произойдёт. Если массив пуст, все вложения будут удалены
expires — если он истёк, ссылку необходимо запросить повторно. Доступно в веб-клиентe и на Android
URL вложения, который возвращается в объекте Update после отправки сообщения в чат или канал
В случае с вложенным видео прямую ссылку также можно получить с помощью метода GET /videos/{-videoToken-}
token, если вы пытаетесь повторно использовать одно и то же вложение в другом сообщении
Результат загрузки аудиосообщения или аудиофайла
Если пользователь отправил боту аудиосообщение, то ответах на запросы получения информации о сообщениях вернётся тип audio
URL вложения, который возвращается в объекте Update после отправки сообщения в чат или канал
В случае с вложенным видео прямую ссылку также можно получить с помощью метода GET /videos/{-videoToken-}
token, если вы пытаетесь повторно использовать одно и то же вложение в другом сообщении
URL вложения, который возвращается в объекте Update после отправки сообщения в чат или канал
В случае с вложенным видео прямую ссылку также можно получить с помощью метода GET /videos/{-videoToken-}
token, если вы пытаетесь повторно использовать одно и то же вложение в другом сообщении
URL вложения, который возвращается в объекте Update после отправки сообщения в чат или канал
В случае с вложенным видео прямую ссылку также можно получить с помощью метода GET /videos/{-videoToken-}
true, если это бот
от 1 до 128 символов
Видимый текст кнопки. Чтобы он отображался полностью, рекомендуем не превышать заданное количество символов в зависимости от размещения текста: 20 символов — при одной кнопке в ряду, 10 — при двух, 5 — при трёх, 3 — при четырёх
до 1024 символов
Токен кнопки
2048 символов
true, отправляет местоположение без запроса подтверждения пользователя
Если false, возвращает модальное окно с дополнительным уточнением об отправке местоположения
до 1024 символов
Текст, который будет скопирован
от 1 символа
URL, прикреплённый к сообщению для предпросмотра медиавложения
Тип элемента разметки. Может быть жирный, курсив, ~зачеркнутый~, подчеркнутый, моноширинный, выделенный, цитата, заголовок, ссылка или упоминание пользователя
Обратите внимание: в тексте комментариев не поддерживаются гиперссылки и упоминания пользователей
от 1 до 2048 символов
URL ссылки
@username упомянутого пользователя
null, если сообщение содержит только пересланное сообщение
attachment, описанных в схеме ниже
Если поле пустое или равно null, изменений не произойдёт. Если массив пуст, все вложения будут удалены
expires — если он истёк, ссылку необходимо запросить повторно. Доступно в веб-клиентe и на Android
URL вложения, который возвращается в объекте Update после отправки сообщения в чат или канал
В случае с вложенным видео прямую ссылку также можно получить с помощью метода GET /videos/{-videoToken-}
token, если вы пытаетесь повторно использовать одно и то же вложение в другом сообщении
Результат загрузки аудиосообщения или аудиофайла
Если пользователь отправил боту аудиосообщение, то ответах на запросы получения информации о сообщениях вернётся тип audio
URL вложения, который возвращается в объекте Update после отправки сообщения в чат или канал
В случае с вложенным видео прямую ссылку также можно получить с помощью метода GET /videos/{-videoToken-}
token, если вы пытаетесь повторно использовать одно и то же вложение в другом сообщении
URL вложения, который возвращается в объекте Update после отправки сообщения в чат или канал
В случае с вложенным видео прямую ссылку также можно получить с помощью метода GET /videos/{-videoToken-}
token, если вы пытаетесь повторно использовать одно и то же вложение в другом сообщении
URL вложения, который возвращается в объекте Update после отправки сообщения в чат или канал
В случае с вложенным видео прямую ссылку также можно получить с помощью метода GET /videos/{-videoToken-}
true, если это бот
от 1 до 128 символов
Видимый текст кнопки. Чтобы он отображался полностью, рекомендуем не превышать заданное количество символов в зависимости от размещения текста: 20 символов — при одной кнопке в ряду, 10 — при двух, 5 — при трёх, 3 — при четырёх
до 1024 символов
Токен кнопки
2048 символов
true, отправляет местоположение без запроса подтверждения пользователя
Если false, возвращает модальное окно с дополнительным уточнением об отправке местоположения
до 1024 символов
Текст, который будет скопирован
от 1 символа
URL, прикреплённый к сообщению для предпросмотра медиавложения
Тип элемента разметки. Может быть жирный, курсив, ~зачеркнутый~, подчеркнутый, моноширинный, выделенный, цитата, заголовок, ссылка или упоминание пользователя
Обратите внимание: в тексте комментариев не поддерживаются гиперссылки и упоминания пользователей
от 1 до 2048 символов
URL ссылки
@username упомянутого пользователя
Отправитель сообщения: пользователь или бот
Обратите внимание:
- Все параметры в объекте относятся к отправителю сообщения
- Объект отсутствует, если сообщение отправлено в канал
true, если это бот
Получатель сообщения: пользователь или бот (для диалога), канал или чат
Обратите внимание: все параметры в объекте относятся к получателю сообщения
Возможные значения в enum: "chat" "channel" "dialog"
Тип чата:
chat— групповой чатchannel— канал или комментарий к посту (для вызовов методов группы/comments)dialog— диалог
Возможные значения в enum: "forward" "reply"
Тип связанного сообщения:
"reply"— ответ на сообщение в чате"forward"— пересланное сообщение в чате
true, если это бот
type = forward. Как получить ID — на странице «Получение ID чата или канала»
attachment, описанных в схеме ниже
Если поле пустое или равно null, изменений не произойдёт. Если массив пуст, все вложения будут удалены
expires — если он истёк, ссылку необходимо запросить повторно. Доступно в веб-клиентe и на Android
URL вложения, который возвращается в объекте Update после отправки сообщения в чат или канал
В случае с вложенным видео прямую ссылку также можно получить с помощью метода GET /videos/{-videoToken-}
token, если вы пытаетесь повторно использовать одно и то же вложение в другом сообщении
Результат загрузки аудиосообщения или аудиофайла
Если пользователь отправил боту аудиосообщение, то ответах на запросы получения информации о сообщениях вернётся тип audio
URL вложения, который возвращается в объекте Update после отправки сообщения в чат или канал
В случае с вложенным видео прямую ссылку также можно получить с помощью метода GET /videos/{-videoToken-}
token, если вы пытаетесь повторно использовать одно и то же вложение в другом сообщении
URL вложения, который возвращается в объекте Update после отправки сообщения в чат или канал
В случае с вложенным видео прямую ссылку также можно получить с помощью метода GET /videos/{-videoToken-}
token, если вы пытаетесь повторно использовать одно и то же вложение в другом сообщении
URL вложения, который возвращается в объекте Update после отправки сообщения в чат или канал
В случае с вложенным видео прямую ссылку также можно получить с помощью метода GET /videos/{-videoToken-}
true, если это бот
от 1 до 128 символов
Видимый текст кнопки. Чтобы он отображался полностью, рекомендуем не превышать заданное количество символов в зависимости от размещения текста: 20 символов — при одной кнопке в ряду, 10 — при двух, 5 — при трёх, 3 — при четырёх
до 1024 символов
Токен кнопки
2048 символов
true, отправляет местоположение без запроса подтверждения пользователя
Если false, возвращает модальное окно с дополнительным уточнением об отправке местоположения
до 1024 символов
Текст, который будет скопирован
от 1 символа
URL, прикреплённый к сообщению для предпросмотра медиавложения
Тип элемента разметки. Может быть жирный, курсив, ~зачеркнутый~, подчеркнутый, моноширинный, выделенный, цитата, заголовок, ссылка или упоминание пользователя
Обратите внимание: в тексте комментариев не поддерживаются гиперссылки и упоминания пользователей
от 1 до 2048 символов
URL ссылки
@username упомянутого пользователя
null, если сообщение содержит только пересланное сообщение
attachment, описанных в схеме ниже
Если поле пустое или равно null, изменений не произойдёт. Если массив пуст, все вложения будут удалены
expires — если он истёк, ссылку необходимо запросить повторно. Доступно в веб-клиентe и на Android
URL вложения, который возвращается в объекте Update после отправки сообщения в чат или канал
В случае с вложенным видео прямую ссылку также можно получить с помощью метода GET /videos/{-videoToken-}
token, если вы пытаетесь повторно использовать одно и то же вложение в другом сообщении
Результат загрузки аудиосообщения или аудиофайла
Если пользователь отправил боту аудиосообщение, то ответах на запросы получения информации о сообщениях вернётся тип audio
URL вложения, который возвращается в объекте Update после отправки сообщения в чат или канал
В случае с вложенным видео прямую ссылку также можно получить с помощью метода GET /videos/{-videoToken-}
token, если вы пытаетесь повторно использовать одно и то же вложение в другом сообщении
URL вложения, который возвращается в объекте Update после отправки сообщения в чат или канал
В случае с вложенным видео прямую ссылку также можно получить с помощью метода GET /videos/{-videoToken-}
token, если вы пытаетесь повторно использовать одно и то же вложение в другом сообщении
URL вложения, который возвращается в объекте Update после отправки сообщения в чат или канал
В случае с вложенным видео прямую ссылку также можно получить с помощью метода GET /videos/{-videoToken-}
true, если это бот
от 1 до 128 символов
Видимый текст кнопки. Чтобы он отображался полностью, рекомендуем не превышать заданное количество символов в зависимости от размещения текста: 20 символов — при одной кнопке в ряду, 10 — при двух, 5 — при трёх, 3 — при четырёх
до 1024 символов
Токен кнопки
2048 символов
true, отправляет местоположение без запроса подтверждения пользователя
Если false, возвращает модальное окно с дополнительным уточнением об отправке местоположения
до 1024 символов
Текст, который будет скопирован
от 1 символа
URL, прикреплённый к сообщению для предпросмотра медиавложения
Тип элемента разметки. Может быть жирный, курсив, ~зачеркнутый~, подчеркнутый, моноширинный, выделенный, цитата, заголовок, ссылка или упоминание пользователя
Обратите внимание: в тексте комментариев не поддерживаются гиперссылки и упоминания пользователей
от 1 до 2048 символов
URL ссылки
@username упомянутого пользователя
Отправитель сообщения: пользователь или бот
Обратите внимание:
- Все параметры в объекте относятся к отправителю сообщения
- Объект отсутствует, если сообщение отправлено в канал
true, если это бот
Получатель сообщения: пользователь или бот (для диалога), канал или чат
Обратите внимание: все параметры в объекте относятся к получателю сообщения
Возможные значения в enum: "chat" "channel" "dialog"
Тип чата:
chat— групповой чатchannel— канал или комментарий к посту (для вызовов методов группы/comments)dialog— диалог
Возможные значения в enum: "forward" "reply"
Тип связанного сообщения:
"reply"— ответ на сообщение в чате"forward"— пересланное сообщение в чате
true, если это бот
type = forward. Как получить ID — на странице «Получение ID чата или канала»
attachment, описанных в схеме ниже
Если поле пустое или равно null, изменений не произойдёт. Если массив пуст, все вложения будут удалены
expires — если он истёк, ссылку необходимо запросить повторно. Доступно в веб-клиентe и на Android
URL вложения, который возвращается в объекте Update после отправки сообщения в чат или канал
В случае с вложенным видео прямую ссылку также можно получить с помощью метода GET /videos/{-videoToken-}
token, если вы пытаетесь повторно использовать одно и то же вложение в другом сообщении
Результат загрузки аудиосообщения или аудиофайла
Если пользователь отправил боту аудиосообщение, то ответах на запросы получения информации о сообщениях вернётся тип audio
URL вложения, который возвращается в объекте Update после отправки сообщения в чат или канал
В случае с вложенным видео прямую ссылку также можно получить с помощью метода GET /videos/{-videoToken-}
token, если вы пытаетесь повторно использовать одно и то же вложение в другом сообщении
URL вложения, который возвращается в объекте Update после отправки сообщения в чат или канал
В случае с вложенным видео прямую ссылку также можно получить с помощью метода GET /videos/{-videoToken-}
token, если вы пытаетесь повторно использовать одно и то же вложение в другом сообщении
URL вложения, который возвращается в объекте Update после отправки сообщения в чат или канал
В случае с вложенным видео прямую ссылку также можно получить с помощью метода GET /videos/{-videoToken-}
true, если это бот
от 1 до 128 символов
Видимый текст кнопки. Чтобы он отображался полностью, рекомендуем не превышать заданное количество символов в зависимости от размещения текста: 20 символов — при одной кнопке в ряду, 10 — при двух, 5 — при трёх, 3 — при четырёх
до 1024 символов
Токен кнопки
2048 символов
true, отправляет местоположение без запроса подтверждения пользователя
Если false, возвращает модальное окно с дополнительным уточнением об отправке местоположения
до 1024 символов
Текст, который будет скопирован
от 1 символа
URL, прикреплённый к сообщению для предпросмотра медиавложения
Тип элемента разметки. Может быть жирный, курсив, ~зачеркнутый~, подчеркнутый, моноширинный, выделенный, цитата, заголовок, ссылка или упоминание пользователя
Обратите внимание: в тексте комментариев не поддерживаются гиперссылки и упоминания пользователей
от 1 до 2048 символов
URL ссылки
@username упомянутого пользователя
null, если сообщение содержит только пересланное сообщение
attachment, описанных в схеме ниже
Если поле пустое или равно null, изменений не произойдёт. Если массив пуст, все вложения будут удалены
expires — если он истёк, ссылку необходимо запросить повторно. Доступно в веб-клиентe и на Android
URL вложения, который возвращается в объекте Update после отправки сообщения в чат или канал
В случае с вложенным видео прямую ссылку также можно получить с помощью метода GET /videos/{-videoToken-}
token, если вы пытаетесь повторно использовать одно и то же вложение в другом сообщении
Результат загрузки аудиосообщения или аудиофайла
Если пользователь отправил боту аудиосообщение, то ответах на запросы получения информации о сообщениях вернётся тип audio
URL вложения, который возвращается в объекте Update после отправки сообщения в чат или канал
В случае с вложенным видео прямую ссылку также можно получить с помощью метода GET /videos/{-videoToken-}
token, если вы пытаетесь повторно использовать одно и то же вложение в другом сообщении
URL вложения, который возвращается в объекте Update после отправки сообщения в чат или канал
В случае с вложенным видео прямую ссылку также можно получить с помощью метода GET /videos/{-videoToken-}
token, если вы пытаетесь повторно использовать одно и то же вложение в другом сообщении
URL вложения, который возвращается в объекте Update после отправки сообщения в чат или канал
В случае с вложенным видео прямую ссылку также можно получить с помощью метода GET /videos/{-videoToken-}
true, если это бот
от 1 до 128 символов
Видимый текст кнопки. Чтобы он отображался полностью, рекомендуем не превышать заданное количество символов в зависимости от размещения текста: 20 символов — при одной кнопке в ряду, 10 — при двух, 5 — при трёх, 3 — при четырёх
до 1024 символов
Токен кнопки
2048 символов
true, отправляет местоположение без запроса подтверждения пользователя
Если false, возвращает модальное окно с дополнительным уточнением об отправке местоположения
до 1024 символов
Текст, который будет скопирован
от 1 символа
URL, прикреплённый к сообщению для предпросмотра медиавложения
Тип элемента разметки. Может быть жирный, курсив, ~зачеркнутый~, подчеркнутый, моноширинный, выделенный, цитата, заголовок, ссылка или упоминание пользователя
Обратите внимание: в тексте комментариев не поддерживаются гиперссылки и упоминания пользователей
от 1 до 2048 символов
URL ссылки
@username упомянутого пользователя
true, если это бот
null, если пользователь присоединился к чату по ссылке
true, если это бот
null, если пользователь покинул чат сам
Перечень обновлённых прав доступа бота — администратора группового чата или канала. Ниже приведено краткое описание всех прав — подробнее читайте в разделе «Доступные права администратора»
Краткое описание доступных прав бота-администратора:
read_all_messages— читать все сообщения в канале или групповом чатеedit— редактировать посты и комментарии в каналах (для групповых чатов недоступно). Ранее вместоeditв API использовалосьedit_message— в ответе могут возвращаться оба значенияdelete— удалять посты и комментарии в каналах (для групповых чатов недоступно). Ранее вместоdeleteв API использовалосьdelete_message— в ответе могут возвращаться оба значенияwrite— редактировать и удалять сообщения в групповых чатах, а также писать посты и комментарии в каналах. Ранее вместоwriteв API использовалосьpost_edit_delete_message— в ответе могут возвращаться оба значенияpin_message— закреплять сообщениеchange_chat_info— изменять информацию о канале или групповом чатеadd_remove_members— добавлять и удалять участников группового чата. Добавление подписчиков в канал ботам недоступноadd_admins— добавлять и удалять администраторов группового чата или каналаedit_link— изменять ссылку на групповой чат (для каналов недоступно)can_call— звонить в групповом чате (для каналов недоступно)
Пример объекта
{
"update_type": "bot_added",
"timestamp": 0,
"chat_id": 0,
"is_channel": true
}
{
"update_type": "bot_started",
"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"
},
"payload": "string",
"user_locale": "string"
}
{
"update_type": "bot_stopped",
"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"
},
"user_locale": "string"
}
{
"update_type": "bot_removed",
"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
}
{
"update_type": "chat_title_changed",
"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"
},
"title": "string"
}
{
"update_type": "dialog_cleared",
"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"
},
"user_locale": "string"
}
{
"update_type": "dialog_muted",
"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"
},
"muted_until": 0,
"user_locale": "string"
}
{
"update_type": "dialog_unmuted",
"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"
},
"user_locale": "string"
}
{
"update_type": "dialog_removed",
"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"
},
"user_locale": "string"
}
{
"update_type": "message_callback",
"timestamp": 0,
"callback": {
"timestamp": 0,
"callback_id": "string",
"payload": "string",
"user": {
"user_id": 0,
"first_name": "string",
"last_name": "string",
"username": "string",
"is_bot": true,
"last_activity_time": 0,
"name": "string"
}
},
"message": {
"sender": {
"user_id": 0,
"first_name": "string",
"last_name": "string",
"username": "string",
"is_bot": true,
"last_activity_time": 0,
"name": "string"
},
"recipient": {
"chat_id": 0,
"chat_type": "chat",
"user_id": 0,
"post_id": "string"
},
"timestamp": 0,
"link": {
"type": "forward",
"sender": {
"user_id": 0,
"first_name": "string",
"last_name": "string",
"username": "string",
"is_bot": true,
"last_activity_time": 0,
"name": "string"
},
"chat_id": 0,
"message": {
"mid": "string",
"seq": 0,
"text": "string",
"attachments": [
{
"type": "image",
"payload": {
"photo_id": 0,
"token": "string",
"url": "string"
}
}
],
"markup": [
{
"type": "strong",
"from": 0,
"length": 0
}
]
}
},
"body": {
"mid": "string",
"seq": 0,
"text": "string",
"attachments": [
{
"type": "image",
"payload": {
"photo_id": 0,
"token": "string",
"url": "string"
}
}
],
"markup": [
{
"type": "strong",
"from": 0,
"length": 0
}
]
},
"stat": {
"views": 0
},
"url": "string"
},
"user_locale": "string"
}
{
"update_type": "message_created",
"timestamp": 0,
"message": {
"sender": {
"user_id": 0,
"first_name": "string",
"last_name": "string",
"username": "string",
"is_bot": true,
"last_activity_time": 0,
"name": "string"
},
"recipient": {
"chat_id": 0,
"chat_type": "chat",
"user_id": 0,
"post_id": "string"
},
"timestamp": 0,
"link": {
"type": "forward",
"sender": {
"user_id": 0,
"first_name": "string",
"last_name": "string",
"username": "string",
"is_bot": true,
"last_activity_time": 0,
"name": "string"
},
"chat_id": 0,
"message": {
"mid": "string",
"seq": 0,
"text": "string",
"attachments": [
{
"type": "image",
"payload": {
"photo_id": 0,
"token": "string",
"url": "string"
}
}
],
"markup": [
{
"type": "strong",
"from": 0,
"length": 0
}
]
}
},
"body": {
"mid": "string",
"seq": 0,
"text": "string",
"attachments": [
{
"type": "image",
"payload": {
"photo_id": 0,
"token": "string",
"url": "string"
}
}
],
"markup": [
{
"type": "strong",
"from": 0,
"length": 0
}
]
},
"stat": {
"views": 0
},
"url": "string"
},
"user_locale": "string"
}
{
"update_type": "message_edited",
"timestamp": 0,
"message": {
"sender": {
"user_id": 0,
"first_name": "string",
"last_name": "string",
"username": "string",
"is_bot": true,
"last_activity_time": 0,
"name": "string"
},
"recipient": {
"chat_id": 0,
"chat_type": "chat",
"user_id": 0,
"post_id": "string"
},
"timestamp": 0,
"link": {
"type": "forward",
"sender": {
"user_id": 0,
"first_name": "string",
"last_name": "string",
"username": "string",
"is_bot": true,
"last_activity_time": 0,
"name": "string"
},
"chat_id": 0,
"message": {
"mid": "string",
"seq": 0,
"text": "string",
"attachments": [
{
"type": "image",
"payload": {
"photo_id": 0,
"token": "string",
"url": "string"
}
}
],
"markup": [
{
"type": "strong",
"from": 0,
"length": 0
}
]
}
},
"body": {
"mid": "string",
"seq": 0,
"text": "string",
"attachments": [
{
"type": "image",
"payload": {
"photo_id": 0,
"token": "string",
"url": "string"
}
}
],
"markup": [
{
"type": "strong",
"from": 0,
"length": 0
}
]
},
"stat": {
"views": 0
},
"url": "string"
}
}
{
"update_type": "message_removed",
"timestamp": 0,
"message_id": "string",
"chat_id": 0,
"user_id": 0,
"post_id": "string"
}
{
"update_type": "comment_created",
"timestamp": 0,
"message": {
"sender": {
"user_id": 0,
"first_name": "string",
"last_name": "string",
"username": "string",
"is_bot": true,
"last_activity_time": 0,
"name": "string"
},
"recipient": {
"chat_id": 0,
"chat_type": "chat",
"user_id": 0,
"post_id": "string"
},
"timestamp": 0,
"link": {
"type": "forward",
"sender": {
"user_id": 0,
"first_name": "string",
"last_name": "string",
"username": "string",
"is_bot": true,
"last_activity_time": 0,
"name": "string"
},
"chat_id": 0,
"message": {
"mid": "string",
"seq": 0,
"text": "string",
"attachments": [
{
"type": "image",
"payload": {
"photo_id": 0,
"token": "string",
"url": "string"
}
}
],
"markup": [
{
"type": "strong",
"from": 0,
"length": 0
}
]
}
},
"body": {
"mid": "string",
"seq": 0,
"text": "string",
"attachments": [
{
"type": "image",
"payload": {
"photo_id": 0,
"token": "string",
"url": "string"
}
}
],
"markup": [
{
"type": "strong",
"from": 0,
"length": 0
}
]
},
"stat": {
"views": 0
},
"url": "string"
}
}
{
"update_type": "comment_edited",
"timestamp": 0,
"message": {
"sender": {
"user_id": 0,
"first_name": "string",
"last_name": "string",
"username": "string",
"is_bot": true,
"last_activity_time": 0,
"name": "string"
},
"recipient": {
"chat_id": 0,
"chat_type": "chat",
"user_id": 0,
"post_id": "string"
},
"timestamp": 0,
"link": {
"type": "forward",
"sender": {
"user_id": 0,
"first_name": "string",
"last_name": "string",
"username": "string",
"is_bot": true,
"last_activity_time": 0,
"name": "string"
},
"chat_id": 0,
"message": {
"mid": "string",
"seq": 0,
"text": "string",
"attachments": [
{
"type": "image",
"payload": {
"photo_id": 0,
"token": "string",
"url": "string"
}
}
],
"markup": [
{
"type": "strong",
"from": 0,
"length": 0
}
]
}
},
"body": {
"mid": "string",
"seq": 0,
"text": "string",
"attachments": [
{
"type": "image",
"payload": {
"photo_id": 0,
"token": "string",
"url": "string"
}
}
],
"markup": [
{
"type": "strong",
"from": 0,
"length": 0
}
]
},
"stat": {
"views": 0
},
"url": "string"
}
}
{
"update_type": "comment_removed",
"timestamp": 0,
"message_id": "string",
"chat_id": 0,
"user_id": 0,
"post_id": "string"
}
{
"update_type": "user_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"
},
"inviter_id": 0,
"is_channel": true
}
{
"update_type": "user_removed",
"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"
},
"admin_id": 0,
"is_channel": true
}
{
"update_type": "bot_admin_permissions_changed",
"timestamp": 0,
"chat_id": 0,
"user_id": 0,
"bot_id": 0,
"is_channel": true,
"is_admin": true,
"permissions": [
"read_all_messages"
]
}