Получение текущей стадии

Возвращает код и название текущей стадии CRM-элемента.

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

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

Робот полезен для администратора CRM, который строит условия по текущей стадии документа. Шаблон запускается из разных стадий, и записанный в настройках код быстро устаревает. Робот читает фактическую текущую стадию контекстного лида, сделки или элемента смарт-процесса.

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

Робот показывает, на какой стадии сейчас находится текущий CRM-элемент: лид, сделка или элемент смарт-процесса.

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

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

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

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

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

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

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

Отдельных входных полей нет. Действие использует текущий CRM-элемент.

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

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

Добавьте действие в учебную карточку нужной сущности и проверьте возвращённые значения.

При запуске в учебной сделке на стадии «Новая» результаты содержат её код и название. Если стадия поменяется до чтения, возвращается фактическое состояние на момент действия, а не прежняя стадия запуска.

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

Результат	Какое значение получает следующий шаг
ID стадии (stageId)	строка
Название стадии (stageName)	строка
Статус (status)	да/нет
Ошибка (error)	строка

Используйте «ID стадии» для устойчивых условий ветвления, а название для понятного комментария. Сравнивайте код в пределах правильного направления; одинаковые названия стадий могут относиться к разным воронкам.

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

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