Создать рабочий чат сделки по ключу операции

Робот «Создать рабочий чат сделки по ключу операции». Создаёт закрытый чат для обсуждения доступной сделки и проверяет его состав.

Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.

Для кого и какую проблему решает

Для менеджеров сложных сделок и координаторов, собирающих рабочую группу. Создаёт отдельное место обсуждения сделки и снижает риск дублей чата при повторном событии автоматизации.

Что подготовить

Установите действие в каталоге приложения «CRM роботы 2.0 + AI», затем добавьте его в нужную точку автоматизации. Для чтения или изменения объектов нужен соответствующий доступ пользователя подключения. Идентификаторы берите из полей карточки или результатов предыдущих шагов: название объекта не заменяет его числовой ID.

Параметры и значения

Поле в настройке	Тип	Обязательность и исходное значение
ID сделки	Целое число	Обязательное; значение по умолчанию не задано
Название чата	Строка	Обязательное; значение по умолчанию не задано
Участники (JSON ID)	Текст	Обязательное; значение по умолчанию не задано
Ожидаемый пользователь подключения	Сотрудник	Обязательное; значение по умолчанию не задано
Уникальный ключ операции	Строка	Обязательное; значение по умолчанию не задано

Поля, обозначенные JSON, заполняйте корректными массивами или объектами с двойными кавычками в строках. Подставляйте одно значение через штатный выбор данных редактора; не копируйте служебный идентификатор шага из другого шаблона.

Как использовать пошагово

1. Укажите ID доступной сделки и осмысленное название рабочего чата.
2. Передайте участников массивом числовых ID, например [21,22], не больше 50.
3. В ожидаемом пользователе выберите того сотрудника, чьим подключением выполняется приложение. Он станет владельцем и участником.
4. Задайте устойчивый ключ одной операции, например deal-900-team-chat-v1.
5. Сохраните ID созданного чата в поле процесса или передайте следующему действию работы с чатом. Первое сообщение при необходимости отправляйте отдельным шагом.

Учебный пример и ожидаемый результат

Для сделки 900 переданы название «Подготовка учебного проекта», участники [21,22], пользователь подключения 21 и ключ deal-900-chat-v1. При успехе возвращается ID закрытого рабочего чата. Повтор с теми же данными проверяет его и возвращает сохранённый результат. Все номера объектов в примере условные; замените их данными своего портала. Пример объясняет настройку, а не подтверждает выполненный запуск.

Какие результаты передать дальше

• ID рабочего чата: целое число.
• Получен сохранённый результат: да/нет (Y/N).

В следующем действии откройте выбор данных и выберите результат этого робота по названию. Сначала проверьте статус выполнения; при ошибке передайте её пояснение на разбор и не используйте пустые значения как подтверждённый результат. Успех шага и положительный ответ на бизнес-проверку: разные условия.

Ограничения и исправление ошибок

CRM-права не переносятся в права чата автоматически: заранее согласуйте участников. При повторе сверяются доступ к сделке, связь чата, владелец, название и состав. Частичное создание или неизвестный результат требуют ручной проверки; первое сообщение не отправляется.

Один ключ операции закрепляйте за одним событием и сохраняйте неизменным при его повторе вместе со всеми входными данными. Для другого события нужен другой ключ. Случайный новый ключ на каждом запуске допускает дубли. При неизвестном или частичном результате сначала сверяйте фактически созданный объект; не обходите остановку сменой ключа.

Если доступ изменился, сначала проверьте объект под пользователем подключения и актуальность ID. Повторяйте действие после устранения причины. Для действий с записью предварительно сверяйте фактическое состояние: сообщение об ошибке само по себе не доказывает, что ни одна правка не сохранилась.

Как заполнять JSON-поля

Каждый блок ниже вставляется целиком в своё поле. Не добавляйте внешние кавычки вокруг всего массива или объекта. Учебные ID и названия замените фактическими данными.

Участники (JSON ID)

[
  21,
  22
]

Значения массива обозначают ID сотрудников вашего портала. Берите их из результата поиска сотрудников или выбранного сотрудника, не из ID сделки. В массиве нужны положительные целые числа без объектов и фамилий. До 50 переданных участников; пользователь подключения добавляется в состав автоматически и станет владельцем. [] допустим и оставит только пользователя подключения, {} вместо массива неверен. Передаваемый состав согласуйте с доступом к обсуждению сделки.