Получение предыдущей стадии

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

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

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

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

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

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

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

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

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

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

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

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

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

Поле в настройках	Что передать	Обязательность и исходное значение
ID элемента (elementId)	Формат: целое число.	Необязательно. Значение по умолчанию в настройках не задано

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

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

• ID элемента (elementId): 501.

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

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

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

Используйте «ID стадии» для условия, а название для уведомления. При отсутствии предыдущей стадии не подменяйте её текущей: предусмотрите отдельную ветку первого перехода или недоступных сведений.

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

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