метод REST scope: im

im.chat.setOwner

Сменить владельца чата

Кто может выполнять: владелец чата

Описание

Метод im.chat.setOwner меняет владельца чата.

Параметры

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

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

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

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

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

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

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

Идентификатор нового владельца чата.

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

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"CHAT_ID":2935,"USER_ID":1271}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/im.chat.setOwner

Ответ

HTTP-статус: 200

{
    "result": true,
    "time": {
        "start": 1772480720,
        "finish": 1772480720.22065,
        "duration": 0.22064995765686035,
        "processing": 0,
        "date_start": "2026-03-02T16:45:20+03:00",
        "date_finish": "2026-03-02T16:45:20+03:00",
        "operating_reset_at": 1772481320,
        "operating": 0
    }
}

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

result boolean

true, если владелец чата успешно изменен

time time

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

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

HTTP-статус: 400

{
    "error": "CHAT_ID_EMPTY",
    "error_description": "Chat ID can't be empty"
}
Код Описание Значение
CHAT_ID_EMPTY Chat ID can't be empty Не передан CHAT_ID или значение содержит префикс chat
DIALOG_ID_EMPTY Dialog ID can't be empty В DIALOG_ID передан личный диалог или неверный формат
USER_ID_EMPTY User ID can't be empty Не передан USER_ID
ACCESS_ERROR Action unavailable Операция недоступна для этого чата
WRONG_REQUEST Change owner can only owner and user must be member in chat Сменить владельца может только текущий владелец, новый владелец должен быть участником чата

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

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