Использование 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.

Создание сообщения

1. Перейдите в Сообщения > Сообщения и откройте или создайте email.

2.Используйте velocity, чтобы добавить динамические переменные в блоки, где должны подставляться персонализированные данные.

Так будет выглядеть готовое письмо, которое вместо текста содержит название переменных. Например, вместо Иванов Сергей вы подставляете название переменных из заказа, которые содержат фамилию lastName и имя firstName.

3.Чтобы отметить начало и конец блока кода с динамическим содержимым, кликните по структуре с переменными. Откройте редактор кода и добавьте #foreach($item in $!data.get('items')) и #end в начале и конце блока соответственно.

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

Для удобства создания и тестирования письма в редакторе есть специальная функция, позволяющая подставить динамические данные и сразу, без отправки, увидеть результат. Доступна она в редакторе по щелчку на пункт Настройка динамического контента.

В открывшемся окне в текстовое поле надо вставить JSON-данные по заказу. И нажать “Просмотр сообщения”.

Эти данные не надо набирать вручную Можно взять их из любого переданного в систему заказа. Для этого зайдите в Триггеры → strong>Заказы.

В таблице заказов щелкните на ID любого заказа.

Откроется окно с данными по заказу. Используйте эти данные в окне редактора сообщений.

После вставки данных по заказу в редакторе вы увидите как будет выглядеть ваше письмо с подставленными данными.

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