метод REST scope: im

im.chat.updateAvatar

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

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

Описание

Метод im.chat.updateAvatar обновляет аватар чата.

Параметры

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

Идентификатор чата. Передайте число без префикса chat. Обязателен, если не передан DIALOG_ID.

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

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

Идентификатор диалога в формате chatXXX, где XXX — идентификатор чата. Можно передать вместо CHAT_ID.

Метод работает только с групповыми чатами: для личного диалога он вернет ошибку DIALOG_ID_EMPTY

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

Изображение в формате Base64.

Максимальный размер изображения — 5000х5000

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"CHAT_ID":2935,"AVATAR":"/9j/4QAYRXhpZgAAS...CgCgCgCgP/9k="}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/im.chat.updateAvatar

Ответ

HTTP-статус: 200

{
    "result": true,
    "time": {
        "start": 1772459338,
        "finish": 1772459339.565761,
        "duration": 1.5657610893249512,
        "processing": 1,
        "date_start": "2026-03-02T13:48:58+03:00",
        "date_finish": "2026-03-02T13:48:59+03:00",
        "operating_reset_at": 1772459938,
        "operating": 0.7875189781188965
    }
}

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

result boolean

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

time time

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

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

HTTP-статус: 400

{
    "error": "AVATAR_ERROR",
    "error_description": "Avatar incorrect type"
}
Код Описание Значение
CHAT_ID_EMPTY Chat ID can't be empty Не передан CHAT_ID или значение содержит префикс chat
DIALOG_ID_EMPTY Dialog ID can't be empty В DIALOG_ID передан личный диалог или неверный формат
ACCESS_DENIED Access denied Недостаточно прав для изменения аватара
ACCESS_ERROR Action unavailable Операция недоступна для этого чата
ACCESS_ERROR The avatar of this chat cannot be changed Нельзя изменить аватар этого чата
AVATAR_ERROR Avatar incorrect type Передан файл не с типом изображения
AVATAR_ERROR Avatar incorrect size (max 5000x5000) Размер изображения превышает ограничение
WRONG_REQUEST Chat isn't exists Указанный чат не существует

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

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