Подстановка промокода с использованием 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
}

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

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