Отладка сценария автоматизации

Робот не отправил письмо, задача не поставилась, сделка «застряла» на стадии — это почти всегда объяснимо. В Битрикс24 у автоматизации есть понятная логика запуска и следы выполнения, по которым проблему видно за пару минут. Разбираем, где искать лог роботов, как читать статусы и в каком порядке проверять сценарий, чтобы не гадать.

Как устроен запуск и где он ломается

Роботы в Битрикс24 привязаны к стадии воронки и запускаются в момент, когда сделка (лид, счёт, смарт-процесс) входит на эту стадию. Триггеры работают наоборот: они «слушают» внешнее событие (приход оплаты, открытие письма, звонок) и сами двигают сделку на нужную стадию, где её подхватывают роботы.

Отсюда три самых частых источника сбоя, которые надо держать в голове ещё до диагностики:

• Робот добавили задним числом. Он не сработает на сделках, которые уже стоят на этой стадии, — только на тех, что войдут на неё после сохранения настроек.
• Не выполнены условия. На вкладке Условия выполнения задан фильтр по полям, и сделка под него не попадает — робот молча пропускается.
• Робот ждёт. У него настроена задержка или ограничение по рабочему времени, и он стоит в очереди, а не «не сработал».

Лог роботов: где смотреть следы выполнения

Первый инструмент отладки — сама карточка сделки. В правой части карточки блок автоматизации показывает запланированные и уже выполненные роботы для текущей стадии: значок с часами означает, что робот стоит в очереди (обычно из-за задержки), и по наведению видно ориентировочное время запуска.

Второй источник — таймлайн сделки. Действия роботов оставляют в нём записи: отправленные письма и SMS, поставленные задачи, смену ответственного, комментарии. Если ожидаемого события в таймлайне нет — робот до него не дошёл, и это уже сужает поиск.

• Проверьте, на какой стадии сейчас стоит сделка и какие роботы к ней привязаны;
• сопоставьте список запланированных роботов с тем, что реально произошло в таймлайне;
• для писем и SMS откройте конкретную запись — там виден адрес отправителя, получатель и статус доставки.

Почему робот не сработал: карта причин

Когда действие не произошло, идите по причинам от самых частых к редким. Ниже — сводка, что проверять и где именно.

Отдельно про триггеры: если сделка не двигается автоматически, проверьте, что триггер привязан к правильной стадии и что источник события действительно наступил — например, для «Прихода оплаты» должен быть выставлен и оплачен счёт, а для «Открытия письма» письмо должно быть отправлено штатным роботом Битрикс24, а не вручную.

Тестовая сделка: проверяем сценарий безопасно

Отлаживать автоматизацию на «живых» клиентах — плохая идея: реальный клиент получит тестовое письмо, а менеджер — фантомную задачу. Правильный подход — прогнать сценарий на тестовой сделке.

1. Создайте сделку с вашим собственным контактом (свой e-mail и телефон) — так вы увидите, что реально приходит клиенту.
2. Проведите её по всем стадиям сценария вручную, по одной, и на каждой сверяйтесь с блоком автоматизации и таймлайном.
3. Для роботов с задержкой временно поставьте минимальный интервал, чтобы не ждать сутки, — а после проверки верните боевое значение.
4. Проверяйте связки целиком: триггер → смена стадии → робот → результат, а не отдельные шаги в отрыве.

Задержки, расписание и очередь выполнения

Значительная часть «пропавших» роботов на самом деле просто ждёт своей очереди. В настройке каждого робота есть параметр Время выполнения с вариантами: сразу, с задержкой, в конкретное время суток или после выполнения предыдущего робота.

Что важно учитывать при отладке:

• Ограничение по рабочему времени. Если у робота включено «выполнять только в рабочее время», он дождётся начала рабочего дня по графику компании — и это выглядит как «сработал с опозданием».
• Смена стадии обрывает ожидание. Если сделка ушла со стадии раньше, чем истекла задержка, запланированный робот этой стадии обычно уже не выполнится — сценарий надо строить с учётом того, что клиент двигается быстрее таймера.
• Цепочки с «после предыдущего». Если ранний робот в цепочке завис или не выполнил условие, все зависящие от него роботы тоже не стартуют.

Поэтому при разборе «медленных» сценариев первым делом смотрите не на код действия, а на его расписание и на то, не покинула ли сделка стадию раньше срока.

Коробочная версия: агенты, cron и журнал бизнес-процессов

В облаке Битрикс24 очередь автоматизации обрабатывается на стороне сервиса, и отдельно её настраивать не нужно. В коробочной версии отложенные роботы и триггеры зависят от агентов и очереди модуля bizproc — того же движка, на котором работают бизнес-процессы.

Если в коробке роботы «сразу» работают, а роботы с задержкой — нет, почти всегда причина в фоновом выполнении:

• проверьте, что настроен запуск агентов и очереди по cron, а не «на хите»; на страницах без трафика отложенные задачи иначе не выполняются;
• убедитесь, что не переполнена и не остановлена очередь бизнес-процессов;
• для сложных сценариев используйте журнал бизнес-процессов — он даёт детальный лог по шагам, каких нет у облачных роботов, и помогает поймать ошибку в конкретном действии.

Итог

Отладка сценария автоматизации в Битрикс24 — это дисциплина, а не угадывание. Порядок один: определить стадию и привязанных к ней роботов, свериться с блоком автоматизации и таймлайном, проверить условия выполнения, затем задержки и расписание, и только в коробке — агенты, cron и журнал бизнес-процессов. Тестовая сделка с вашим собственным контактом закрывает 90% вопросов до того, как их заметит клиент.

Мы в B2Bsite проектируем и отлаживаем автоматизацию Битрикс24 под реальные процессы продаж: собираем сценарии из роботов и триггеров, проверяем их на тестовых воронках и настраиваем фоновое выполнение в коробочных порталах. Если роботы срабатывают через раз или сделки «залипают» на стадиях — поможем найти причину и привести сценарий в порядок.