метод REST scope: im

im.message.command

Выполнить команду чат-бота

Кто может выполнять: участник чата

Описание

Метод im.message.command выполняет команду чат-бота в контексте сообщения.

Параметры

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

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

Идентификатор можно получить с помощью метода im.dialog.messages.get

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

Идентификатор бота.

Идентификатор можно получить с помощью метода imbot.bot.list.

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

Команда бота.

Текст указывается при регистрации команды чат-ботом через метод imbot.command.register

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

Параметр команды

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"MESSAGE_ID":34261,"BOT_ID":1291,"COMMAND":"task","COMMAND_PARAMS":"task №1"}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/im.message.command

Ответ

HTTP-статус: 200

{
    "result": true,
    "time": {
        "start": 1772633574,
        "finish": 1772633574.201127,
        "duration": 0.2011270523071289,
        "processing": 0,
        "date_start": "2026-03-04T17:12:54+03:00",
        "date_finish": "2026-03-04T17:12:54+03:00",
        "operating_reset_at": 1772634174,
        "operating": 0.10915994644165039
    }
}

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

result boolean

true, если команда выполнена

time time

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

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

HTTP-статус: 400

{
    "error": "PARAMS_ERROR",
    "error_description": "Incorrect params"
}
Код Описание Значение
MESSAGE_ID_ERROR Message ID can't be empty Не передан или некорректен MESSAGE_ID
BOT_ID_ERROR Bot ID can't be empty Не передан или некорректен BOT_ID
COMMAND_ERROR Command can't be empty Не передан COMMAND
PARAMS_ERROR Incorrect params Некорректные параметры команды

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

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