Отправка альбома

Метод позволяет отправлять альбомы в приватные или групповые чаты.

HTTP метод: POST

URL: https://botapi.messenger.yandex.net/bot/v1/messages/sendGallery/

Заголовки

Authorization: OAuth <токен>

Тело запроса (multipart/form-data)

Имя параметра Обязательный Тип Описание Ограничения, значение по умолчанию
chat_id Нет* string ID чата, в который нужно отправить альбом Бот должен состоять в чате
login Нет* string Логин пользователя, которому нужно отправить альбом Бот должен состоять в чате
images Да binary data Содержимое файлов с изображениями
thread_id Нет integer Идентификатор треда (timestamp сообщения)

(*) Параметры chat_id и login являются необязательными, но необходимо заполнить хотя бы один из двух:

  • При заполнении chat_id альбом будет отправлено в групповой чат, заданный этим ID.
  • При заполнении login альбом будет отправлено пользователю в приватный чат.

Отправка альбома аналогична отправке изображения.

Пример запроса

curl -H 'Authorization: OAuth AtXXXXXXXXXXX' -F 'login=vasya@example.org' -F 'images=@cat1.jpg' -F 'images=@cat2.png' 'https://botapi.messenger.yandex.net/bot/v1/messages/sendGallery'

Пример успешного ответа

{"ok": true, "message_id": 1647523230504005}

Пример ответа с ошибкой

{"ok": false, "description": "Bot is not a member of the chat"}