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

# Создание опроса

Метод позволяет создавать опросы.

HTTP метод: `POST`

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

## Заголовки
```
Authorization: OAuth <токен>
Content-Type: application/json
```

## Тело запроса (JSON)
| Имя параметра              | Обязательный | Тип               | Описание                                  | Ограничения, значение по умолчанию                                                              |
|----------------------------|--------------|-------------------|-------------------------------------------|-------------------------------------------------------------------------------------------------|
| `chat_id`                  | Нет*         | `string`          | ID группового чата                        | Бот должен быть участником чата                                                                 |
| `login`                    | Нет*         | `string`          | Логин пользователя                        | —                                                                                               |
| `title`                    | Да           | `string`          | Заголовок опроса                          | —                                                                                               |
| `answers`                  | Да           | `array of string` | Варианты ответа для опроса                | В списке должно быть не менее двух и не более ста элементов                                     |
| `max_choices`              | Нет          | `integer`         | Максимальное количество возможных ответов | Положительное число. Значение по умолчанию: `1`                                                 |
| `is_anonymous`             | Нет          | `boolean`         | Является ли опрос анонимным               | Значение по умолчанию: `false`                                                                  |
| `payload_id`               | Нет          | `string`          | ID запроса                                | ID должен быть уникальным для каждого запроса. Запросы с одинаковым ID трактуются как дубликаты |
| `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`                                                                  |
| `disable_web_page_preview` | Нет          | `boolean`         | Отключить раскрытие ссылок в сообщении    | Значение по умолчанию: `false`                                                                  |
| `thread_id`                | Нет          | `integer`         | Идентификатор треда (timestamp сообщения) | —                                                                                               |
| `suggest_buttons`          | Нет          | ##[SuggestButtons](../data-types.md#suggestbuttons)## |Клавиатура с кнопками под сообщением         | Не более 100 кнопок                                                                                            |
| `action_buttons`           | Нет          | ##[ActionButtons](../data-types.md#actionbuttons)## | Кнопки действий под сообщением | Не более 6 кнопок |

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

## Ограничения
1. Бот может отправлять сообщения только в те чаты, в которых он является участником или админом.
2. Бот не может отправлять личные сообщения пользователям, для которых это запрещено настройками приватности.
3. Бот не может отправлять личные сообщения пользователям вне своей организации.

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

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

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

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

## Пример запроса
```
curl -X POST -H 'Authorization: OAuth AtXXXXXXXXXXX' -H "Content-Type: application/json" -d '{"chat_id":"0/0/4f24b544-697c-4e18-a9c1-b39432ee9bf9", "title": "Вам нравится этот опрос?", "answers": ["Да!", "Не очень"], "is_anonymous": "true"}' 'https://botapi.messenger.yandex.net/bot/v1/messages/createPoll/'
```

## Пример успешного ответа
```
{"ok": true, "message_id": 1647523230504005}
```

## Пример ответа с ошибкой
```
{"ok": false, "description": "answers: ["Ensure this field has at least 2 elements."]"}
```