Подстановка промокода с использованием API

Отслеживание событий и поведения

Email

Омниканальность

Автоматизация

Подстановка промокода с использованием API

Этим сопособом можно отправлять промокоды в триггерных письмах.

Есть 2 общих способа отправки писем по API:

  • С использованием сценария (ресурс Generate event)
  • Напрямую, без использования сценария (ресурс Send prepared message)

Ресурс Generate event

С помощью данного ресурса вы можете создать и передать в систему какое-то свое событие. Событие запустит сценарий, который выполнить запрограммированные в нем действия, например, отправит письмо или SMS.

Процесс выглядит следующим образом:

  1. Передача данных в систему с помощью Generate event (при этом создается событие).
  2. Создание сообщения для отправки.
  3. Создание сценария.

1. Передача событий в систему с помощью Generate event

Вам надо настроить отправку запросов Generate event по API в eSputnik. В параметрах каждого события надо передавать как минимум email или номер телефона (для SMS) и промокод. Пример.

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

Параметры события

За промокод отвечают следующие элементы:

  • name - promocode
  • value - ABC-123 (сам промокод)

2. Создание сообщения для отправки

В сообщение необходимо вставить название переменной, которая содержит промокод.

Если вы назвали переменную promocode, то в письмо вставляете $!data.get('promocode').

Добавление названия переменной с промокодом

3. Создание сценария

Сценарий в таком случае будет выглядеть следующим образом:

Создание сценария с промокодом

В параметрах выбираете сообщение, которое вы хотите отправить. Также надо указать параметр из события, в котором содержится email-адрес. Больше ничего настраивать не нужно. В данном примере используется блок Email. Если хотите отправить SMS - используйте блок SMS и укажите в настрйоках параметр, содержащий номер телефона.

Send prepared message

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

Для каждого контакта можно передать отдельный промокод.

Вам надо настроить передачу запросов ресурсом API Send prepared message. Формат тела запроса для этого ресурса:

{
    "recipients": [{
        "locator": "mail@example.com",
        "jsonParam": "{\"promocode\":\"ABC-123\"}"
    }],
    "email": true
}

Здесь recipients - массив с получателями. В каждом его элементе есть параметр jsonParam. Его можно использовать для передачи любых данных (например, промокода) в сообщение. В этом параметре данные для сообщения должны быть в формате JSON, но преобразованные в строку.

Для отправки сообщения таким ресурсом вы должны предварительно его создать. В нем обязательно должна быть переменная, которая подставит промокод. Для данного примера это $!data.get('promocode').

В запросе вместо {id} вставляете id сообщения, которое вы хотите отправить.

/v1/message/{id}/smartsend

Остались вопросы?
Специалисты обязательно ответят и помогут решить вашу проблему!
Обратный звонок
Оставьте заявку – и наш специалист свяжется с вами в рабочее время.
Отправить заявку
Консультация в чате
Готовы к вашим вопросам!
Написать в чат
Электронная почта
Напишите в службу поддержки eSputnik.
Отправить email