Запустить умный сценарий через бизнес-процесс
Запускает заранее настроенный умный сценарий для текущего элемента CRM, чтобы выполнять повторяющиеся действия без ручного запуска.
Для кого и какую проблему решает
Робот полезен для администратора CRM, автоматизирующего уже настроенный умный сценарий. Умный сценарий приходится запускать вручную для каждого элемента. Робот запускает подготовленный бизнес-процесс, внутри которого настроен нужный умный сценарий и сотрудник с правом его запуска.
Что делает и когда применять
Запускает заранее настроенный умный сценарий для текущего элемента CRM, чтобы выполнять повторяющиеся действия без ручного запуска.
Сначала создайте отдельный бизнес-процесс с действием «Запустить Умный сценарий» и укажите в нём нужный сценарий, текущий элемент и сотрудника с правами запуска. В роботе укажите ID этого бизнес-процесса, а не ID умного сценария. Тип элемента в шаблоне должен совпадать с текущим элементом CRM. Параметры передаются в выбранный бизнес-процесс: например, {"employee":"user_14"}. Без параметров оставьте поле пустым или укажите {}. Не добавляйте этот робот в запускаемый бизнес-процесс, чтобы не создать цикл. Робот возвращает ID запущенного процесса и не ждёт окончания сценария; проверьте его выполнение в журнале элемента.
Что подготовить
Нужен установленный робот из приложения «CRM роботы 2.0 + AI» и право на настройку автоматизации нужной CRM-воронки или шаблона бизнес-процесса. Пользователю, от имени которого работает приложение, должны быть доступны выбранные CRM-элементы и нужное действие с ними.
Сначала создайте отдельный бизнес-процесс с действием «Запустить Умный сценарий». В нём выберите сценарий, текущий элемент и сотрудника. В роботе указывайте ID именно этого бизнес-процесса, а не ID умного сценария.
Как настроить и использовать
- Откройте автоматизацию нужной сущности и выберите стадию, на которой нужен робот «Запустить умный сценарий через бизнес-процесс». В шаблоне бизнес-процесса добавьте одноимённое действие.
- Сначала создайте отдельный бизнес-процесс с действием «Запустить Умный сценарий». В нём выберите сценарий, текущий элемент и сотрудника. В роботе указывайте ID именно этого бизнес-процесса, а не ID умного сценария.
- Заполните ID бизнес-процесса с умным сценарием, Параметры бизнес-процесса (JSON). Для рабочего сценария подставьте значения полей документа или результаты предыдущих действий вместо учебных данных ниже.
- Проверьте обязательные поля и варианты выбора в таблице настроек. Сохраните действие и свяжите его результаты с дальнейшими условиями процесса.
- Выполните пробный запуск на отдельном учебном элементе. Сначала проверьте статус и пояснение ошибки, затем содержательный результат и ветку, выбранную следующим действием.
Параметры робота
Имена полей ниже совпадают с настройками действия. Значения из таблицы относятся к самому роботу; результаты предыдущих шагов выбирайте через подстановку значения в редакторе.
| Поле в настройках | Что передать | Обязательность и исходное значение |
|---|---|---|
ID бизнес-процесса с умным сценарием (templateId) |
Формат: целое число. | Обязательно. Значение по умолчанию в настройках не задано |
Параметры бизнес-процесса (JSON) (parameters) |
Формат: текст. | Необязательно. По умолчанию: {} |
Учебный пример
Пример показывает способ настройки на вымышленных данных и ожидаемый смысл результата; это не отчёт о запуске на вашем портале.
- ID бизнес-процесса с умным сценарием (
templateId):21. - Параметры бизнес-процесса (JSON) (
parameters):{"employee":"user_14"}.
Параметры бизнес-процесса (JSON) (parameters)
Копируйте в это поле только содержимое блока, без названия поля и внешней обёртки со всеми настройками. Здесь нужен JSON-объект в фигурных скобках. Пустой объект {} и массив [] имеют разный тип. Ключи и типы параметров задаёт выбранный вами шаблон. {} подходит только когда шаблон не требует входных параметров; учебные имена не добавляются автоматически в чужой шаблон.
{
"employee": "user_14"
}
Запускается подготовленный бизнес-процесс 21 для текущего элемента; employee передаётся только если такой параметр действительно предусмотрен вашим шаблоном. Возвращаемый ID подтверждает запуск, а не успешное окончание умного сценария.
Какие данные возвращает и что делать дальше
| Результат | Какое значение получает следующий шаг |
|---|---|
ID запущенного бизнес-процесса (workflowId) |
строка |
Статус выполнения (status) |
да/нет |
Пояснение ошибки (error) |
строка |
Сохраните «ID запущенного бизнес-процесса» и проверьте выполнение в журнале элемента. Тип элемента в шаблоне должен совпадать с контекстом. Не включайте этого робота в запускаемый им процесс.
Ошибки и ограничения
Проверяйте результат действия до следующего изменения карточки. Ошибка доступа, неверный идентификатор и отсутствие найденного элемента требуют разных веток процесса. Не подставляйте нулевой или пустой результат как идентификатор существующего документа.