Підстановка промокоду з використанням API

Email

Омніканальність

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

Підстановка промокоду з використанням API

У такий спосіб можна надсилати промокоди в тригерних листах.

Є два основних способи відправлення листів через API:

Із використанням сценарію

Напряму (без використання сценарію)

Метод 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').

Змінна 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