Произвольные триггеры

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

Для каждого заказа произвольный триггер для мессенджеров может срабатывать только один раз. Сделано для защиты от переспама конечных покупателей.

Для настройки триггера необходимо создать его, указать условие для его срабатывания, ввести содержимое уведомления и выбрать задержку отправки сообщения.

При указании ссылки на сайт рекомендуем использовать переменную {{account.url}}. Другие переменные могут не использовать https в адресе сайта и браузер отобразит предупреждение о переходе на небезопасный сайт.

Создание триггера

1. Перейдите в Диалоги → Шаблоны и нажмите кнопку "Добавить" в разделе "Произвольные триггеры".

2. Укажите название триггера. Оно может быть любым, например, в названии можно отразить, по каким условиям будет отправлен триггер.

Настройка условия отправки

1. С помощью шаблонизатора Liquid опишите, при каких условиях будет срабатывать триггер.

2. Для инициации триггера используйте метод {{ send_message }}.

Поддерживаются циклы, условия, группы переменных ORDER, CLIENT и ACCOUNT.

Примеры условий отправки

{% if change_set['Трек-номер Почта России'].appeared? %}
{{ send_message }}
{% endif %}

{% if change_set['реквизиты'].changed? %} {{ send_message }} {% endif %}

{% if order.fulfillment_status == 'delivered' and order.paid? %}
	{{ send_message }}
{% endif %}

Если возникают трудности с использованием шаблонизатора Liquid, то обратитесь в техническую поддержку за помощью по составлению условий отправки.

Настройка задержки отправки сообщений

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

Доступно два варианта:

• Сразу после выполнения условий — сообщение будет отправлено моментально.
• Через промежуток времени — система добавит сообщение в очередь отправки сразу после того, как заказ начнет соответствовать условиям. Когда наступит время отправки, система еще раз проверит, соответствует ли заказ условиям отправки. И если заказ за промежуток времени не перестал соответствовать условиям отправки, отправит сообщение.

Настройка шаблона уведомления

Заполните шаблон содержимого отправляемого сообщения.

Описание полей аналогично полям при создании шаблонов по статусам заказов.

Если возникают трудности с использованием шаблонизатора Liquid, то можно обратиться в техническую поддержку за помощью по составлению условий отправки.

Практические примеры триггерных сообщений

{% if change_set['Трек-номер Почты России'].appeared? %}
      {{ send_message }}
{% endif %}

Трек-номер вашего заказа {{ order.all_fields['Трек-номер Почта России'].value }}
Отследить заказ: https://www.pochta.ru/tRACKING
Интернет-магазин {{ account.main_host }}

{% if order.fulfillment_status == 'delivered' and order.paid? %}
{{ send_message }}
{% endif %}

{{ order.client.name }}, добрый день!
Вчера вы получили заказ №{{ order.number }} из нашего интернет-магазина.
Будем благодарны за честный отзыв на Яндекс.Маркете: https://vk.cc/abc1Gb 
После публикации отзыва мы зачислим на ваш телефон {{ order.client.phone }} 200 рублей.
Магазин {{ account.main_host }}

{% if order.fulfillment_status == 'delivered' and order.paid? %}
{{ send_message }}
{% endif %}

{{ order.client.name }}, добрый день!
2 недели назад вы оформляли заказ №{{ order.number }} в нашем интернет-магазине.
Мы ждем Вас снова и дарим промо-код на следующую покупку со скидкой 20%
Промо-код: *sale20*
Магазин {{ account.main_host }}

{% if order.payment_title == 'Банковской картой' and order.paid? == false %}
{{ send_message }}
{% endif %}

{{ order.client.name }}, добрый день!
Заказ №{{ order.number }} будет отправлен после оплаты.
Ссылка для оплаты {{ order.pay_url }}
Магазин {{ account.main_host }}

Подробнее о работе с change_set

change_set показывает, что изменилось в заказе в момент постановки триггера. 

Стандартная конструкция, в которой используется change_set:

{% if change_set["order.fulfillment_status"].changed? %}
{{ send_message }}
{% endif %}

где:

• changed? - проверка изменения данных, хранящихся в переменной;
• order.fulfillment_status - переменная, содержащая статус заказа (можно использовать любые Liquid переменные из групп ORDER, CLIENT и ACCOUNT);
• {{ send_message }} - команда отправки содержимого сообщения.

Как использовать переменные

Переменные указываются в квадратных скобках перед проверкой. 

• Верно: `change_set["order.fulfillment_status"].changed?`.
• Неверно: `change_set.order.fulfillment_status`.

Если переменной нет, то проверка не происходит, `changed?` будет содержать значение "false".

Проверки

• `changed?` — отличается ли старое значение от нового;
• `appeared?` — раньше поле было пустое, есть ли теперь значение?

Старое и новое значение переменной из `change_set` прочитать нельзя.