×

Получи 5 готовых email-стратегий для любого бизнеса БЕСПЛАТНО!

После регистрации

меню
Generic selectors
Exact matches only
Search in title
Search in content
Search in posts
Search in pages

Метод createEmailTemplate

Метод для создания шаблона email письма для массовой рассылки. Для редактирования существующего шаблона можно использовать метод updateEmailTemplate.

Принцип использования

Синтаксис и URL для вызова метода
createEmailTemplate (string title, string subject, string body, string lang,
string message_format, string text_body, string raw_body, string description)
https://api.unisender.com/ru/api/createEmailTemplate?format=json&api_key=KEY&title=TITLE&subject=SUBJECT&body=
HTMLBODY&lang=LANG&message_format=FORMAT&text_body=TEXTBODY&raw_body=
RAW&description=DESCRIPTION
Аргументы
api_key * Ключ доступа к API.
title * Название шаблона.
subject * Строка с темой письма. Может включать поля подстановки.
body * Текст шаблона письма в формате HTML с возможностью добавлять поля подстановки.

Если вы передаёте текст HTML целиком, то тестируйте такие письма дополнительно – заголовки вне body могут быть подвергнуты модификациям. Кроме того, чтобы уменьшить расхождение в отображении в различных почтовых программах, мы автоматически добавляем дополнительную разметку в каждое письмо (таблица с невидимыми границами, которая также задаёт шрифт по умолчанию и выравнивание текста по левой границе). Вы можете попросить отключить это для ваших писем, обратившись в техподдержку.

description Текстовое описание шаблона, которое в дальнейшем можно будет получить при вызове этого шаблона.
text_body Текстовый вариант шаблона письма.
lang Двухбуквенный код языка для автоматически добавляемой в каждое письмо строки со ссылкой отписки.

Если не указан, то используется код языка из URL-обращения к API.

Кроме собственно строки со ссылкой отписки, этот язык также влияет на интерфейс страницы отписки. Полностью поддерживаются языки ruit, ua и en, для нескольких других языков (da, de, es, fr, nl, pl, pt, tr) будет переведена строка со ссылкой, а интерфейс управления будет на английском.

message_format Определяет способ создания шаблона: «block» — блочный редактор, «raw_html» — html редактор, text — текст.

  • Если передать в этом параметре значение «text», то в случае, если оба параметра body и text_body будут заполнены, параметр body будет проигнорирован, а шаблон будет создан из данных, переданных в параметре text_body.
  • Если передать в этом параметре значение «block», но не задать raw_body, тогда шаблон будет сохранен как raw_html.
  • Если передать в этом параметре значение «block», для того, чтобы сообщение было сохранено в формате блочного редактора, обязательно должны быть переданы параметры body и raw_body.
raw_body Предназначен для сохранения json структуры структуры данных блочного редактора (при значении message_format=block). Параметр принимает только JSON-структуру, в противном случае не будет передан.
Возвращаемое значение
JSON-объект с полями:

template_id — идентификатор созданного шаблона;

warnings — массив, содержащий поля warning — предупреждения (если они были).

Пример возвращаемого значения при успешном создании шаблона:

{
  "result":{
    "template_id": 1234567890
  },
  "warnings":[
    {"warning":"some warning text, if applicable"}
  ]
}

При ошибке:

{"error":"error message", "code":"error code"}