Запустить бизнес-процесс лида или сделки по ключу операции

Запускает выбранный шаблон на карточке и сохраняет подтверждение запуска для повторных обращений.

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

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

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

Что делает и когда применять

Запускает выбранный шаблон на карточке и сохраняет подтверждение запуска для повторных обращений.

Принимает тип карточки 1/2, ID, шаблон, параметры JSON и уникальный REQUEST_KEY. Возвращает строковый ID экземпляра и подтверждение принятого запуска started_receipt; окончания процесса не ждёт. Повтор с тем же ключом и данными не отправляет новый запуск и заново проверяет доступ к карточке. activeNowKnown показывает, удалось ли проверить наличие в текущем списке запущенных процессов; activeNow имеет смысл только при known=Y. Отсутствие в списке не означает успешное завершение. Неизвестный результат запуска требует ручной сверки перед новым ключом. Для точных дробных параметров используйте строки. Не включайте этот запуск в вызываемый шаблон, чтобы избежать цикла.

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

Нужен установленный робот из приложения «CRM роботы 2.0 + AI» и право на настройку автоматизации нужной CRM-воронки или шаблона бизнес-процесса. Пользователю, от имени которого работает приложение, должны быть доступны выбранные CRM-элементы и нужное действие с ними.

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

Как настроить и использовать

1. Откройте автоматизацию нужной сущности и выберите стадию, на которой нужен робот «Запустить бизнес-процесс лида или сделки по ключу операции». В шаблоне бизнес-процесса добавьте одноимённое действие.
2. Выберите доступный шаблон для лида или сделки. Параметры должны соответствовать этому шаблону; точные дробные значения передавайте строками. Создайте ключ события, который будет неизменным при повторной проверке того же запуска.
3. Заполните Тип карточки: 1 — лид, 2 — сделка, ID карточки, ID шаблона, Параметры шаблона JSON, Уникальный ключ операции. Для рабочего сценария подставьте значения полей документа или результаты предыдущих действий вместо учебных данных ниже.
4. Проверьте обязательные поля и варианты выбора в таблице настроек. Сохраните действие и свяжите его результаты с дальнейшими условиями процесса.
5. Выполните пробный запуск на отдельном учебном элементе. Сначала проверьте статус и пояснение ошибки, затем содержательный результат и ветку, выбранную следующим действием.

Параметры робота

Имена полей ниже совпадают с настройками действия. Значения из таблицы относятся к самому роботу; результаты предыдущих шагов выбирайте через подстановку значения в редакторе.

Поле в настройках	Что передать	Обязательность и исходное значение
Тип карточки: 1 — лид, 2 — сделка (ENTITY_TYPE_ID)	Формат: целое число.	Обязательно. Значение по умолчанию в настройках не задано
ID карточки (ENTITY_ID)	Формат: целое число.	Обязательно. Значение по умолчанию в настройках не задано
ID шаблона (TEMPLATE_ID)	Формат: целое число.	Обязательно. Значение по умолчанию в настройках не задано
Параметры шаблона JSON (PARAMETERS)	Формат: текст.	Необязательно. По умолчанию: {}
Уникальный ключ операции (REQUEST_KEY)	Формат: строка.	Обязательно. Значение по умолчанию в настройках не задано

Учебный пример

Пример показывает способ настройки на вымышленных данных и ожидаемый смысл результата; это не отчёт о запуске на вашем портале.

• Тип карточки: 1 — лид, 2 — сделка (ENTITY_TYPE_ID): 2.
• ID карточки (ENTITY_ID): 501.
• ID шаблона (TEMPLATE_ID): 21.
• Параметры шаблона JSON (PARAMETERS): {}.
• Уникальный ключ операции (REQUEST_KEY): deal-501-agreement-v1.

Параметры шаблона JSON (PARAMETERS)

Копируйте в это поле только содержимое блока, без названия поля и внешней обёртки со всеми настройками. Здесь нужен JSON-объект в фигурных скобках. Пустой объект {} и массив [] имеют разный тип. Ключи и типы параметров задаёт выбранный вами шаблон. {} подходит только когда шаблон не требует входных параметров; учебные имена не добавляются автоматически в чужой шаблон.

{}

При подтверждённом старте возвращаются строковый ID процесса и started_receipt. Это принятие запуска, а не завершение согласования. Повтор с тем же ключом не должен создавать ещё один экземпляр; неизвестный итог требует ручной сверки.

Какие данные возвращает и что делать дальше

Результат	Какое значение получает следующий шаг
ID экземпляра процесса (workflowId)	строка
Подтверждение принятого запуска (receipt)	строка
Получен сохранённый результат (replayed)	да/нет
Проверено наличие в списке запущенных (activeNowKnown)	да/нет
Есть в списке запущенных (activeNow)	да/нет
Статус выполнения (status)	да/нет
Пояснение ошибки (error)	строка

Сохраните «ID экземпляра процесса» и подтверждение. «Есть в списке запущенных» используйте только если наличие удалось проверить. Не добавляйте этот запуск в вызываемый шаблон, чтобы не получить цикл.

Ошибки и ограничения

Проверяйте результат действия до следующего изменения карточки. Ошибка доступа, неверный идентификатор и отсутствие найденного элемента требуют разных веток процесса. Не подставляйте нулевой или пустой результат как идентификатор существующего документа.