Информация о диалоге

Робот Информация о диалоге ([OL] Информация о диалоге) получает подробные данные о диалоге открытой линии: статус, назначенный оператор, привязанные CRM-сущности, название чата и другие параметры.

Назначение

• Определить текущий статус диалога (открыт, принят, закрыт)
• Узнать, какой оператор назначен на диалог
• Получить привязанные CRM-сущности (лид, сделка, контакт, компания)
• Использовать данные диалога для ветвления логики бизнес-процесса

Параметры

Параметр	Описание	Обязательный
Тип идентификатора	Способ определения диалога: по ID чата, ID диалога или entity_id	Нет
Значение идентификатора	Значение для поиска диалога (по выбранному типу)	Нет
ID диалога	ID диалога в формате chatXXX или числовой	Нет

Заметка

Укажите хотя бы один из идентификаторов. Если указаны оба (Значение идентификатора и ID диалога), приоритет имеет Значение идентификатора.

Типы идентификаторов

Тип	Описание	Пример
ID чата (число)	Числовой ID внутреннего чата Битрикс24	12345
ID диалога (chatXXX)	ID диалога в формате Битрикс24	chat12345
Поле мессенджер / entity_id	Entity ID сессии из поля чат-трекера	loc_olchat_telegram|65|-1001327532020|0

Настройка в редакторе роботов

Шаг 1. Добавьте робота

На нужной стадии воронки добавьте робота [OL] Информация о диалоге из раздела Олчат.

Шаг 2. Укажите идентификатор

Выберите тип идентификатора и укажите значение. Если робот используется в цепочке после других роботов Олчат, можно использовать возвращаемое значение chat_id из предыдущего робота.

Настройка в дизайнере бизнес-процессов

В дизайнере бизнес-процессов параметры аналогичны. ID диалога можно получить из переменных процесса или результатов предыдущих действий.

Возвращаемые значения

Значение	Тип	Описание
success	bool	Успешно ли получена информация: Y или N
status	string	Статус диалога
operator_id	int	ID назначенного оператора
connector	string	Коннектор (тип мессенджера)
chat_id	string	Числовой ID чата
dialog_id	string	Dialog ID
ol_chat_name	string	Название чата открытой линии
ol_chat_owner	int	ID владельца чата
ol_chat_type	string	Тип чата
avatar	string	URL аватара чата
chat_entity_id	string	Entity ID чата
chat_entity_type	string	Тип entity
manager_list	string	Список операторов диалога
crm_lead_id	string	ID привязанного лида (пустой, если нет)
crm_deal_id	string	ID привязанной сделки
crm_contact_id	string	ID привязанного контакта
crm_company_id	string	ID привязанной компании
error	string	Текст ошибки
error_code	string	Код ошибки

Статусы диалога

Статус	Описание
client	Ожидает ответа оператора
operator	Принят оператором
closed	Диалог закрыт

Коды ошибок

Код	Описание
DIALOG_ID_EMPTY	ID диалога не указан
INFO_ERROR	Ошибка получения информации

Примеры использования

Проверка статуса перед действием

Перед отправкой напоминания проверить, не закрыт ли диалог:

1. Информация о диалоге — получить статус
2. Условие: если status не равен closed
3. Отправить сообщение — отправить напоминание

Получение CRM-привязок

Узнать, к какой сделке привязан диалог:

1. Информация о диалоге — получить данные
2. Использовать crm_deal_id для дальнейших операций с CRM

Примечания и рекомендации

Совет

Возвращаемые значения crm_lead_id, crm_deal_id, crm_contact_id и crm_company_id позволяют связать диалог с CRM-данными без дополнительных запросов.

• Робот работает с любыми диалогами открытых линий, не только Олчат
• Если диалог не найден, робот возвращает success = N с описанием ошибки
• Значение operator_id содержит ID пользователя Битрикс24, назначенного оператором