Остановить выбранный процесс лида или сделки
Останавливает конкретный запущенный процесс с сохранением его данных после проверки карточки и шаблона.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую проблему решает
Робот полезен для администратора бизнес-процессов, останавливающего проверенный экземпляр. Для одной карточки запущено несколько согласований, и остановка по одному названию опасна. Робот проверяет совпадение карточки, строкового ID экземпляра и ожидаемого шаблона перед остановкой конкретного процесса.
Что делает и когда применять
Останавливает конкретный запущенный процесс с сохранением его данных после проверки карточки и шаблона.
Доступно подключению администратора. Принимает тип карточки 1/2, ID, строковый WORKFLOW_ID, ожидаемый шаблон и необязательный текст статуса до 4000 символов. До остановки подтверждает точное совпадение карточки, экземпляра и шаблона. Если экземпляр не найден в списке запущенных, останавливать ничего не пытается и возвращает ошибку. После подтверждения команды проверяет отсутствие в списке запущенных. Это не подтверждение успешного выполнения самого процесса. При неизвестном ответе или ошибке проверки нужна ручная сверка; автоматического повтора нет.
Что подготовить
Нужен установленный робот из приложения «CRM роботы 2.0 + AI» и право на настройку автоматизации нужной CRM-воронки или шаблона бизнес-процесса. Пользователю, от имени которого работает приложение, должны быть доступны выбранные CRM-элементы и нужное действие с ними.
Требуется подключение администратора. Сначала получите активные процессы документа и выберите точный экземпляр. Укажите тип лида или сделки, её ID и ожидаемый ID шаблона; остановка должна соответствовать вашему решению.
Как настроить и использовать
- Откройте автоматизацию нужной сущности и выберите стадию, на которой нужен робот «Остановить выбранный процесс лида или сделки». В шаблоне бизнес-процесса добавьте одноимённое действие.
- Требуется подключение администратора. Сначала получите активные процессы документа и выберите точный экземпляр. Укажите тип лида или сделки, её ID и ожидаемый ID шаблона; остановка должна соответствовать вашему решению.
- Заполните Тип карточки: 1 — лид, 2 — сделка, ID карточки, Строковый ID экземпляра, Ожидаемый ID шаблона, Текст статуса остановки, до 4000 символов. Для рабочего сценария подставьте значения полей документа или результаты предыдущих действий вместо учебных данных ниже.
- Проверьте обязательные поля и варианты выбора в таблице настроек. Сохраните действие и свяжите его результаты с дальнейшими условиями процесса.
- Выполните пробный запуск на отдельном учебном элементе. Сначала проверьте статус и пояснение ошибки, затем содержательный результат и ветку, выбранную следующим действием.
Параметры робота
Имена полей ниже совпадают с настройками действия. Значения из таблицы относятся к самому роботу; результаты предыдущих шагов выбирайте через подстановку значения в редакторе.
| Поле в настройках | Что передать | Обязательность и исходное значение |
|---|---|---|
Тип карточки: 1 — лид, 2 — сделка (ENTITY_TYPE_ID) |
Формат: целое число. | Обязательно. Значение по умолчанию в настройках не задано |
ID карточки (ENTITY_ID) |
Формат: целое число. | Обязательно. Значение по умолчанию в настройках не задано |
Строковый ID экземпляра (WORKFLOW_ID) |
Формат: строка. | Обязательно. Значение по умолчанию в настройках не задано |
Ожидаемый ID шаблона (EXPECTED_TEMPLATE_ID) |
Формат: целое число. | Обязательно. Значение по умолчанию в настройках не задано |
Текст статуса остановки, до 4000 символов (STATUS_TEXT) |
Формат: текст. | Необязательно. Значение по умолчанию в настройках не задано |
Учебный пример
Пример показывает способ настройки на вымышленных данных и ожидаемый смысл результата; это не отчёт о запуске на вашем портале.
- Тип карточки: 1 — лид, 2 — сделка (
ENTITY_TYPE_ID):2. - ID карточки (
ENTITY_ID):501. - Строковый ID экземпляра (
WORKFLOW_ID): подставьте строковый ID выбранного запущенного экземпляра из результата поиска процессов. - Ожидаемый ID шаблона (
EXPECTED_TEMPLATE_ID):21. - Текст статуса остановки, до 4000 символов (
STATUS_TEXT):Учебное согласование остановлено администратором..
После подтверждённой остановки робот отдельно проверяет отсутствие экземпляра в активном списке. Это не подтверждает успешное выполнение самого процесса. Если экземпляр не найден ещё до команды, остановка не отправляется и возвращается ошибка.
Какие данные возвращает и что делать дальше
| Результат | Какое значение получает следующий шаг |
|---|---|
ID экземпляра (workflowId) |
строка |
Остановка принята (terminationAccepted) |
да/нет |
Отсутствует в списке запущенных (removedFromActiveList) |
да/нет |
Статус выполнения (status) |
да/нет |
Пояснение ошибки (error) |
строка |
Проверяйте «Остановка принята» и «Отсутствует в списке запущенных» раздельно. При неизвестном ответе сначала выполните ручную сверку; автоматического повторного запуска остановки здесь нет.
Ошибки и ограничения
Проверяйте результат действия до следующего изменения карточки. Ошибка доступа, неверный идентификатор и отсутствие найденного элемента требуют разных веток процесса. Не подставляйте нулевой или пустой результат как идентификатор существующего документа.