Молодцов Написать

Практика · обновлено 10.11.2026 · 9 минут чтения

Почему роботы Битрикс24 не срабатывают: стадии, созданные через REST

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

Есть дефект, который выглядит как «Битрикс24 сломался». Настраиваешь робота на стадии — например, «дата документа просрочена → перевести в Заблокирован» — переводишь карточку руками, ждёшь. Ничего. Ставишь того же робота без условия — работает.

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

Как это выглядит со стороны

Симптомы, по которым узнаётся именно этот дефект:

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

То есть портал «живёт», часть автоматизации идёт, и поэтому проблема долго не выглядит как дефект платформы. Она выглядит как «мы неправильно настроили робота».

Что проверял сначала — и почему это тупик

Обычные подозреваемые: права пользователя, от имени которого работает автоматизация; занятость сотрудника (роботы не исполняются для уволенных); лимиты тарифа; корректность самого условия.

Проверка по одной карточке показывает: робот присутствует, включён, условие в редакторе выглядит правильно. А результат — ноль. Дальше начинается перебор: поменять условие, убрать, вернуть, попробовать другой тип действия. Это часы и никакой гарантии.

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

Как устроены стадии в CRM

Стадии и статусы в Битрикс24 лежат в справочнике crm.status. У каждой записи есть ENTITY_ID — например, идентификатор стадии смарт-процесса вида DYNAMIC_<тип>_STAGE_<воронка> — и поле CATEGORY_ID, то есть номер воронки, которой запись принадлежит.

Когда карточка попадает на стадию, движок автоматизации ищет правила: «что настроено для этой стадии в этой воронке». Поиск идёт именно по паре «стадия + воронка». Если у записи CATEGORY_ID = 0, движок честно не находит ничего — правил для воронки 0 нет. Робот включён, условие корректно, а исполнять нечего.

Ключевая деталь: безусловные правила и триггеры живут по другим путям и от этой привязки не зависят. Поэтому картина получается такой неровной: часть автоматизации работает, часть молчит.

Откуда берётся CATEGORY_ID = 0

В моём случае стадии создавались старым методом crm.status.add. Метод принимает ENTITY_ID, но корректную привязку к воронке для смарт-процесса не проставляет — в записи остаётся CATEGORY_ID = 0. Визуально всё на месте: стадия есть, карточки по ней ходят, воронка выглядит нормально. Ломается только поиск правил автоматизации.

Масштаб удивил: в одном портале нашлось 29 таких стадий в 12 смарт-процессах. Стадии создавали несколько человек и несколько скриптов; сверху это выглядело как «какие-то роботы работают, какие-то нет», и причину искали месяцами.

Проверка гипотезы занимает полчаса: берём два робота одного типа — один на стадии, где автоматизация сработала, другой на «молчащей». Смотрим CATEGORY_ID у обеих стадий. Если у рабочей номер воронки совпадает, а у молчащей — 0, диагноз есть.

Роботы не срабатывают? Разберу портал

Посмотрю автоматизацию, найду, какие правила фактически исполняются, а какие висят мёртвыми, и соберу план исправлений.

Что НЕ помогает — проверено

  1. crm.status.update для исправления. Метод принимает запрос и даже отвечает успехом, но CATEGORY_ID не меняет: поле не входит в список обновляемых.
  2. REST 3.0 и метод обновления стадии. Метод обновления стадии воронки явно не принимает categoryId — перенести стадию в другую воронку через него нельзя.
  3. Правка «руками» через базу. В облаке системные записи справочника не редактируются — доступа к ним просто нет.

Это важный вывод: проблему нельзя вылечить точечным апдейтом записи. Она лечится пересозданием стадий или обходом на уровне процессов.

Что делать: три варианта

Вариант 1. Пересоздать стадии штатно

Стадии, созданные через интерфейс, получают корректную привязку к воронке. План такой:

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

Работы много, и её надо делать по одной стадии с проверкой после каждой. Планируйте не «перенести всё за вечер», а «по стадии в день плюс тест».

Вариант 2. Обойти бизнес-процессами

Пока стадии не пересозданы, критичные проверки можно поднять не на роботах, а на бизнес-процессах. Они не ищут правила по паре «стадия + воронка», поэтому дефект их не задевает.

Мой рабочий приём: бизнес-процесс с автозапуском по условиям стадии, а внутри — проверка данных и смена стадии действием «Изменить элемент». Так закрываются блокировки: просроченные документы, несоответствия в карточке, обязательные поля.

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

Вариант 3. Обращение в поддержку

Стоит написать, даже если выбрали обход: пусть зафиксируют причину. В моём случае поддержка подтвердила, что дефект вызван использованием устаревшего метода создания стадий, и дала рекомендацию — создавать стадии штатными средствами, а в автоматизации опираться на API 3.0.

Что приложить к обращению: список стадий с CATEGORY_ID = 0, идентификатор воронки из ENTITY_ID, пару примеров роботов, которые должны были сработать, и время теста.

Три грабли, на которые я наступил

  1. Пустая дата в условии считается «меньше сегодня». Если условие сверяет дату с текущей, а дата не заполнена, бизнес-процесс сработает как на просроченной. Проверяйте непустоту поля до сравнения — иначе получите массовую блокировку карточек.
  2. Робот «сменить стадию» с задержкой может работать там, где условный не работает. Это сбивает с толку: кажется, что автоматизация «частично жива». Так и есть, но по разным причинам.
  3. Одинаковое имя не значит одинаковую настройку. Роботы, собранные программно и через дизайнер, могут отличаться внутри. Если робот не срабатывает на «правильной» стадии — пересоздайте его штатно, прежде чем искать ошибку в платформе.

Чек-лист перед настройкой роботов

  1. Сверить CATEGORY_ID у всех стадий смарт-процесса: он должен совпадать с номером воронки, а не быть нулём.
  2. Составить список стадий с расхождением и держать его под рукой: это карта «где автоматизация не работает».
  3. Проверить, как создавались стадии: если скриптом через устаревший метод — ждите сюрпризов.
  4. Прогнать один контрольный робот с условием и один без условия на тестовой карточке. Разница в поведении сразу покажет, есть ли дефект.
  5. Для критичных проверок не полагаться на условных роботов: закрывать бизнес-процессами, пока стадии не пересозданы.
  6. Новые стадии создавать через интерфейс или API 3.0, после создания — проверять привязку.

Главное

Если робот с условием не срабатывает, а без условия — срабатывает, проблема почти наверняка не в роботе. Смотрите не на настройку, а на данные: к какой воронке привязана стадия и правила какого типа вы вообще настроили.

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

Проверю ваш портал на этот дефект

Напишите в Telegram, какие роботы должны срабатывать и что происходит в реальности. Скажу, похоже ли это на проблему привязки стадий, и что делать первым.

Вопросы

Вопросы и ответы

Почему одни роботы срабатывают, а другие нет?

Разные механизмы. Уведомления, триггеры и отложенные действия без условий не зависят от привязки стадии к воронке. А правила с условиями движок ищет по паре «стадия + воронка» — если в справочнике стадий воронка указана как 0, правила не находятся.

Можно ли исправить CATEGORY_ID через REST?

Нет. Метод обновления статуса принимает запрос и отвечает успехом, но поле не меняет: оно не входит в список обновляемых. Метод API 3.0 для стадий тоже не принимает номер воронки. Правку делает только пересоздание стадии.

Все стадии, созданные через API, сломаны?

Нет. Проблема в конкретном старом методе создания и в том, передавалась ли привязка к воронке. Если создавать стадии штатно через интерфейс или через API 3.0, привязка получается корректной. Проверять надо по факту: сверить номер воронки в записи стадии.

Как обойтись без пересоздания стадий?

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

Сколько это занимает и что скажет поддержка?

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