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