Запуск БП по событию

Модуль "Запуск БП по событию" предназначен для автоматического запуска бизнес-процессов Битрикс24 при наступлении событий (создание, изменение, удаление сущностей) с возможностью фильтрации по полям сущности.
Результатом работы модуля является возможность настроить шаблоны, которые при срабатывании определённого события (например, добавление сделки, изменение задачи) проверяют условия фильтра по полям сущности и при совпадении запускают указанный бизнес-процесс.
Поддерживаются все основные сущности CRM: задачи, календарь, рабочие группы, лента новостей и другие.

Название функции	Описание и примеры использования
Создание шаблона запуска	Позволяет создать шаблон, связывающий событие Битрикс24 с бизнес-процессом. При наступлении события система проверяет все активные шаблоны для этого события и при совпадении фильтров запускает соответствующий БП. Как использовать: - Нажмите "Добавить шаблон"; - Выберите тип сущности (Сделка, Задача, Рабочие группы и др.); - Выберите событие (При добавлении, При изменении, При удалении); - Выберите шаблон бизнес-процесса для запуска; - При необходимости укажите условия фильтра по полям сущности. Важно: Для событий удаления фильтр недоступен, так как сущность уже удалена и данные для проверки получить невозможно.
Фильтрация по полям сущности	Позволяет указать условия, при выполнении которых бизнес-процесс будет запущен. Доступные поля зависят от типа сущности. Поддерживаются операторы сравнения: равно (=), не равно (!=, !), больше (>), меньше (<), больше или равно (>=), меньше или равно (<=), LIKE (%, =%), NOT LIKE (!%, !%=), IN (@), NOT IN (!@). Как использовать: - Заполните поля фильтра в блоке "Условия запуска БП"; - Для полей можно указать префикс оператора (например, >=ID для "ID больше или равно"); - Для оператора @ (IN) значение передаётся в виде JSON-массива. Примеры: NAME="Важная сделка", STAGE_ID@["C1:NEW","C1:PREPARATION"], ASSIGNED_BY_ID=user_1
Запуск БП в другой сущности	Позволяет запустить бизнес-процесс не в сущности события, а в связанной сущности. Например, при событии по задаче запустить БП по сделке, указав поле задачи, из которого брать ID сделки. Как использовать: - Выберите "Тип сущности для запуска" (например, Сделка); - Укажите "Поле, из которого брать ID" (например, UF_CRM_TASK для связи задачи со сделкой); - Выберите шаблон БП для целевой сущности. Важно: Если в запускаемом БП создан параметр с кодовым именем start_id, в него передаётся ID сущности, в которой сработало событие.
Поле "Участники группы/проекта"	Для сущности "Рабочие группы" доступно специальное поле фильтра. При его заполнении выполняется дополнительный запрос к API для проверки, входит ли указанный пользователь в состав участников группы. Поддерживаются форматы: ID пользователя (123), user_123, user-123, JSON-массив ID. Как использовать: - Выберите сущность "Рабочие группы" и событие (При добавлении или При редактировании); - В поле "Участники группы/проекта" укажите ID пользователя или user_123; - БП запустится только если указанный пользователь является участником группы. Операторы: = или @ — пользователь должен быть участником; != или !@ — пользователь не должен быть участником.
Комментарий к шаблону	Позволяет добавить заметки к шаблону для удобства. Комментарий не участвует в логике запуска и отображается в списке шаблонов. Как использовать: - Заполните поле "Комментарий" в форме создания или редактирования шаблона; - Текст будет виден в таблице шаблонов.
Активация и деактивация шаблона	Позволяет временно отключить шаблон без его удаления. Деактивированный шаблон не подписывается на событие и не запускает БП. Как использовать: - При создании или редактировании выберите "Неактивен" в поле "Активность сценария"; - Для повторной активации выберите "Активен".
История запусков	Система сохраняет историю запусков бизнес-процессов: дату, сущность, результат. Статус шаблона обновляется после каждого срабатывания (успешно запустилось, завершено с ошибкой). Статусы: Сохранено (0), Успешно запустилось (1), Завершено с ошибкой (2), Автозапуск выключен (3).

Модуль поддерживает следующие типы сущностей: Лид, Сделка, Компания, Контакт, Счёт, Коммерческое предложение, Смарт-процессы, Дело (активность), Задача, Товар, Реквизит, Банковский реквизит, Документ генератора, Тип смарт-процесса, Комментарий в таймлайн, Валюта, Единица измерения, Адресный реквизит, Календарь, Бронирование ресурсов, Лента новостей, Рабочие группы. Для каждой сущности доступны события добавления, изменения и удаления (в зависимости от типа).

Оператор	Описание
=	Равно, точное совпадение (по умолчанию)
!=, !	Не равно
>=, >, <=, <	Сравнение для числовых значений и дат
@	IN — значение входит в массив (значение передаётся как JSON-массив)
!@	NOT IN — значение не входит в массив
%	LIKE — поиск подстроки в любой позиции
=%	LIKE с явным %: мол% (начинается с), %мол (заканчивается на), %мол% (содержит)
!%, !%=	NOT LIKE — значение не содержит подстроку

Описание примера	Решение
Запуск БП при добавлении любой сделки	Создайте шаблон: тип сущности "Сделка", событие "При добавлении сделки", выберите нужный шаблон БП. Фильтр оставьте пустым — БП запустится для каждой новой сделки.
Запуск БП только для сделок в определённой стадии	Создайте шаблон для сущности "Сделка", событие "При изменении сделки". В фильтре укажите поле STAGE_ID со значением, например, C1:WON (для стадии "Успешно реализовано") или используйте оператор @ для нескольких стадий: @STAGE_ID со значением ["C1:NEW","C1:PREPARATION"].
Запуск БП при добавлении задачи определённому исполнителю	Создайте шаблон: тип сущности "Задача", событие "При добавлении задачи". В фильтре укажите RESPONSIBLE_ID=user_123 (подставьте ID нужного пользователя). БП запустится только для задач, назначенных этому пользователю.
Запуск БП при добавлении участника в рабочую группу	Создайте шаблон: тип сущности "Рабочие группы", событие "При редактировании рабочей группы". В поле "Участники группы/проекта" укажите user_5. БП запустится только если пользователь с ID 5 является участником изменённой группы.
Запуск БП по сделке при создании задачи	Создайте шаблон: тип сущности "Задача", событие "При добавлении задачи". В блоке "Запустить БП в другой сущности" выберите тип "Сделка", в поле "Поле, из которого брать ID" укажите UF_CRM_TASK (или другое поле связи задачи со сделкой). Выберите шаблон БП для сделок. БП запустится в связанной сделке.
Запуск БП только для лидов с определённым источником	Создайте шаблон: тип сущности "Лид", событие "При добавлении лида". В фильтре укажите SOURCE_ID=WEB (или другой код источника). БП запустится только для лидов с указанным источником.
Запуск БП при добавлении события в календарь	Создайте шаблон: тип сущности "Календарь", событие "При добавлении события календаря", выберите шаблон БП. При создании события в календаре БП будет запущен автоматически.
Запуск БП для сделок с суммой больше 100000	Создайте шаблон для сущности "Сделка", событие "При изменении сделки". В фильтре укажите >=OPPORTUNITY со значением 100000. БП запустится только при изменении сделок с суммой от 100000.
Запуск БП для дел (активностей) определённого типа	Создайте шаблон: тип сущности "Дело (активность)", событие "При добавлении дела". В фильтре укажите TYPE_ID=2 (звонок) или другой код типа. БП запустится только для дел указанного типа.
Временное отключение шаблона без удаления	Откройте шаблон на редактирование и выберите "Неактивен" в поле "Активность сценария". Шаблон перестанет срабатывать, но сохранится. Для возобновления выберите "Активен".

Модуль "Запуск БП по событию" предназначен для использования в веб-интерфейсе и может быть полезен в следующих сценариях:

• Автоматизация бизнес-процессов при создании или изменении сущностей CRM;
• Запуск БП только при выполнении условий (стадия сделки, ответственный, сумма и др.);
• Связывание событий в одной сущности с БП в другой (задача — сделка);
• Фильтрация по участникам рабочих групп при событиях с группами;
• Обработка событий календаря, ленты новостей, задач;
• Условный запуск БП по смарт-процессам с учётом типа и воронки;
• Массовая автоматизация без создания триггеров в каждом БП отдельно;
• Централизованное управление автозапуском через единый интерфейс;
• Отслеживание истории запусков и статусов шаблонов;
• Быстрое включение и отключение сценариев без изменения шаблонов БП.

Название поля	Описание и примеры использования
Активность сценария	Активен — шаблон подписан на событие и срабатывает. Неактивен — шаблон не срабатывает.
Тип сущности	Сущность Битрикс24, события которой отслеживаются: Сделка, Задача, Рабочие группы, Календарь и др.
Тип события	Конкретное событие: При добавлении, При изменении, При удалении. Список зависит от типа сущности.
Шаблон БП	Шаблон бизнес-процесса, который будет запущен при срабатывании события и прохождении фильтра.
Условия запуска БП	Поля фильтра с операторами. Пустой фильтр означает запуск при любых данных сущности.
Тип сущности для запуска	Необязательно. Если указан — БП запускается в другой сущности. Например, при событии по задаче запуск БП по сделке.
Поле, из которого брать ID	Код поля сущности события, содержащего ID целевой сущности. Например, UF_CRM_TASK для связи задачи со сделкой.
Комментарий	Заметки пользователя, не участвуют в логике. Отображаются в списке шаблонов.