Метод updateEmailTemplate

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

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

Синтаксис и URL для вызова метода

updateEmailTemplate (int template_id [string title, string sender_name, 

string sender_email, string subject, string body, int list_id, string tag, 

int segment_id, 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&sender_name=

FROMNAME&sender_email=FROMMAIL&subject=SUBJECT&body=

HTMLBODY&list_id=X&tag=TAG&segment_id=X&lang=LANG&message_format

=FORMAT&text_body=TEXTBODY&raw_body=JSONBODYSTRUCTURE&description

=DESCRIPTION

Аргументы
api_key * Ключ доступа к API
template_id * Идентификатор шаблона, может быть получен в результате вызова метода createEmailTemplate, getTemplate, getTemplates, listTemplates 
title Название шаблона 
description Текстовое описание шаблона, которое в дальнейшем можно будет получить при вызове этого шаблона
sender_name  Имя отправителя. Произвольная строка, не совпадающая с email адресом (аргумент sender_email)
sender_email  Email адрес отправителя. Этот email должен быть проверен (для этого надо создать вручную хотя бы одно письмо с этим обратным адресом через веб-интерфейс, затем нажать на ссылку «отправьте запрос подтверждения» и перейти по ссылке из письма)
subject  Строка с темой письма. Может включать поля подстановки
body  Текст шаблона письма в формате HTML с возможностью добавлять поля подстановки.

Если вы передаёте текст HTML целиком, то тестируйте такие письма дополнительно – заголовки вне body могут быть подвергнуты модификациям. Кроме того, чтобы уменьшить расхождение в отображении в различных почтовых программах, мы автоматически добавляем дополнительную разметку в каждое письмо (таблица с невидимыми границами, которая также задаёт шрифт по умолчанию и выравнивание текста по левой границе). Вы можете попросить отключить это для ваших писем, обратившись в техподдержку.
list_id  Код списка, для которого по умолчанию создается шаблон. Коды всех списков можно получить с помощью вызова getLists.  
text_body Текстовый вариант шаблона письма.
segment_id Код сегмента, для которого создается шаблон
tag Метка. Если задана, то отправка рассылки письма из шаблона будет производиться не по всему списку, а только по тем адресатам, которым присвоена заданная метка.
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"}