¶ Что такое триггеры и как их создать
Находится в Режиме Управление - Триггеры
Триггеры - это правила автоматизации, согласно которым с заказом или любой другой сущностью при наступлении определенного события происходит какое-то действие. Триггеры могут срабатывать подряд, один за другим, и фактически автоматизировать большую часть рутины.
Чтобы триггер сработал, ему нужно 2 элемента:
- на какое событие реагировать
- какие действия произвести по наступлению этого события
Говоря иначе, вы задаете правило, по которому при наступлении какого-то события, система что-то должна сделать. Например, при обновлении статуса трек-номера в заказе, отправить клиенту смс
Для создания триггера необходимо нажать на кнопку + в правом нижнем углу и заполнить все поля, так как они обязательные. Разберем подробней форму создания триггера. Сначала вам будет предложено выбрать тип события.
Сами события бывают нескольких типов:
- Создан - это когда событием является факт создания чего-то. Например, создан заказ, клиент, товар, склад и т.д.
- Обновлён - это когда событием является факт обновления чего-то. Например, обновлён заказ, клиент, товар, склад и т.д.
- Логистика - это когда плагин логистики обновил статус заказа или если произошла выгрузка заказов через плагин логистики.
- Время - это событие наступления текущего времени. То есть само по себе событие “Время” это просто часы, которые считают текущее время и когда в поле заказа с типом “Дата/время” заданное время совпадает с текущим, то срабатывает триггер.
Например, вы хотите отправить смс по заказу через 2 дня в 15-00. В заказе есть поле с типом “Дата/Время”, там вы ставите дату и время для отправки смс. Затем вы настраиваете триггер по событию Время, и когда наступит та дата и то время, которые вы указали в заказе, то триггер сработает и отправится смс.
Важно, чтобы в поле было не текущее или не прошедшее время, а то, которое ещё не наступило, иначе триггер не сработает.
В заказе может быть несколько полей с типом “Дата/Время”, но в одном триггере можно выбрать только одно. - Напоминание - такой же как и “Время”, только работает по полю “Напоминание” из заказа. Поле с напоминанием в заказе только одно, поэтому выбирать поле для такого события нет необходимости.
После того, как вы выбрали событие, например Создан, открывается более полная форма триггера, в которой уже выбран тип события и его нельзя отредактировать.
В открывшейся форме нужно ввести название триггера, а также настроить фильтр и действия.
Действия - это что должно произойти после наступления события. Это может быть не только действие с заказом, как например перемещение заказа в другой статус, но и запись какой-то информации в заказ, отправка сообщений, начисление мотивации пользователям, отправка вебхука. То есть любому событию можно настроить любое действие. Разберем подробней какие действия бывают
- Действия триггеров - позволяет записывать новое значение в переменную. Эти действия работают только с заказами, Например, можно изменить статус для заказов, изменить данные в полях заказах, в корзине заказа, установить новое напоминание для заказа. С помощью этого действия можно делать массовую смену статусов заказов по таймеру, закрепление заказа за пользователем и т.д..
- Мотивация - с помощью этого действия можно считать и начислять мотивацию пользователям. Напомним, что у каждого пользователя есть свой баланс, который можно увеличить или уменьшить вручную. С помощью действия “Мотивация” этот процесс можно автоматизировать. Например, сделать мотивацию пользователю за продажу конкретного товара. Настроить можно очень гибко: выбрать конкретного пользователя или роль, ввести конкретную сумму или сделать подсчет в зависимости от суммы корзины.
Важно: можно выбрать не конкретного пользователя, а кто выполнил перемещение заказа к примеру (исполнителя действия) или того, кто выбран в поле с типом "пользователь" - Вебхук - это механизм оповещения о происходящих в системе событиях посредством функций обратных вызовов. Принцип работы вебхука заключается в том, что как только какое-либо событие произошло, об этом сразу же отсылается соответствующее уведомление. В настройках этого действия вы можете выбрать URI, куда отсылать вебхук и выбрать тип контента. Ниже в редакторе можно сразу проверить код на ошибки
- Сообщения чата - служит только для настройки автоматической отправки сообщений по созданным плагинам чата и только по заранее созданным шаблонам
Если вы выбрали событие и настроили действия, то ваш триггер готов к работе. Однако есть еще такой важный элемент настройки триггера, как Фильтр.
Фильтр нужен в тех случаях, когда вы хотите, чтобы при наступлении события триггер сначала проверял некоторые условия и лишь потом запускал действия. Например, если действие нужно совершить не со всеми заказами, а только из определенного статуса.
Важно: триггер может совершать несколько действий по одному событию. Например, при обновлении заказа триггер может:
- закрепить заказ за менеджером,
- начислить мотивацию этому же менеджеру,
- совершить отправку смс.
Таких вариаций может быть множество.
Все созданные триггеры отображаются в таблице:
В ней можно увидеть:
- Название триггера - нужно для удобства работы, видно только внутри админки;
- Событие - отображается при каком событии триггер начнет работать;
- Фильтр - отображаются все фильтры, по которым будет проверяться наступившее событие при выполнении триггера. Например, если вам нужны не все заказы, а только из определенного статуса, то это настраивается и отображается в поле “Фильтр”;
- Поле даты/времени - здесь указывается поле с типом “Дата/Время”, по которому будет работать триггер;
- Действия - указано что именно произойдет с заказом, когда наступит событие;
Чтобы понять, когда сработает триггер, всегда обращайтесь к столбцу Событие. Если событие не наступило, то триггер не сработает. А если наступило, но триггер не сработал, то проверьте фильтры, возможно они слишком жесткие и отмели нужные заказы. Для помощи в настройках обращайтесь в нашу техподдержку.
¶ Инструкция по редактору low-code
Напоминаем, что настройку триггеров мы сделаем за вас. От вас нужно только описание задачи. Однако мы все равно создали краткую инструкцию, чтобы вы имели представление о том, как работает наш редактор.
При создании триггера вы увидите такие команды (переменные, сущности, функции, константы). Они есть и при настройке действий, и при настройке фильтров. Как с ними работать?
Важно: наличие всех четырех команд не означает, что для настройки нужно использовать все. Вы можете использовать только то, что нужно для написания вашего выражения.
Переменные - это все поля в заказах. Они могут быть как текущими, так и прошлыми состояниями. Например, можно проверять факт смены статуса, создав выражение “Текущий статус в заказе” не равен (пишется как !=) “Прошлому статусу в заказе”. Или вы можете дописать любое значение в любое поле, создав выражение “Текущий комментарий” + “Тестовый комментарий”.
Сущности - это все сущности, которые есть в нашей системе. При использовании этой команды нужно будет обязательно выбрать конкретную сущность. Например, вы хотите выбрать все заказы, в которых используется плагин логистики Почты России. В таком случае вы выбираете переменную “Плагин логистики”, равен (пишется как ==) сущности “Плагин логистики” и выбираете конкретно “Почта России”.
Функции - это все типы данных.
Константы - это фиксированный список из следующих констант “False”, “True”, “Null”, “Now”. Это нужно для того, чтобы использовать выражения типа “Исполнитель действия пользователь?” == “True” или “Текущее время” == “Now”.
В редакторе выражений доступны следующие операторы:
== означает “равно”;
!= означает “не равно”;
> больше;
>= больше или равно;
< меньше;
<= меньше или равно;
AND (ещё пишется как && ) это логический оператор. Ставится, когда в триггере несколько условий “Статус должен быть таким И проект должен быть таким”, то есть условия строгое;
OR (ещё пишется как || ) ещё один логический оператор, который означает ИЛИ. Ставится, когда в триггере, когда есть несколько условий “Статус должен быть “Обработка” ИЛИ статус должен быть “Перезвонить”.
IN оператор для работы с массивами. С помощью которого можно проверять наличие товаров/акций в корзине или присутствие того или иного статуса логистики в заказе;
+, -, /, * арифметические операторы;
Важно: если вы используете в фильтрах сразу AND и OR, то при построение фильтров нужно знать, что AND будет выполняться раньше, чем OR. Поэтому, если вы хотите, чтобы сначала проверялись условия OR, возьмите это действие в скобки. Например: (Статус заказа равен “Обработка” ИЛИ статус заказа равен “Перезвонить”) И проект равен “Горячие лиды”.