Перейти к основному содержимому

Импорт и экспорт шаблона сообщения

Данный функционал позволяет загрузить в платформу или выгрузить на своё устройство шаблон сообщения. Это может быть шаблон как для одного канала, так и для нескольких сразу. Для экспорта и импорта используется файл в формате zip.

Соответствующие кнопки доступны в окне редактирования шаблона в правом верхнем углу:

— импортировать шаблон

— экспортировать шаблон

Импорт шаблона

Чтобы импортировать шаблон в платформу, нажмите на иконку . Далее кликните на область загрузки и выберите файл в формате zip на своём устройстве.

подсказка

О переносе шаблона из стороннего сервиса читайте в этой статье.

Настройте импорт:

  1. Выберите каналы, для которых необходимо импортировать шаблон (Email, SMS, Push).

  2. Разрешите конфликты импорта. Конфликты возникают, если импортируемые данные и данные, которые уже сохранены в платформе, отличаются. В таблице показаны старое и новое значение. Если вы хотите обновить данные, установите галочку в колонке "Заменить".

Нажмите Принять, чтобы запустить процесс импорта.

Структура zip-файла

Для импорта используется файл в формате zip. Архив должен иметь определенную структуру:

<catalog_name>/
<channel_name>/
<fieldname>.<type>
<attach>/
<fileid>/
<filename>
images/
<image_name>
template.json

Описание структуры:

ЭлементПримерОписание
<catalog_name>template_newsletterКорневая директория. Можно использовать произвольное название.
<channel_name>email
sms
push
Директория содержит данные шаблона для определенного канала отправки. Название директории должно соответствовать каналу.

Поддерживается импорт Email, SMS и Push шаблонов.

Информацию о том, какие файлы можно импортировать для каждого канала, вы найдете здесь.
imagesimage_1.pngДиректория для хранения изображений.
template.jsonФайл содержит общие данные о шаблоне (ссылка на динамический JSON контент, дополнительные настройки, фрагменты и части).

Более подробную информация вы найдете ниже.

Пример zip-файла

Базовая структура для email-канала

template_123/
email/
html.html
text.txt
subject.txt
images/
image_1.jpeg
template.json

Полная структура для всех каналов

template_123/
email/
html.html
text.txt
subject.txt
amp.txt
is_amp.txt
is_not_inline.txt
from_email.txt
from_name.txt
replyto_email.txt
replyto_name.txt
attach/
023f-ad8c-4412-9bba-16ac/
attach_file.zip
sms/
sms.txt
add_sms_url_scheme.txt
push/
title.txt
body.txt
click_url.txt
icon.txt
is_rich_push.txt
images/
image_1.jpeg
image_2.jpeg
template.json

Описание полей для каждого канала

Email

ФайлПримерОписание
html.html
<html>Hello, world!</html>
HTML-версия письма
text.txtHello, world!Текстовая версия письма
subject.txtЛучшие новинки 2022Тема письма
amp.txt
<html>Hello, world!</html>
AMP HTML версия письма
is_amp.txtfalseЕсть ли в шаблоне amp-версия
is_not_inline.txttrueНе конвертировать CSS в inline
from_email.txtawesome@example.comEmail отправителя
from_name.txtAwesome BooksИмя отправителя
replyto_email.txtreply_awesome@example.comОбратный Email
replyto_name.txtAwesome Books
attach (директория)023f-ad8c-4412-9bba-16ac/
attach_file.pdf
Директория для хранения прикрепленных файлов.

Содержит дополнительные директории, в каждой из которых хранится отдельный файл.

Дополнительным директориям можно давать произвольные имена.

SMS

ФайлПримерОписание
sms.txtHello, world!Текст сообщения
add_sms_url_scheme.txttrueДобавлять "http://" в ссылки

Push

ФайлПримерОписание
title.txtЛучшие новинки 2022Заголовок уведомления
body.txtHello, world!Текст уведомления
click_url.txthttps://example.com/Ссылка для перехода по клику
icon.txthttps://example.com/images/test.jpgURL-адрес, по которому расположена иконка для уведомления
is_rich_push.txtfalseИспользование rich-версии для push сообщения
<platform>.json
<html>Hello, world!</html>
Данные по шаблону для определенного браузера или ОС (при использовании rich push)

Файл template.json

С помощью файла template.json можно загрузить данные, которые отображаются в блоках "Опции" и "Контент".

Пример template.json

template.json
{
"json_url": "https://altkraft.com/example/RU_content.json",
"suppress_id": 1,
"is_unsub_to_supp": true,
"field_overrides": {
"lead": {
"_fname": "клиент"
}
},
"parts": []
}

Описание полей в template.json

ПолеПримерОбязательныйОписание
json_url"https://altkraft.com/example/content.json"НетURL для динамического JSON-контента
suppress_id1НетИдентификатор стоп-списка
is_unsub_to_supptrueНетДобавлять отписавшихся в прикрепленный стоп-список
field_overrides
{
   "lead": {
      _fname": "клиент"
   }
}
НетЗначения полей, если пустые
parts
[
   {
      "name": "part_1",
      "shortname": "part_1",
      "type": "text",
      "content": ""
   },
   {
      "name": "part_2",
      "shortname": "part_2",
      "type": "text",
      "content": ""
   }
]
НетЧасти шаблона
подсказка

Вы можете экспортировать любой готовый шаблон из своего аккаунта, чтобы получить наглядный пример zip-архива для импорта.