Получение ID чата по сущности

Данное активити (робот) позволяет получить ID чата по сущности.
Результатом работы является ID чата, который можно использовать в других активити для работы с чатами (например, отправка сообщений, обновление чата и т.д.).

Как работает активити (робот):
- Вы выбираете Тип чата и указываете ID сущности;
- Для CRM можно дополнительно выбрать Тип CRM сущности, чтобы упростить заполнение;
- Активити выполняет запрос im.chat.get и возвращает ID найденного чата;
- Если чат по указанной сущности не найден, активити завершится с ошибкой.

Описание параметров активити (робота)

Название поля	Описание и примеры использования
Тип чата	Определяет, как формировать запрос к im.chat.get. Доступные значения: - CRM - чат, привязанный к CRM сущности; - LINES - чат открытой линии; - LIVECHAT - чат с коллегами.
Тип CRM сущности	Используется только при Тип чата = CRM. Позволяет выбрать тип CRM сущности из списка (лид, сделка, контакт, компания, счета, смарт-процессы и т.д.). Примеры: LEAD, DEAL, DYNAMIC_167.
ID сущности	Идентификатор сущности. Формат зависит от выбранного Типа чата. Тип чата = CRM - Если вы заполняете поле Тип CRM сущности, то можно не заполнять ID сущности - тогда ID будет взят из текущего документа бизнес-процесса. - Если вы заполняете ID сущности вручную, указывайте его так, как он задан в вашей логике процесса (например, из переменной/поля документа). Тип чата = LINES Укажите идентификатор диалога открытой линии в формате Битрикс24. Пример для LINES: - telegrambot\|2\|209607941\|744.

Примеры использования активити (робота)

Описание примера	Решение
CRM: указать ID сущности вручную	Тип чата = CRM, ID сущности заполнен вручную (например, из переменной или поля документа). Активити вернёт chat_id.
CRM: взять ID из текущего документа БП	Тип чата = CRM, Тип CRM сущности = DEAL, ID сущности не заполнять. Активити возьмёт ID из текущего документа и сформирует ENTITY_ID автоматически.
Сделка: получить ID чата и отправить важную информацию	В роботе сделки добавьте шаг 1: "Получение ID чата по сущности" (Тип чата = CRM, Тип CRM сущности = DEAL, ID сущности можно не заполнять). Шаг 2: используйте полученный chat_id в активити отправки сообщения, чтобы написать клиенту или коллеге важную информацию по сделке.
Смарт-процесс: получить ID чата по элементу и уведомить участников	В роботе смарт-процесса добавьте "Получение ID чата по сущности" (Тип чата = CRM, Тип CRM сущности = нужный смарт-процесс). Далее используйте chat_id для отправки сообщения в чат по элементу смарт-процесса (например, о смене стадии или необходимости действия).
Счет: получить ID чата и отправить реквизиты/статус	В роботе по счету добавьте "Получение ID чата по сущности" (Тип чата = CRM, Тип CRM сущности = счет). После получения chat_id отправьте сообщение с важной информацией: статус оплаты, сумма, срок оплаты или ссылка на счет.
Добавить пользователя в чат по сущности	Сначала получите chat_id через "Получение ID чата по сущности". Затем используйте chat_id в активити добавления пользователя в чат, чтобы подключить нужного сотрудника (например, юриста или бухгалтера) к обсуждению.
LINES: получить чат открытой линии	Тип чата = LINES, ID сущности = telegrambot\|2\|209607941\|744. Активити вернёт chat_id.

Возвращаемые параметры данного активити:
- ID чата (chat_id) - числовой идентификатор чата, найденный по сущности.

Ваша корзина пуста

Получение ID чата по сущности