Роботека
Роботека · Роботы · Дата входа в стадию

Дата входа в стадию

Робот «Дата входа в стадию» возвращает в бизнес-процесс Битрикс24 дату, когда сделка, лид или элемент смарт-процесса попал в указанную стадию, и число входов в неё. Стадия задаётся кодом или названием, на выбор берётся первый или последний вход.

Робот отдаёт дату попадания в нужную стадию прямо в бизнес-процессе Битрикс24, читая историю в момент выполнения. Стадию можно указать кодом или названием: код имеет приоритет, поэтому переименование стадии в воронке ничего не ломает — в отличие от решений, привязанных только к названию. Если сущность возвращалась в стадию несколько раз, выбирается первый или последний вход, а отдельным значением возвращается число входов — по нему видно откаты назад по воронке. Поддерживаются сделки, лиды и смарт-процессы; по умолчанию берётся сущность, на которой запущен процесс. Стадия, которой на портале нет, считается ошибкой настройки и сообщается явно, а стадия, в которой сущность просто не была, — обычным ответом «не найдено». Учитываются и воронки, между которыми сущность переезжала.

Какие параметры принимает робот?

Параметр Тип Обязательный? По умолчанию
Сущность select Текущая сущность, Сделка по ID, Лид по ID, Смарт-процесс по ID — auto
ID сущности (для режимов «по ID») string —
ID типа смарт-процесса (только для режима смарт-процесса) string —
Стадия — код или название string да
Какой вход select Последний, Первый — last

Что возвращает робот?

Параметр Тип
Дата входа в стадию string
Код стадии string
Название стадии string
Сколько раз входили в стадию int
Вход в стадию найден (Y/N) bool
Успешно bool

Какие ошибки может вернуть робот?

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

  • Стадия «{stage}» не найдена на портале. Укажите код стадии или её точное название.
  • У этой сущности нет стадий. Робот работает со сделками, лидами и смарт-процессами; для режима «по ID» укажите корректный ID.
  • Ошибка API при чтении истории стадий.

Сценарий: контроль зависших сделок

  1. Робот запускается регулярным процессом по сделке
  2. Он берёт дату последнего входа в стадию «Счёт выставлен»
  3. Если с этой даты прошло больше семи дней, руководителю ставится задача, а число входов показывает, сколько раз сделка уже откатывалась

Похожие роботы