---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.4
alternate:
  - https://yandex.ru/dev/messenger/doc/ru/api-requests/message-send-gallery.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/messenger/doc/ru/llms.txt

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

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

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` | Содержимое файлов с изображениями | — |
| `text`   | Нет  | `string` | Текст сообщения | Не более 6 000 символов |
| `thread_id`   | Нет  | `integer` | Идентификатор треда (timestamp сообщения) | — |
| `message_id`       | Нет  | `integer` | ID сообщения для редактирования | Сообщение должно быть из того же чата |
| `reply_message_id` | Нет  | `integer` | ID сообщения, на которое будет ответ | Сообщение должно быть из того же чата |
| `reply_quote`      | Нет  | `string`  | Фрагмент сообщения, на который будет ответ | Требует `reply_message_id`. Текст должен быть подстрокой исходного сообщения |
| `forwards`         | Нет  | ##[Forward](../data-types.md#forward)##`[]` | Сообщения, которые нужно переслать в целевой чат | Нельзя передавать одновременно с `reply_message_id` |
| `disable_notification` | Нет  | `boolean` | Нужно ли отключить уведомление | Значение по умолчанию: `false` |
| `important`            | Нет  | `boolean` | Является ли сообщение важным | Значение по умолчанию: `false` |
| `suggest_buttons`          | Нет          | ##[SuggestButtons](../data-types.md#suggestbuttons)## |Клавиатура с кнопками под сообщением         | Не более 100 кнопок                                                                                            |
| `action_buttons`           | Нет          | ##[ActionButtons](../data-types.md#actionbuttons)## | Кнопки действий под сообщением | Не более 6 кнопок |

(*) Параметры `chat_id` и `login` являются необязательными, но необходимо заполнить хотя бы один из двух:
- При заполнении `chat_id` альбом будет отправлено в групповой чат, заданный этим ID.
- При заполнении `login` альбом будет отправлено пользователю в приватный чат.

Отправка альбома аналогична [отправке изображения](https://yandex.ru/dev/messenger/doc/ru/api-requests/message-send-image.md).

## Результат
Результатом успешного запроса является ответ с кодом 200 и телом с JSON, где содержится информация об отправленном альбоме.

| Имя параметра | Обязательный | Тип | Описание |
| ------------- | ------------ | --- | ---------|
| `ok`          | Да | `boolean` | Флаг успешности выполнения |
| `message_id`  | Да | `integer` | ID сообщения в чате |
| `images`      | Да | `object[]` | Массив с информацией об отправленных изображениях |

Каждый элемент массива `images` содержит следующие поля:

| Имя параметра | Обязательный | Тип | Описание |
| ------------- | ------------ | --- | ---------|
| `file_id`     | Да | `string`  | Идентификатор загруженного файла |
| `width`       | Да | `integer` | Ширина изображения в пикселях |
| `height`      | Да | `integer` | Высота изображения в пикселях |

В случае ошибки возвращается соответствующий статус HTTP. Описание ошибки приходит в поле `description`.

| Имя параметра | Обязательный | Тип | Описание |
| ------------- | ------------ | --- | ---------|
| `ok`          | Да | `boolean` | Флаг успешности выполнения |
| `description` | Да | `string` | Описание ошибки |

## Пример запроса
```
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, "images": [{"file_id": "<file_id_1>", "width": 1920, "height": 1080}, {"file_id": "<file_id_2>", "width": 1280, "height": 720}]}
```

## Пример ответа с ошибкой
```
{"ok": false, "description": "Bot is not a member of the chat"}
```