Використання Velocity у email

Email

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

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

Використання Velocity у email

Дізнайтеся, як створити емейл-шаблон із динамічними змінними.

Для приклада додамо у лист з підтвердженням замовлення динамічні дані. Ви можете створити будь-яке інше повідомлення за допомогою тих самих принципів (див. як персоналізувати email залежно від параметрів профілю контакту).

Для передачі інформації про замовлення необхідно надіслати API запит методом Add orders або Generate event.

Приклад тіла запиту:

{
"orders": [{
"externalOrderId": "100500",
"externalCustomerId": "12345",
"totalCost": 1000,
"status": "INITIALIZED",
"date": "2017-03-08T09:30:00+02:00",
"email": "mail@example.com",
"phone": "380942583691",
"firstName": "John",
"lastName": "Smith",
"currency": "USD",
"shipping": 10,
"discount": 0,
"deliveryMethod": "express",
"paymentMethod": "cash",
"deliveryAddress": "First str. 1",
"items": [{
"externalItemId": "200600",
"name": "Super Device",
"category": "devices",
"quantity": 1,
"cost": 990,
"url": "http://example.com/item/200600",
"imageUrl": "http://example.com/item/200600/image.png",
"description": "High quality"
}]
}]
}

Цей запит містить кілька параметрів замовлення та їх значення, такі як externalItemId, ім'я, кількість, вартість, url, imageUrl тощо.

Щоб показати персоналізовані дані із замовлення в транзакційному повідомленні, додайте назви параметрів у шаблон і задайте правила їх інтерпретації за допомогою змінних velocity.

Створення повідомлення

Для створення листа переходимо до Повідомлень → Повідомлення і натискаємо Створити email

Створення повідомлення з динамічним контентом

Припустимо, треба відправити клієнту повідомлення про здійснене замовлення, вказати спосіб і місце доставки, а також форму оплати.

Для цього підготуємо структуру, в якій розмістимо текстові блоки для назви, вартість товару, блок зображення і виділимо їх роздільниками. Додаючи текстові блоки, доповнимо інформацією про замовлення, щоб вийшов такий шаблон:

Створення шаблону листа для замовлення

 

Потім за допомогою velocity лист необхідно обладнати динамічним контентом.

Так виглядатиме готовий лист, який замість тексту містить назву змінних. Наприклад, замість Іванов Сергій ви підставляєте назви змінних із замовлення, які містять прізвище lastName та ім'я firstName.

Шаблон листа для замовлення з динамічним контентом

Важливий момент!

Якщо ви бажаєте відобразити в листі дані щодо товарів — використовуйте таку конструкцію:

- це початок блоку - кінець блоку

Для цього потрібно виділити структуру, в якій буде розміщено динамічний контент, відкрити редактор коду й додати код, як показано нижче:

Як додати код для виведення масиву із замовлення

У середині цього блоку прописуйте змінні, які містять дані про товари. У нашому прикладі це $!item.get('name') (назва товару) і $!item.get('cost') (вартість товару). Для блоку зображення в ролі посилання на сторінку товару прописуємо $!item.get('url'), для картинки $!item.get('imageUrl') і альтернативний текст $!item.get('name').

Змінна в ролі адреси зображення

Для зручності створення й тестування листа в редакторі є спеціальна функція, яка дозволяє підставити динамічні дані й одразу без відправлення побачити результат. Доступна вона в редакторі за кліком на Три крапки -Налаштування динамічного контенту.

Підстановка json даних для попереднього перегляду

У вікні, що відкриється, у текстове поле треба вставити JSON-дані щодо замовлення. І натиснути "Перегляд повідомлення"

Як вставити JSON-дані щодо замовлення

Ці дані не треба набирати вручну. Можна взяти їх із будь-якого переданого до системи замовлення. Для цього треба зайти до Тригерів → Замовлення.

Розділ замовлень у eSputnik

У таблиці замовлень клікніть на будь-яке замовлення.

Вибір замовлення зі списку замовлень

Відкриється вікно з даними щодо замовлення. Використовуйте ці дані у вікні редактора повідомлень.

Перегляд даних про замовлення

Після того як ви вставите дані щодо замовлення в редакторі, ви побачите, як виглядатиме ваш лист із підставленими даними.

Попередній перегляд підстановки даних

Важливо:

Якщо нічого не відображається, це означає, що в коді динамічного контенту допущено помилку. Якщо все коректно, зберігайте лист і переходьте до створення сценарію.

Для SMS-повідомлень використовуйте такий самий код. Наприклад, номер замовлення можна підставити в повідомлення такою змінною: $!data.get('externalOrderId'), сума заказу $!data.get('totalCost').

Залишилися питання?
Спеціалісти обов'язково нададуть відповідь та допоможуть вирішити вашу проблему!
Зворотний дзвінок
Залишіть заявку – і наш спеціаліст зв'яжеться з вами в робочий час.
Відправити заявку
Консультація в чаті
Готові до ваших запитань!
Написати в чат
Електронна пошта
Напишіть в службу підтримки eSputnik.
Надіслати email