imbot.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
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"}]},"auth":"**put_access_token_here**"}' /
https://**put_your_bitrix24_address**/rest/imbot.command.update
try
{
const response = await $b24.callMethod(
'imbot.command.update',
{
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' }
]
}
}
);
const result = response.getData().result;
console.log('Updated command with ID:', result);
processResult(result);
}
catch( error )
{
console.error('Error:', error);
}
try {
$response = $b24Service
->core
->call(
'imbot.command.update',
[
'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']
]
]
]
);
$result = $response
->getResponseData()
->getResult();
echo 'Success: ' . print_r($result, true);
processData($result);
} catch (Throwable $e) {
error_log($e->getMessage());
echo 'Error updating command: ' . $e->getMessage();
}
BX24.callMethod(
'imbot.command.update',
{
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' }
]
}
},
function(result)
{
if (result.error())
console.error(result.error());
else
console.dir(result.data());
}
);
require_once('crest.php');
$result = CRest::call(
'imbot.command.update',
[
'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']
]
]
]
);
echo '<PRE>';
print_r($result);
echo '</PRE>';
// client и ctx уже созданы — см. раздел «SDK для Go»
res, err := client.Core().Call(ctx, "imbot.command.update", b24.Params{
"COMMAND_ID": 99,
"FIELDS": b24.Params{
"COMMAND": "echo2",
"EVENT_COMMAND_ADD": "https://example.com/bot/command.php",
"HIDDEN": "N",
"EXTRANET_SUPPORT": "Y",
"LANG": []b24.Params{
{
"LANGUAGE_ID": "ru",
"TITLE": "Эхо 2",
"PARAMS": "текст",
},
{
"LANGUAGE_ID": "en",
"TITLE": "Echo 2",
"PARAMS": "text",
},
},
},
"CLIENT_ID": "**put_your_client_id_here**",
})
if err != nil {
return fmt.Errorf("imbot.command.update: %w", err)
}
var ok bool
if err := json.Unmarshal(res.Result, &ok); err != nil {
return fmt.Errorf("разбор ответа: %w", err)
}
fmt.Println("выполнено:", ok)
Ответ
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 | Не удалось обновить команду |

