метод REST scope: imbot Устаревший

imbot.command.answer

Отправить ответ на команду

Устаревший метод. Развитие метода остановлено. Используйте imbot.v2.Command.answer.

Кто может выполнять: пользователь приложения, которое зарегистрировало чат-бота

Описание

Метод imbot.command.answer публикует ответ на команду чат-бота.

Параметры

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

Идентификатор команды. Обязателен, если не передан COMMAND

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

Текст команды. Обязателен, если не передан COMMAND_ID

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

Идентификатор сообщения, на которое отправляется ответ.

Идентификатор можно узнать из входящего события ONIMCOMMANDADD

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

Текст ответа

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

Объект с вложением к сообщению. Минимальный формат:

{
  "BLOCKS": [
    { "MESSAGE": "Текст блока" }
  ]
}

Подробное описание

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

Клавиатура сообщения. Минимальный формат:

{
  "BUTTONS": [
    { "TEXT": "Повторить", "COMMAND": "echo repeat" }
  ]
}

Подробное описание

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

Контекстное меню сообщения. Минимальный формат:

[
  { "TEXT": "bitrix24", "LINK": "https://bitrix24.ru" }
]

Подробное описание

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

Тип сообщения:
- Y - системное сообщение
- N - обычное сообщение

По умолчанию - N

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

Преобразование ссылок в rich-ссылки:
- Y - включено
- N - выключено

По умолчанию - Y.

Работает для ссылок, переданных в поле MESSAGE

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

Параметр обязателен только для вебхуков. Передавайте тот же CLIENT_ID, который был указан при регистрации чат-бота

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

curl -X POST /
-H "Content-Type: application/json" /
-H "Accept: application/json" /
-d '{"COMMAND_ID":99,"MESSAGE_ID":33871,"MESSAGE":"Принято. Выполняю команду.","SYSTEM":"N","URL_PREVIEW":"Y","ATTACH":{"BLOCKS":[{"MESSAGE":"Детали задачи"},{"DELIMITER":true},{"LINK":{"NAME":"Открыть","LINK":"https://example.com"}}]},"KEYBOARD":{"BUTTONS":[{"TEXT":"Повторить","COMMAND":"echo repeat"}]},"MENU":[{"TEXT":"bitrix24","LINK":"https://bitrix24.ru"}],"CLIENT_ID":"**put_your_client_id_here**"}' /
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/imbot.command.answer

Ответ

HTTP-статус: 200

{
    "result": 33879,
    "time": {
        "start": 1772102358,
        "finish": 1772102359.061859,
        "duration": 1.061858892440796,
        "processing": 1,
        "date_start": "2026-02-26T13:39:18+03:00",
        "date_finish": "2026-02-26T13:39:19+03:00",
        "operating_reset_at": 1772102958,
        "operating": 0
    }
}

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

result integer

Идентификатор отправленного сообщения-ответа

time time

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

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

HTTP-статус: 400

{
    "error": "MESSAGE_EMPTY",
    "error_description": "Message can't be empty"
}
Код Описание Значение
COMMAND_ID_ERROR Command not found Команда не найдена
APP_ID_ERROR Command was installed by another rest application Команда зарегистрирована другим приложением
MESSAGE_ID_EMPTY Message ID can't be empty Не передан MESSAGE_ID
MESSAGE_EMPTY Message can't be empty Не передан текст сообщения
ATTACH_ERROR Incorrect attach params Невалидный объект ATTACH
ATTACH_OVERSIZE You have exceeded the maximum allowable size of attach Размер ATTACH превышает допустимый
KEYBOARD_ERROR Incorrect keyboard params Невалидный объект KEYBOARD
KEYBOARD_OVERSIZE You have exceeded the maximum allowable size of keyboard Размер KEYBOARD превышает допустимый
MENU_ERROR Incorrect menu params Невалидный объект MENU
WRONG_REQUEST Message isn't added Не удалось отправить сообщение

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

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