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

С чего начать: журнал роботов в карточке

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

Робот стоит не на той стадии?

Роботы привязаны к стадии и срабатывают в момент, когда элемент на неё попадает. Отсюда типовые промахи. Робот настроен в другой воронке: у каждой воронки свой набор роботов — проверьте, что редактировали ту, в которой живёт сделка. Робот стоит на стадии, через которую сделка не проходит: при переносе карточки сразу через несколько колонок срабатывают роботы целевой стадии, а промежуточные остаются нетронутыми. Сделка уже стояла на стадии, когда робота добавили, — это отдельный случай, о нём следующий раздел. Базовая настройка роботов и их отличие от триггеров — в статье о роботах.

Почему робот не действует задним числом?

Робот — реакция на событие «элемент попал на стадию». Если добавить робота на стадию, где уже стоят двадцать сделок, для них событие давно прошло — новый робот по ним не сработает. Это не сбой, а штатное поведение: задним числом роботы не запускаются. Что делать со старыми карточками: передвинуть на соседнюю стадию и вернуть — событие произойдёт заново; для массовой обработки выделите сделки в списке и смените стадию групповой операцией. И правило на будущее: добавив или изменив робота, прогоните одну тестовую сделку через стадию сразу — не ждите, пока расхождение всплывёт на боевых.

Условие отсекло: что робот видит на самом деле?

Условия запуска фильтруют срабатывание, и отсев почти всегда происходит из-за расхождения данных с ожиданиями: поле, которое «точно заполнено», в момент входа на стадию ещё пусто; значение приходит в другом формате; сравнение зацепило не то поле. Спорить с настройками бесполезно — посмотрите на данные глазами процесса. Робот «Проверить заполненность поля» принимает тип сущности, ID и код поля и возвращает признак Y/N плюс текущее значение: поставьте его на стадию без условий — журнал покажет, что реально лежит в поле в момент срабатывания. Комбинацию проверок прогоняет «Сложное условие (AND / OR / NOT)»: до четырёх сравнений с логикой AND/OR и итоговый Y/N. После этого чинят не воронку, а данные или само условие.

Права, тариф или удалённое приложение?

Если в журнале ошибки — смотрите окружение, а не логику. Робот выполняет действие от имени назначенного пользователя: нет прав на элемент, раздел или смену стадии — действие падает. Автоматизация зависит от тарифа: после перехода на более простой план часть роботов перестаёт быть доступной — сверьте возможности текущего тарифа. Отдельный случай — роботы, установленные приложениями из Битрикс24.Маркет: если приложение-источник удалили или закончилась подписка на Маркет, его роботы пропадают из шаблонов или перестают выполняться — проверьте список установленных приложений. И помните, что триггер — не робот: если карточка даже не двигается на стадию, диагностируйте триггеры.

Чек-лист

Журнал «Роботы» в карточке: запускался ли робот и с каким результатом. Воронка и стадия: робот стоит там, где сделка реально проходит. Ретроактивность: на старые сделки робот не действует — перегоните их через стадию. Условия: проверьте фактические значения полей роботом-диагностом, а не по памяти. Окружение: права исполнителя, тариф, живо ли приложение-источник. Диагностические кирпичи — проверка заполненности, сложное условие — в каталоге Роботеки: бесплатная установка из Битрикс24.Маркет. Нет нужного — опишите задачу, сделаем робота бесплатно.