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

imbot.command.update

Обновить команду

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

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

Описание

Метод imbot.command.update обновляет параметры зарегистрированной команды чат-бота.

Параметры

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

Идентификатор команды для обновления

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

Объект с полями для обновления. Структура описана ниже

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

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

Параметр FIELDS

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

Текст команды

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

URL обработчика события ONIMCOMMANDADD

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

Видимость команды:
- Y - скрытая
- N - видимая

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

Доступность для пользователей экстранета:
- Y - доступна
- N - недоступна

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

Массив локализаций команды. Структура описана ниже

Параметр FIELDS.LANG

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

Идентификатор языка, например ru или en

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

Название команды на выбранном языке

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

Подсказка по параметрам команды на выбранном языке

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

curl -X POST /
-H "Content-Type: application/json" /
-H "Accept: application/json" /
-d '{"COMMAND_ID":99,"FIELDS":{"COMMAND":"echo2","EVENT_COMMAND_ADD":"https://example.com/bot/command.php","HIDDEN":"N","EXTRANET_SUPPORT":"Y","LANG":[{"LANGUAGE_ID":"ru","TITLE":"Эхо 2","PARAMS":"текст"},{"LANGUAGE_ID":"en","TITLE":"Echo 2","PARAMS":"text"}]},"CLIENT_ID":"**put_your_client_id_here**"}' /
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/imbot.command.update

Ответ

HTTP-статус: 200

{
    "result": true,
    "time": {
        "start": 1772103002,
        "finish": 1772103003.109342,
        "duration": 1.109342098236084,
        "processing": 0,
        "date_start": "2026-02-26T13:50:02+03:00",
        "date_finish": "2026-02-26T13:50:03+03:00",
        "operating_reset_at": 1772103603,
        "operating": 0
    }
}

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

result boolean

true, если команда успешно обновлена

time time

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

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

HTTP-статус: 400

{
    "error": "WRONG_REQUEST",
    "error_description": "Update fields can't be empty"
}
Код Описание Значение
COMMAND_ID_ERROR Command not found Команда не найдена
APP_ID_ERROR Command was installed by another rest application Команда зарегистрирована другим приложением
EVENT_COMMAND_ADD_ERROR Wrong handler URL Невалидный URL обработчика события команды
WRONG_REQUEST Update fields can't be empty Не переданы поля для обновления
WRONG_REQUEST Command can't be updated Не удалось обновить команду

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

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