Дата входа в стадию
Робот «Дата входа в стадию» возвращает в бизнес-процесс Битрикс24 дату, когда сделка, лид или элемент смарт-процесса попал в указанную стадию, и число входов в неё. Стадия задаётся кодом или названием, на выбор берётся первый или последний вход.
Робот отдаёт дату попадания в нужную стадию прямо в бизнес-процессе Битрикс24, читая историю в момент выполнения. Стадию можно указать кодом или названием: код имеет приоритет, поэтому переименование стадии в воронке ничего не ломает — в отличие от решений, привязанных только к названию. Если сущность возвращалась в стадию несколько раз, выбирается первый или последний вход, а отдельным значением возвращается число входов — по нему видно откаты назад по воронке. Поддерживаются сделки, лиды и смарт-процессы; по умолчанию берётся сущность, на которой запущен процесс. Стадия, которой на портале нет, считается ошибкой настройки и сообщается явно, а стадия, в которой сущность просто не была, — обычным ответом «не найдено». Учитываются и воронки, между которыми сущность переезжала.
Какие параметры принимает робот?
| Параметр | Тип | Обязательный? | По умолчанию |
|---|---|---|---|
| Сущность | select | — | auto |
| ID сущности (для режимов «по ID») | string | — | |
| ID типа смарт-процесса (только для режима смарт-процесса) | string | — | |
| Стадия — код или название | string | да | |
| Какой вход | select | — | last |
Что возвращает робот?
| Параметр | Тип |
|---|---|
| Дата входа в стадию | string |
| Код стадии | string |
| Название стадии | string |
| Сколько раз входили в стадию | int |
| Вход в стадию найден (Y/N) | bool |
| Успешно | bool |
Какие ошибки может вернуть робот?
Эти сообщения робот пишет в журнал бизнес-процесса, когда не может выполнить шаг. По тексту видно, что исправить в настройках или данных.
- Стадия «{stage}» не найдена на портале. Укажите код стадии или её точное название.
- У этой сущности нет стадий. Робот работает со сделками, лидами и смарт-процессами; для режима «по ID» укажите корректный ID.
- Ошибка API при чтении истории стадий.
Сценарий: контроль зависших сделок
- Робот запускается регулярным процессом по сделке
- Он берёт дату последнего входа в стадию «Счёт выставлен»
- Если с этой даты прошло больше семи дней, руководителю ставится задача, а число входов показывает, сколько раз сделка уже откатывалась