метод REST scope: imopenlines

imopenlines.session.open

Получить чат по коду пользователя

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

Описание

Метод imopenlines.session.open возвращает идентификатор чата открытой линии по коду пользователя USER_CODE.

Параметры

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

Строковый код пользователя для канала внешней системы.

Формат кода: ``<connector>|<LINE_ID>|<CONNECTOR_CHAT_ID>|<CONNECTOR_USER_ID>`, где:
-
<connector> — идентификатор коннектора: livechat, telegram и другие
-
<LINE_ID> — идентификатор открытой линии
-
<CONNECTOR_CHAT_ID> — идентификатор чата в канале
-
<CONNECTOR_USER_ID> — идентификатор пользователя в канале

Значение можно получить методом imopenlines.dialog.get из поля entity_id или методом imopenlines.session.history.get из result.chat.<chatId>.entityId`

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

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"USER_CODE":"livechat|22|1761|587"}' \
  https://your-domain.bitrix24.ru/rest/1/webhook_key/imopenlines.session.open.json

Ответ

HTTP-статус: 200

{
    "result": {
        "chatId": "1763"
    },
    "time": {
        "start": 1773666416,
        "finish": 1773666416.279787,
        "duration": 0.2797870635986328,
        "processing": 0,
        "date_start": "2026-03-16T16:06:56+03:00",
        "date_finish": "2026-03-16T16:06:56+03:00",
        "operating_reset_at": 1773667016,
        "operating": 0
    }
}

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

result object

Корневой объект ответа (подробное описание)

time time

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

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

HTTP-статус: 400

{
    "error": "ACCESS_DENIED",
    "error_description": "Вы не можете открыть этот разговор, т.к. у вас недостаточно прав"
}
Код Описание Значение
400 ACCESS_DENIED Вы не можете открыть этот разговор, т.к. у вас недостаточно прав

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

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