×

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

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

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

Метод updateEmailTemplate

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

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

Синтаксис и URL для вызова метода
updateEmailTemplate (int template_id [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/updateEmailTemplate?format=json&api_key=
KEY&template_id=ID&title=TITLE&subject=SUBJECT&body=
HTMLBODY&lang=LANG&message_format
=FORMAT&text_body=TEXTBODY&raw_body=JSONBODYSTRUCTURE&description
=DESCRIPTION
Аргументы
api_key *Ключ доступа к API.
template_id *Идентификатор шаблона, может быть получен в результате вызова метода createEmailTemplate, getTemplate, getTemplates, listTemplates.
titleНазвание шаблона.
descriptionТекстовое описание шаблона, которое в дальнейшем можно будет получить при вызове этого шаблона.
subjectСтрока с темой письма. Может включать поля подстановки.
bodyТекст шаблона письма в формате HTML с возможностью добавлять поля подстановки.

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

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-структуру, в противном случае не будет передан.
Возвращаемое значение
Пример возвращаемого значения при успешном обновлении шаблона:

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

При ошибке:

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