Роботека
Роботека · Роботы · История стадий списком

История стадий списком

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

Робот отдаёт всю историю движения по стадиям прямо в бизнес-процессе Битрикс24, читая её в момент выполнения. Возвращаются три строго параллельных массива — коды стадий, их названия и даты входа: i-й элемент каждого массива описывает один и тот же переход, поэтому списки можно передавать в роботы работы с массивами и собирать любые отчёты. Отдельно возвращается готовая строка вида «Новая — 01.09.2026 10:00; Счёт выставлен — 03.09.2026 11:00», которую сразу вставляют в комментарий к сделке или в письмо руководителю, и число переходов. Порядок хронологический, от первой стадии к последней. Даты приходят в часовом поясе портала, поэтому совпадают с тем, что видно в карточке. Поддерживаются сделки, лиды и смарт-процессы; по умолчанию берётся сущность, на которой запущен процесс. Перенос между воронками учитывается как обычный переход.

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

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

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

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

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

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

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

Сценарий: путь сделки в комментарий при закрытии

  1. Сделка переходит в успешную стадию
  2. Робот получает историю стадий одной строкой
  3. Строка публикуется комментарием в таймлайн, и вся команда видит, каким путём шла сделка и сколько было переходов

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