метод REST scope: im

im.chat.user.add

Пригласить участников в чат

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

Описание

Метод im.chat.user.add добавляет пользователей в чат.

Параметры

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

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

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

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

Массив идентификаторов пользователей, которых нужно добавить в чат.

Идентификаторы пользователей можно получить с помощью методов user.get и user.search

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

Скрыть историю чата для добавляемых пользователей:
- Y — скрыть
- N — не скрывать

По умолчанию: Y

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"CHAT_ID":2935,"USERS":[99,1271],"HIDE_HISTORY":"N"}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/im.chat.user.add

Ответ

HTTP-статус: 200

{
    "result": true,
    "time": {
        "start": 1772452546,
        "finish": 1772452546.179628,
        "duration": 0.1796278953552246,
        "processing": 0,
        "date_start": "2026-03-02T10:55:46+03:00",
        "date_finish": "2026-03-02T10:55:46+03:00",
        "operating_reset_at": 1772453146,
        "operating": 0.1326589584350586
    }
}

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

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
ACCESS_ERROR Action unavailable Операция недоступна для этого чата
ACCESS_ERROR It is forbidden to add users to this chat Нельзя добавлять пользователей в этот чат
ACCESS_DENIED_EXTEND Недостаточно прав на добавление участников в чат Недостаточно прав для добавления участников в чат

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

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