метод REST scope: imopenlines

imopenlines.dialog.get

Получить информацию о диалоге оператора

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

Описание

Метод imopenlines.dialog.get возвращает данные чата открытой линии. Достаточно передать один из параметров.

Параметры

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

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

Идентификатор можно получить методом imopenlines.session.open или imopenlines.session.history.get

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

Идентификатор диалога в формате chat<ID>, где <ID> — идентификатор чата открытой линии

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

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

Идентификатор можно получить методом imopenlines.session.history.get в поле sessionId

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

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

Формат кода: ``<connector>|<LINE_ID>|<CONNECTOR_CHAT_ID>|<CONNECTOR_USER_ID>`, где:
-
<connector> — идентификатор коннектора: livechat, telegram и другие
-
<LINE_ID> — идентификатор открытой линии
-
<CONNECTOR_CHAT_ID> — идентификатор чата в канале
-
<CONNECTOR_USER_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|1|1373|211"}' \
  https://your-domain.bitrix24.ru/rest/1/webhook_key/imopenlines.dialog.get.json

Ответ

HTTP-статус: 200

{
    "result": {
        "id": 1777,
        "parent_chat_id": 0,
        "parent_message_id": 0,
        "name": "Салатовый гость №17 - Документация Битрикс24",
        "description": null,
        "owner": 27,
        "extranet": false,
        "avatar": "",
        "color": "#58cc47",
        "type": "lines",
        "counter": 0,
        "user_counter": 2,
        "message_count": 104,
        "unread_id": 0,
        "restrictions": {
            "avatar": true,
            "rename": true,
            "extend": true,
            "call": true,
            "mute": true,
            "leave": true,
            "leave_owner": true,
            "send": true,
            "user_list": true
        },
        "last_message_id": 86313,
        "last_id": 86313,
        "marked_id": 0,
        "disk_folder_id": 0,
        "entity_type": "LINES",
        "entity_id": "livechat|22|1775|599",
        "entity_data_1": "Y|LEAD|1209|N|N|343|1773682918|0|0|0",
        "entity_data_2": "LEAD|1209|COMPANY|0|CONTACT|0|DEAL|0",
        "entity_data_3": "N",
        "mute_list": [],
        "date_create": "2026-03-13T16:50:15+03:00",
        "message_type": "L",
        "public": "",
        "role": "owner",
        "entity_link": {
            "type": "LINES",
            "url": "",
            "id": "livechat|22|1775|599"
        },
        "text_field_enabled": true,
        "background_id": null,
        "permissions": {
            "manage_users_add": "member",
            "manage_users_delete": "manager",
            "manage_ui": "member",
            "manage_settings": "owner",
            "manage_messages": "member",
            "can_post": "member"
        },
        "is_new": false,
        "readed_list": [
            {
                "user_id": 599,
                "user_name": "Гость",
                "message_id": 86101,
                "date": null
            }
        ],
        "manager_list": [27],
        "last_message_views": {
            "message_id": 86313,
            "first_viewers": [
                {
                    "user_id": 27,
                    "user_name": "Светлана Иванова",
                    "date": "2026-03-16T20:50:37+03:00"
                }
            ],
            "count_of_viewers": 0
        },
        "dialog_id": "chat1777"
    },
    "time": {
        "start": 1773683678,
        "finish": 1773683678.423382,
        "duration": 0.423382043838501,
        "processing": 0,
        "date_start": "2026-03-16T20:54:38+03:00",
        "date_finish": "2026-03-16T20:54:38+03:00",
        "operating_reset_at": 1773684278,
        "operating": 0
    }
}

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

result object

Объект данных чата (подробное описание)

time time

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

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

HTTP-статус: 400

{
    "error": "ACCESS_ERROR",
    "error_description": "You do not have access to the specified dialog"
}
Код Описание Значение
400 IM_NOT_INSTALLED Messenger is not installed.
400 ACCESS_ERROR You do not have access to the specified dialog

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

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