¶ Настройка триггера
Как устроен диалог редактирования триггера, вкладки, действия, группы и фильтры в справочнике. Перед настройкой убедитесь, что работает служба event-service.
¶ Настройки триггеров
В диалоге редактирования триггера есть 6 вкладок. При создании триггера доступны первые 5 вкладок, действия доступны только после нажатия Сохранить.
¶ Основные настройки
- Название - Просто название триггера чтобы его можно было легко отличить от остальных
- Условие - Условие срабатывания триггера. Настраивается на двух отдельных вкладках в диалоге редактирования триггера. На вкладке "Основные настройки" выбирается тип и подтип условия. Если у типа условия есть дополнительные настройки, то их можно изменить на другой вкладке диалога "Условие триггера". Типы условий сгруппированы в подгруппы связанные по смыслу чтобы нужное условие можно было легче найти.
- Отмена события - Данное свойство определяет разрешена ли автоматическая отмена события. Подробнее см. Автоматическая отмена событий.
- Описание - Произвольное описание триггера
- Порядок - Определяет порядок сортировки триггеров в справочнике "Триггеры"
- Активно - Активен ли данный триггер. Если триггер не активен, то при срабатывании условия триггера событие триггера не будет создано и соответственно никакие действия выполнены не будут.
¶ Условие триггера
Содержимое данной вкладки зависит от выбранного типа триггера. На этой вкладке всегда есть короткое описание условия срабатывания триггера. Если у выбранного типа условия триггера есть дополнительных настройки, то они будут расположены на этой вкладке. Например, у типа условия "При внесении депозита" можно настроить минимальную сумму при которой сработает триггер и типы оплаты при которых сработает триггер.
¶ Параметры отбора
На данной вкладке можно настроить фильтры которые определяют к каким из клиентов применим данный триггер.
¶ Время срабатывания
На данной вкладке можно ограничить по времени когда можно обработать событие триггера или добавить задержку для обработки события триггера. Все параметры на данной вкладке опциональны. На данной вкладке есть следующие параметры:
- Задержка выполнения - С помощью этого параметра можно отсрочить выполнение триггера. Например если указана задержка выполнения два дня, то при срабатывании триггера событие триггера будет обработано не сразу, а через два дня после срабатывания триггера. Пока событие не будет обработано сервисом никакие действия также не будут запланированы и выполнены. Например если нужно послать клиенту сообщение по смс через 2 месяца после создания анкеты, то можно создать триггер с условием создание анкеты и указать задержку срабатывания 2 месяца.
- Ограничение по давности - Позволяет указать срок давности у триггера. Если у триггера указан срок давности 1 день и за этот день событие триггера не было обработано (Может быть сервис триггеров был выключен в это время), то истечения после этого срока это событие не уже не будет обработано, а будет просто удалено.
- Ограничение по времени исполнения - Указывает временной промежуток когда разрешено обрабатывать события триггера.
- Ограничение по периоду исполнения - Указывает промежуток дат когда разрешено обрабатывать события триггера.
- Ограничить дни недели - Указывает дни недели когда разрешено обрабатывать события триггера
¶ Действия
На данной вкладке можно создать действия которые будут выполнены при срабатывании триггера.
Редактирование данной вкладке возможно только если триггер сохранен.
¶ Настройки действия
Диалоги настроек действия различаются для всех типов действий, но у всех типов действий есть общий диалог настроек при нажатии на кнопку "Свойства действия".
Вкладка "Основные настройки" содержит настройки следующих параметров:
- Отмена действия - Данное свойство определяет разрешена ли автоматическая отмена действия. Подробнее см. Автоматическая отмена событий.
- Описание - Произвольное описание действия
- Порядок - Определяет порядок сортировки действия на вкладке "Действия" в настройках триггера.
- Активно - Активно ли данное действие. Если действие не активно, то при обработке события триггера выполнение этого действия не будет запланировано и выполнено.
Вкладка "Время срабатывания"
На данной вкладке можно ограничить по времени когда действие может быть выполнено или добавить задержку для выполнения действия. Все параметры на данной вкладке опциональны. Параметры на этой вкладке работают также как и параметры на аналогичной вкладке в настройках триггера.
¶ Возможные действия
- Создать задачу
Данное действие создает задачу при срабатывании триггера. Почти все настройки аналогичны настройкам обычного шаблона задачи и любой шаблон задачи может быть привязан к триггеру и конвертирован в действие. У действия создания задачи в отличие от шаблона задачи недоступна вкладка "Параметры отбора", так как аналогичные фильтры есть в настройках триггера к которому привязано действие. В тексте задачи можно использовать включенные в триггере маркеры. - Создать рассылку
Данное действие создает рассылку при срабатывании триггера. Рассылка может быть смс, e-mail, на настроенного оператора рассылок (WA, TG), пуш в мобильном приложении. Почти все настройки аналогичны настройкам обычного шаблона рассылок и любой шаблон рассылок может быть привязан к триггеру и конвертирован в действие. У действия создания рассылки в отличие от шаблона задачи недоступна вкладка "Параметры отбора", так как аналогичные фильтры есть в настройках триггера к которому привязано действие. Также в отличие от обычного шаблона рассылок в настройках действия создания рассылки нужно указать тип сообщения. Еще одним отличием от обычных рассылок является то что у действия создания рассылки можно указать кто именно является получателем сообщения. Например получателем сообщения может быть либо сам клиент, либо его менеджер, либо родственник и т.д. Подробнее см. [Получатели](/rukovodstva/administrator/spravochniki/triggery/spravochnik#получатели). В тексте рассылки можно использовать включенные в триггере маркеры. - Создать сообщение
Данное действие создает внутреннее сообщение при срабатывании триггера. Сообщение может быть адресовано либо клиенту либо менеджеру и может быть направлено либо на рецепцию, либо менеджеру. В тексте сообщения можно использовать включенные в триггере маркеры. У сообщения можно также как у рассылки указать кто будет получателем этого сообщения (клиент, менеджер и т.д.). - Создать заметку
Данное действие создает заметку в контракте клиента. В тексте заметки можно использовать включенные в триггере маркеры. - Изменить этап воронки
Данное действие изменяет этап воронки клиента на выбранный этап в настройках действия. - Создать предзапись на ГП
Данное действие создает предзапись на групповую программу. В настройках действия нужно настроить фильтры которые определят на какие из групповых программ можно записать клиента. При срабатывании действия будет выбрана самая первая доступная ГП и на нее будет записан клиент. - Создать предзапись на мероприятие
Данное действие создает предзапись на мероприятие. В настройках действия нужно выбрать мероприятие на которое нужно записать клиента при срабатывании действия. - Начислить бонусы
Данное действие начисляет указанное количество бонусов на бонусный счет клиента. - Установить отметку клиента
Ставит выбранную отметку на анкету или контракт. Если у типа отметки в свойствах включён запрет самостоятельной или любой предзаписи, клиент не сможет записаться на занятие, пока отметка не снята. Используется, в том числе, в сценарии [блокировки записи после пропусков](/rukovodstva/administrator/spravochniki/triggery/primery#блокировка_записи_на_групповые_программы_после_пропусков). - Убрать отметку клиента
Снимает ранее установленную отметку с анкеты или контракта. - Отправить запрос
Отправка HTTP-запроса во внешние системы.
¶ Срабатывание триггеров и выполнение действий
Триггер - набор действий, которые будут выполнены при выполнении какого-то условия. Событие триггера - при срабатывании триггера не сразу выполняются действия. Вместо выполнения действий при срабатывании триггера создается событие связанное с этим триггером. Далее это событие обрабатывается сервисом триггеров. Сервисом планируется выполнение действий связанных с этим событием. Далее сервис выполняет все действия в запланированное время.
В упрощенной форме можно сказать что при срабатывании триггера сразу выполняются связанные действия, но на самом деле срабатывание триггера и выполнение действий работают немного иначе. При срабатывании триггера действия связанные с ним не будут выполнены сразу. Вместо этого будет создано событие связанное с этим триггером. Далее сервис триггеров запланирует обработку этого события. В зависимости от настроек триггера может быть либо запланирована немедленная обработка событий, либо с обработка с задержкой через несколько дней или в определенный день недели. После планировки выполнения событий сервис проверит какие из запланированных событий нужно обработать сейчас. При обработке событий сервис запланирует выполнение действий связанных с триггером. Аналогично может быть запланировано немедленное выполнение действий или с задержкой и ограничениями по времени или дню недели. После обработки запланированных событий и планировки выполнения действий сервис проверит какие из запланированных действий нужно выполнить сейчас и выполнит их. Статус событий и действий можно проверить в мониторе в модуле Администратор. Описание монитора — в разделе Монитор триггеров.
Например, создан триггер с условием "При создании анкеты" и с триггером связано 2 действия: создать задачу и создать рассылку с задержкой 7 дней. При создании анкеты клиента будет создано событие связанное с этим триггером. Сервис триггеров запланирует немедленную обработку события, так как в его настройках нет задержки или ограничений по времени. Сервис немедленно обработает это событие и запланирует 2 действия. Он запланирует немедленное создание задачи и создание рассылки через 7 дней, так как у второго действия есть задержка выполнения. После этого сервис немедленно создаст задачу. Рассылка будет создана сервисом через 7 дней.
¶ Группы и Фильтры
Работа с триггерами и их группами похожа на работу с позициями прайса. Окно триггеров похоже на окно прайса и состоит из трех частей. Слева расположено дерево с группами триггеров, сверху расположен фильтр для поиска триггеров, а справа расположена таблица с самими триггерами. Разница между группами прайса и группами триггеров заключается в том, что использование групп триггеров опционально. То есть, не обязательно создавать группы триггеров если они вам не нужны. Вы не можете создать позицию прайса без группы прайса, но вы можете создать триггер без группы триггеров.
На странице редактирования триггеров всегда отображается только таблица с триггерами, дерево групп триггеров и фильтр по умолчанию скрыты. Для отображения групп триггеров и фильтра добавлены соответствующие две кнопки "Группы" и "Фильтр".
Когда вы открываете справочник "Триггеры", то дерево с группами будет скрыто и в таблице триггеров будут отображаться все существующие триггеры.
При нажатии на кнопку "Группы" слева появится дерево групп триггеров в котором можно выбрать группу триггеров. Если в дереве групп выбрать группу, то в таблице триггеров будут отображены только триггеры, находящиеся в текущей выбранной группе.
При повторном нажатии на кнопку "Группы" дерево групп триггеров будет скрыто и в таблице триггеров снова отобразятся все существующие триггеры. В какой группе будет находится триггер, определяется текущей выбранной группой триггеров в дереве групп при создании триггера. Другими словами, новый триггер будет помещен в текущую выбранную группу триггеров.
Если при создании триггера дерево групп было скрыто, то триггер не будет принадлежать ни к какой группе. В дереве групп для триггеров без группы будет специальная системная группа которая будет называться "Корень (Триггеры без группы)".
У триггеров и групп триггеров есть галочка "Активные", которая позволяет скрыть и отображать неактивные группы и триггеры по желанию. Когда галочка включена будут отображаться только активные группы и триггеры. Когда галочка выключена будут отображаться активные и неактивные группы и триггеры.
Копирование триггеров и групп триггеров. Копирование производится нажатием на соответствующую кнопку "Копировать". При копировании нужно будет выбрать в какую группу триггеров будет помещена копия триггера или группы триггеров. При копировании группы триггеров будут скопированы все подгруппы этой группы и все триггеры, находящиеся в этой группе.
Перемещение групп триггеров и триггеров. Перемещение производится нажатием на соответствующую кнопку "Переместить". При перемещении нужно будет выбрать в какую группу триггеров будет перемещена группа или триггер.
Фильтр по умолчанию скрыт и появляется при нажатии на кнопку "Фильтры". Когда фильтр активен он будет расположен сверху над таблицей с триггерами. Если дерево с группами скрыто, то фильтр производит поиск по всем существующим триггерам. Если же дерево групп отображено, то фильтр ищет только в триггерах принадлежащих к текущей выбранной группе. Доступно 4 фильтра:
- Дата создания триггера
- Название
- Условие
- Тип действия
В дереве триггеров есть галочка "Отображать из подгрупп". Если данная галочка выключена, то при выборе группы в таблице триггеров будут отображаться только триггеры из выбранной подгруппы. Если данная галочка включена, то при выборе группы в таблице триггеров будут отображаться триггеры из выбранной группы и триггеры из всех подгрупп выбранной группы.
Добавлен ряд новых прав для контроля создания групп триггеров. Новые права можно найти в: Менеджер → Настройки → Справочники → Триггеры.
Группы триггеров можно выборочно деактивировать. Если группа триггеров выключена, то все триггеры из данной группы перестанут работать до тех пор, пока группа не активирована снова. Выключение группы распространяется на ее подгруппы. То есть если выключить группу в которой находится подгруппа с триггером, то триггер из подгруппы перестанет работать. Если вы не знаете в какой группе находится триггер вы можете скрыть дерево групп кнопкой "Группы" выбрать триггер в общем списке и нажать снова на кнопку "Группы". При отображении дерева будет автоматически выбрана группа к которой принадлежит выбранный вами триггера.
См. также: Триггеры · Примеры · Настройка · Справочник · Монитор · Справочники администратора