Получение обновлений о событиях через Long Polling
Для корректной работы ваших чат-ботов и мини-приложений направляйте запросы на доменplatform-api2.max.ruвместоplatform-api.max.ru. Также убедитесь, что добавили сертификат Минцифры в список доверенных
GET/updates
Получение обновлений с помощью Long Polling ограничено по скорости и сроку хранения событий — этот способ не подходит для production-окружения. Рекомендуем на всех этапах работы использовать Webhook
Метод GET /updates можно использовать для получения обновлений при разработке и тестировании, если ваш бот не подписан на Webhook. Для production-окружения используйте только Webhook
Каждое обновление со списком событий имеет свой порядковый номер. Свойство marker в ответе указывает на следующее ожидаемое обновление. После того, как вы передали marker с указателем на конкретное обновление, все предыдущие считаются прочитанными
Если параметр marker не передан или передано значение null, вы получите только последнее обновление
Пример запроса:
curl -X GET "https://platform-api2.max.ru/updates" \
-H "Authorization: {access_token}"Авторизация
Передача токена через query-параметры больше не поддерживается — используйте заголовок
Authorization: <token>
Токен для вызова HTTP-запросов присваивается при создании бота — его можно найти на платформе в разделе Чат-боты. Выберите необходимого бота и нажмите ⋮ → Настройки → значок копирования справа от поля с токеном
Если вы верифицировали профиль и создали бота в мини-приложении «MAX для бизнеса», получить токен можно там же или в боте «MAX для бизнеса» с помощью команды Получить токен
Рекомендуем не разглашать токен посторонним, чтобы они не получили доступ к управлению ботом. Токен может быть отозван за нарушение Правил платформы
Параметры
По умолчанию: 100
Максимальное количество обновлений о событиях, которое может вернуться в ответе на запрос
По умолчанию: 30
Тайм-аут в секундах для долгого опроса
null или оставьте поле пустым. Чтобы получить все обновления по событиям с момента предыдущего запроса, передайте значение marker, которое получили в ответ на предыдущий запрос
Update
HTTP-коды ответов
| Код | Описание |
|---|---|
200 | Список обновлений событий с указателем на следующую страницу данных |
401 | Ошибка авторизации. Токен access_token указан некорректно или недействителен |
405 | Метод не разрешен |
500 | Внутренняя ошибка сервера |
Подробнее о форматах ответа и кодах ошибок — на странице «Общее описание»
Результат
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— звонить в групповом чате (для каналов недоступно)