метод REST scope: vote

vote.Integration.Im.send

Создать и отправить голосование в чат

Кто может выполнять: любой пользователь

Описание

Метод vote.Integration.Im.send создает и отправляет голосование в указанный чат мессенджера.

Параметры

chatId integer обязательный

Идентификатор чата, в который отправляется голосование. Получить можно методами im.chat.add, im.chat.get, im.recent.get, im.recent.list

IM_MESSAGE_VOTE_DATA object обязательный

Данные голосования с вопросом и вариантами ответов. Структура описана ниже

templateId string необязательный

Уникальный идентификатор запроса, требований к формату нет.
Цель идентификатора — защита от дублирования. Если из-за сбоя сети запрос отправится повторно с тем же templateId, сервер поймет это и создаст опрос только один раз

Параметр IM_MESSAGE_VOTE_DATA

QUESTIONS array обязательный

Массив вопросов голосования, структура описана ниже. Максимум 1 вопрос

ANONYMITY integer необязательный

Анонимность голосования. Возможные значения:
- 0 — неанонимное голосование,
- 1 — анонимное голосование.

Значение по умолчанию: 0, публичное голосование

OPTIONS integer необязательный

Разрешить переголосование. Возможные значения:
- 0 — нет,
- 1 — да.

Значение по умолчанию: 0, переголосование запрещено

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"chatId":**put_chat_id**,"IM_MESSAGE_VOTE_DATA":{"QUESTIONS":[{"QUESTION":"**put_question_title**","FIELD_TYPE":0,"ANSWERS":[{"MESSAGE":"**put_message_content**"},{"MESSAGE":"**put_message_content**"},{"MESSAGE":"**put_message_content**"}]}],"ANONYMITY":0,"OPTIONS":0},"templateId":null}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/vote.Integration.Im.send

Ответ

HTTP-статус: 200

{
    "result": {
        "messageId": 23,
        "voteId": 7
    },
    "time": {
        "start": 1754470016.954889,
        "finish": 1754470017.043656,
        "duration": 0.08876705169677734,
        "processing": 0.07431983947753906,
        "date_start": "2025-08-06T11:46:56+03:00",
        "date_finish": "2025-08-06T11:46:57+03:00",
        "operating_reset_at": 1754470616,
        "operating": 0.3257129192352295
    }
}

Возвращаемые данные

result object

Корневой элемент ответа. Содержит информацию о номере сообщения и голосования, стурктура описана ниже

time time

Информация о времени выполнения запроса

Обработка ошибок

HTTP-статус: 400

{
    "error": "400",
    "error_description": "Access denied"
}
Код Описание Значение
403 Создание опроса недоступно
400 Введите вопрос и варианты ответов
400 Максимальное количество вопросов: 1
400 Минимальное количество ответов: 2
400 Максимальное количество ответов: 10
400 Не удалось сохранить данные опроса. Попробуйте ещё раз
403 Недостаточно прав для создания опроса

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.