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