Як відправити транзакційні повідомлення за шаблоном SendPulse
Ви можете надсилати транзакційні листи клієнтам через API зі своєї системи, використовуючи шаблон, створений у SendPulse з динамічним контентом.
Динамічні листи допомагають надіслати кожному клієнту персональну інформацію, наприклад, дані за замовленням на різних етапах, пароль для входу і так далі. Ви вказуєте значення для кожного клієнта у запиті відправки листа, а в шаблон повідомлення додаєте самі змінні.
Докладніше кожен крок розглянемо у цій статті.
Створіть або вибиріть шаблон
Ви можете створити шаблон у сервісі через зручний конструктор шаблонів, пересуваючи елементи, або за допомогою API методу Створення шаблону, передаючи HTML-версію шаблону.
Розберемо створення через особистий обліковий запис в SendPulse. Перейдіть до розділу Розсилки (Email) > Шаблони (Template) і натисніть Додати шаблон (Add a template), щоб створити новий шаблон або відредагуйте готовий із Бібліотеки шаблонів.
Докладніше зі створенням шаблону ви можете ознайомитись у статті Як створити власний шаблон листа.
Вставте змінні користувача
У вибраному шаблоні додайте змінні для формування динамічної частини листа, персоналізованої під кожного одержувача.
Щоб додати змінну, виберіть текстовий елемент шаблону та вставте ім'я змінної у подвійні фігурні дужки, наприклад, {{name}}. Також можна вибрати змінну з панелі редагування тексту.
Щоб додати змінну з зображенням, натисніть <> у текстовому елементі, щоб відкрити режим редагування коду. Додайте тег відображення зображень <img scr="{{image}}"></img>, де image — ім'я змінної, в яку передаватимете посилання на зображення. Ви також можете додати властивості тега, щоб відредагувати зображення.
<p><img src="/{{image}}" width="150" height="150"></p>
Щоб додати клікабельне посилання, введіть <a href= "{{link}}" >текст</a>, (де link — ім'я змінної, в яку передаватимете посилання).
<p><a href="/{{link}}">текст</a></p>Також можете додати змінні до кнопок і, наприклад, відправляти кожному одержувачу його унікальне посилання.
Після завершення редагування натисніть Зберегти (Save).
Відправте повідомлення
Щоб надіслати листа через SMTP, надішліть POST запит за посиланням:
| https://api.sendpulse.com/smtp/emails |
У тіло запиту вставте параметри, що передаються у форматі JSON:
| subject | Тема листа |
| template.id | Ідентифікатор потрібного шаблону, завантаженого в сервіс |
| template.variables | Змінні шаблону, складається з назви змінної, яку вказали в шаблоні і значення змінної, що передається у вигляді {"назва змінної": "значення змінноїй"} |
| from | Масив з ім'ям та адресою відправника у вигляді {"name": "Alex", "email": "user@example.com"} |
| to | Масив одержувачів як [{"email":"user@example.com", "name": "Alex" }] |
Для тестування будемо використовувати програму Postman.
Додаємо посилання запиту до поля URL. Метод запиту вибираємо POST.
У тіло запиту вставляємо параметри, що передаються у форматі JSON.
Ідентифікатор потрібного шаблону template.id можна отримати під час редагування шаблону або за допомогою методу API Отримати список усіх шаблонів в обліковому записі.
Щоб надіслати запит, натисніть Send.
У разі успішного запиту ви отримаєте відповідь true, а на вказану пошту прийде персональний лист.
Також ви можете відправляти тригерні динамічні листи за готовими шаблонами зі змінними: «Переглянуті товари», «Покинутий кошик», «Завершіть замовлення», «Замовлення прийняте», «Замовлення оформлено», «Замовлення надіслано» та «Відгук про покупку». Докладніше з цим ви можете ознайомитись у статті Як створювати динамічні листи за подіями на основі готових шаблонів SendPulse.
Зверніть увагу, що в готовому шаблоні SendPulse, створеному для подій з масивами, потрібно буде прибрати першу частину змінної item. Так, наприклад, {{item.name}} стане просто {{name}}.
Оновлено: 10.01.2024
або