метод REST scope: imopenlines

imopenlines.crm.chat.user.add

Добавить пользователя к существующему чату

Кто может выполнять: любой пользователь с доступом к объекту CRM

Описание

Метод imopenlines.crm.chat.user.add добавляет пользователя в чат, привязанный к объекту CRM.

Параметры

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

Тип объекта CRM. Возможные значения:
- lead — лид
- deal — сделка
- company — компания
- contact — контакт

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

Идентификатор объекта CRM.

Получить идентификатор можно универсальным методом получения списка элементов CRM

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

Идентификатор пользователя или бота, которого нужно добавить в чат.

Получить идентификатор пользователя позволяют методы user.get и user.search

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

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

По умолчанию используется последний чат, привязанный к объекту CRM.

Получить идентификаторы чатов, привязанных к объекту CRM, можно методом imopenlines.crm.chat.get

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

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"CRM_ENTITY_TYPE":"lead","CRM_ENTITY":1205,"USER_ID":503,"CHAT_ID":1763}' \
  https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/imopenlines.crm.chat.user.add

Ответ

HTTP-статус: 200

{
    "result": 1763,
    "time": {
        "start": 1773814042,
        "finish": 1773814043.189039,
        "duration": 1.1890389919281006,
        "processing": 0,
        "date_start": "2026-03-18T09:07:22+03:00",
        "date_finish": "2026-03-18T09:07:23+03:00",
        "operating_reset_at": 1773814643,
        "operating": 0.16756796836853027
    }
}

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

HTTP-статус: 400

{
    "error": "CHAT_NOT_IN_CRM",
    "error_description": "Chat does not belong to the CRM entity being checked"
}
Код Описание Значение
403 ACCESS_DENIED Access denied! You don't have access to join user to chat
403 ACCESS_DENIED Access denied! This user does not have access to the chat because he does not have access to this CRM entity
400 ERROR_ARGUMENT Argument 'CRM_ENTITY_TYPE' is null or empty
400 ERROR_ARGUMENT Argument 'CRM_ENTITY' is null or empty
400 ERROR_ARGUMENT The value of an argument 'CRM_ENTITY' has an invalid type
400 ERROR_ARGUMENT Argument 'Empty USER_ID' is null or empty
400 IM_NOT_INSTALLED Messenger is not installed.
400 CHAT_NOT_IN_CRM Chat does not belong to the CRM entity being checked
400 CRM_CHAT_USER_NOT_ACTIVE User not active
403 ACCESS_DENIED Access denied! This user does not have access to the chat because he does not have access to this view chat history
400 WRONG_REQUEST You don't have access or user already member in chat

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

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