Часто задаваемые вопросы по шаблонам

Сергей

Сергей

Обновлено Nov 5, 2026

Как скопировать шаблон на другой сервер?

Один шаблон можно скопировать в интерфейсе: на вкладке Шаблоны откройте меню рядом с шаблоном, выберите Копировать и укажите сервер.

Меню шаблона на вкладке «Шаблоны»: пункт «Копировать»

Все шаблоны сервера можно перенести через API методом PUT /templates/push. Учтите, что этот метод переносит шаблоны, а не копирует: на исходном сервере их не останется. Подробнее — в статье «Как перенести шаблоны на другой сервер».

Сколько шаблонов можно создать на сервере?

До 100 шаблонов на одном сервере.

Как добавить ссылку для отписки в шаблон?

В письмах из каналов массовых рассылок ссылка для отписки обязательна. Добавьте в HTML шаблона плейсхолдер %ОТПИСАТЬСЯ% в адрес ссылки:

<a class="unsub_link" href="%ОТПИСАТЬСЯ%">Отписаться</a>

В транзакционных письмах ссылка отписки тоже работает, но там она необязательна. Подробнее — в статье «Ссылка отписки».

Как задать тему письма при отправке по шаблону?

По умолчанию тема берётся из шаблона. Её можно заменить для конкретного письма полем Subject в запросе — тогда тема шаблона не используется. Но обычно удобнее оставить тему в шаблоне и менять её переменными. Например, если тема шаблона — {{name}}, ваш заказ {{order}} отправлен, а в запросе передано:

"TemplateModel": { "{{name}}": "Иван", "{{order}}": "1042" }

то получатель увидит тему «Иван, ваш заказ 1042 отправлен».

Ошибка 1122

Проверьте, нет ли в <head> HTML-шаблона тега <link>. Такие теги не поддерживаются и вызывают эту ошибку. Подключайте стили через блок <style>.

Можно ли отправить несколько писем по шаблону одним запросом?

Да, через метод /email/batchWithTemplates — до 500 писем за запрос. Подробнее — в статье «Пакетная отправка писем через API».

Как проверить шаблон перед отправкой?

Используйте метод POST /templates/validate: он покажет, как будет выглядеть письмо, и найдёт переменные без значения, ничего не отправляя. Подробнее — в статье «Проверка шаблона перед отправкой».

Работает ли тестовый ключ HASKIMAIL_API_TEST с шаблонами?

Да, тестовый ключ работает со всеми методами отправки, в том числе /email/withTemplate и /email/batchWithTemplates: API проверит запрос, но письмо не создаст. Он проверяет только сам запрос, а не настройки сервера. Чтобы проверить отправку по шаблонам целиком, используйте сервер «Песочница».