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