Сценарий «Уведомление о задержке доставки»

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

В этой статье — пример настройки сценария, который уведомляет клиента об опоздании доставки и при значительной задержке выдает промокод-извинение.

Что потребуетсяЧто потребуется

• Настроенная интеграция Mindbox с сайтом или внешней системой, которая будет вызывать операцию;
• Согласованный с разработчиками формат вызова API (метод запуска сценария);
• Автоматические рассылки в нужных каналах (email, SMS, мобильный или веб-пуш).

Шаг 1. Настройка операции и переменныхШаг 1. Настройка операции и переменных

Операция — это точка входа, которая определяет, что именно нужно сделать с переданными через API данными. Именно ее вызывает сайт или внешняя система.

1. Создайте новую операцию.

2. Укажите название и доступные точки интеграции (например, веб-сайт магазина).

3. Добавьте шаги:

   • Любой шаг из раздела «Клиенты» (например, «Авторизованный / Неавторизованный — Получить существующего). Выбор зависит от задачи. Подробнее про шаги для создания и редактирования клиента.
   • Действие — Запустить сценарий

   

4. Добавьте переменные операции, которые будут передаваться в вызове API:

   Переменная	Тип	Описание
   Идентификатор заказа	Строковый	Номер заказа, по которому фиксируется опоздание
   Время опоздания	Целочисленный	Величина задержки в минутах
   Новое время доставки	Дата и время UTC	Обновленное время доставки заказа

   Обратите внимание

   Если переменная помечена как необязательная, операцию можно вызвать без нее.

   Если такая переменная используется в шаблоне рассылки и не передана в вызове, отправка остановится. Не подставляйте необязательные переменные в шаблоны рассылок.

5. Скопируйте значения из поля «Параметр шаблонизатора» для каждой переменной — они понадобятся для подстановки данных в тексты рассылок.

   

Шаг 2. Настройка промокодовШаг 2. Настройка промокодов

При опоздании доставки на 60 минут и более в рассылке будет выдаться промокод на следующую покупку.

1. Создайте новый пул промокодов и добавьте промокоды удобным способом по инструкции;
2. Если скидка по промокоду рассчитывается на стороне Mindbox, создайте скидочную или балльную промоакцию.

Шаг 3. Настройка рассылокШаг 3. Настройка рассылок

Добавьте автоматическую рассылку в нужном канале: Email, SMS, мобильный пуш или веб-пуш. Так как это техническое сообщение о статусе заказа, выберите профиль рассылки «Транзакционный».

В тексты подставьте параметры шаблонизатора переменных операции из шага 1.

Опоздание от 15 до 60 минут:

Опоздание от 60 минут и более:

Шаг 4. Настройка сценарияШаг 4. Настройка сценария

Логика сценария:

• Опоздание от 15 до 59 минут — рассылка с извинениями и новым временем доставки;
• Опоздание 60 минут и более — рассылка с извинениями, новым временем доставки и промокодом.

Шаги настройкиШаги настройки

1. В стартовом блоке выберите:

   • Условие запуска — событие «Вызов операции»;
   • Запускающая операция — операция, созданная в шаге 1;
   • При необходимости добавьте дополнительные условия по клиенту или лимит срабатывания сценария.

   Так как клиент должен обязательно получить рассылку о задержке доставки, валидность контакта и подписку на канал рассылки можно не проверять.

   

2. Добавьте первый блок «Условие» на канву:

   • Тип проверки — по переменным операции;
   • Условие — «Время опоздания» в диапазоне от 15 до 59 минут.

   Подробнее об условиях по переменным операции в статье.

   

3. В ветку «Да» добавьте блок «Группа шагов» с отправкой первой рассылки.

   

4. В ветку «Нет» добавьте второй блок «Условие», который будет проверять, что задержка значительная:

   • Тип проверки — по переменным операции;
   • Условие — «Время опоздания» более 60 минут:

   

5. В ветку «Да» добавьте группу шагов с выдачей промокода из пула:

   

6. Так как при выдаче промокода могут быть задержки, добавьте далее блок «Ожидание»:

   

7. Добавьте вторую группу шагов с отправкой рассылки:

   

РезультатРезультат

Тестирование сценарияТестирование сценария

1. Совместно с разработчиком отправьте тестовый вызов операции с заполненными переменными — пример запроса в документации для разработчиков.

   Важно

   Переменная «Новое время доставки» должна передаваться в формате UTC, а не по часовому поясу проекта.

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

3. Повторите проверку для обоих диапазонов задержки.

Дополнительные материалыДополнительные материалы

• Что такое сценарии и как ими пользоваться;
• Метод вызова сценария для разработчиков;
• Как работает событие «Вызов операции»;
• Как работают условия по переменным операции;
• Как протестировать сценарий.