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

imbot.chat.updateColor

Изменить цвет чата

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

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

Описание

Метод imbot.chat.updateColor обновляет цвет чата для мобильного приложения.

Параметры

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

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

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

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

Цвет чата для мобильного приложения. Возможные значения:
- RED — красный
- GREEN — зеленый
- MINT — мятный
- LIGHT_BLUE — светло-синий
- DARK_BLUE — темно-синий
- PURPLE — фиолетовый
- AQUA — аквамариновый
- PINK — розовый
- LIME — лаймовый
- BROWN — коричневый
- AZURE — лазурный
- KHAKI — хаки
- SAND — песочный
- MARENGO — маренго
- GRAY — серый
- GRAPHITE — графитовый

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

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

Если параметр не передан, метод ищет первого бота, который зарегистрирован текущим приложением

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

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

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

curl -X POST /
-H "Content-Type: application/json" /
-H "Accept: application/json" /
-d '{"CHAT_ID":2725,"COLOR":"PINK","CLIENT_ID":"**put_your_client_id_here**"}' /
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/imbot.chat.updateColor

Ответ

HTTP-статус: 200

{
    "result": true,
    "time": {
        "start": 1771935255,
        "finish": 1771935255.192065,
        "duration": 0.19206500053405762,
        "processing": 0,
        "date_start": "2026-02-24T15:14:15+03:00",
        "date_finish": "2026-02-24T15:14:15+03:00",
        "operating_reset_at": 1771935855,
        "operating": 0
    }
}

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

result boolean

true, если цвет чата обновлен

time time

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

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

HTTP-статус: 400

{
    "error": "WRONG_COLOR",
    "error_description": "This color currently unavailable"
}
Код Описание Значение
CHAT_ID_EMPTY Chat ID can't be empty Не передан CHAT_ID
ACCESS_ERROR Action unavailable Операция недоступна для этого чата
WRONG_COLOR This color currently unavailable Передан недопустимый цвет
WRONG_REQUEST This color currently set or chat isn't exists Цвет уже установлен или чат не существует
BOT_ID_ERROR Bot not found Чат-бот не найден
APP_ID_ERROR Bot was installed by another rest application Чат-бот установлен другим приложением

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

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