Шаблоны

Использование шаблонов в HaskiMail

Шаблоны позволяют создавать повторно используемый код для ваших писем в HaskiMail. Шаблоны идеально подходят для того, чтобы обернуть ваши письма в повторно используемые стили CSS, хедеры и футеры. Ранее, если ваши письма содержали общие элементы CSS или хедеры и футеры, то код для каждого письма нужно было управлять независимо. С помощью шаблонов ваши счета, приветственные письма и письма для сброса пароля могут использовать общие элементы. Каждый отдельный шаблон будет содержать только контент письма, в то время как повторно используемый контент будет разделяться с выбранным шаблоном. Использование шаблонов Для того чтобы начать работу, HaskiMail предоставляет несколько стартовых шаблонов. Более опытные пользователи могут также создать свой собственный шаблон с нуля. Добавление шаблона Перейдите в один из ваших серверов HaskiMail и выберите Шаблоны. Выберите Шаблоны и затем нажмите «Добавить шаблон». HaskiMail покажет встроенные стартовые шаблоны. Для примера выберем «Welcome». Редактирование шаблонов После добавления шаблона его можно легко отредактировать с помощью редактора HaskiMail. В редакторе вы можете добавить или изменить HTML и CSS, а затем увидеть живой превью. Как и в случае с шаблонами, стартовые шаблоны включают CSS в блоке стилей в заголовке письма, а не внутри контента, как это предпочитают многие почтовые клиенты. HaskiMail автоматически вставит эти стили в саму разметку при доставке письма. Это облегчает редактирование, сохраняя при этом все преимущества и надежность встроенных стилей. Изменение шаблона Хотите быстро отредактировать шаблон? Во время просмотра различных шаблонов можно выбрать шаблон, чтобы открыть его в новом окне и отредактировать. Обновление страницы шаблона позволит вам увидеть изменения в шаблоне при предварительном просмотре.

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

По умолчанию все шаблоны в HaskiMail имеют псевдоним (алиас). Если вы хотите ссылаться на шаблон с помощью псевдонима, а не его идентификатора (Template ID), вы можете задать нужный псевдоним и использовать его в API-запросе для отправки письма с этим шаблоном. Псевдоним шаблона можно выбрать через UI HaskiMail или через API шаблонов. Установка псевдонима через интерфейс HaskiMail - Откройте шаблон, для которого хотите установить псевдоним. - Просматривая шаблон, нажмите на текущий псевдоним. - Измените псевдоним для вашего шаблона, чтобы использовать его для ссылок при отправке (например, welcome_new). Примечание: если вы измените существующий псевдоним, не забудьте обновить ваш интеграционный код, который отправляет письма с использованием этого псевдонима. Установка псевдонима через API шаблонов Чтобы установить псевдоним, отредактируйте шаблон с помощью PUT-запроса к URL https://api.haskimail.ru/templates/{templateIdOrAlias} с псевдонимом, который вы хотите установить, в теле запроса. Пример: { "Name": "Template Name", "Alias": "my-alias" } После того как вы установите псевдоним, вы можете использовать его для отправки письма с этим шаблоном. Вместо поля «TemplateId», используйте поле «TemplateAlias» с вашим псевдонимом. Пример: { "TemplateAlias": "my-alias", "TemplateModel": { "user_name": "John Smith", "company": { "name": "ACME" } }, "From": "sender@example.com", "To": "receiver@example.com" }

Использование стартового шаблона HaskiMail

HaskiMail включает предустановленные шаблоны для распространённых типов транзакционных писем, таких как приветственные письма, уведомления о комментариях, сброс пароля, квитанции и счета, уведомления о завершении пробного периода, приглашения пользователей и другие. С помощью нашего редактора и инструментов у вас есть полный контроль над настройкой каждого шаблона, чтобы он соответствовал вашим точным потребностям. Шаблоны доступны при отправке через API HaskiMail. Выбор шаблона для старта Перейдите в один из своих серверов HaskiMail и выберите Шаблоны. В разделе Шаблоны выберите Добавить шаблон. Редактирование шаблона Если вам нужно внести изменения в шаблон, нажмите на вкладку Редактировать в редакторе. Здесь вы сможете редактировать HTML- и текстовые версии вашего письма. Вы можете заметить, что в стартовых шаблонах HaskiMail CSS находится в блоке style в заголовке письма, а не встроен в контент, как это предпочитают большинство почтовых клиентов. Это связано с тем, что HaskiMail автоматически вставит эти стили в контент письма, когда оно будет отправлено. Это упрощает редактирование, сохраняя все преимущества и надежность встроенных стилей. Отправка тестового письма Как только всё будет выглядеть хорошо, вы захотите увидеть, как ваш шаблон отображается в настоящем почтовом клиенте. Нажмите Отправить тест, чтобы отправить тестовое письмо с текущими тестовыми переменными на выбранный вами адрес. Вы также можете отправить тестовые письма в такие сервисы, как Litmus или Email on Acid, которые позволяют предварительно просматривать ваш шаблон в каждом из основных почтовых клиентов. Мы потрудились над тем, чтобы наши стартовые шаблоны выглядели красиво и были готовы к использованию, но если вы измените шаблон, обязательно отправьте тестовое письмо, чтобы убедиться, что всё выглядит отлично.

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

HaskiMail предоставляет два способа перемещения шаблона с одного сервера на другой: дублирование одного шаблона и отправка всех шаблонов. Дублирование одного шаблона - Перейдите на вкладку "Шаблоны" в вашем сервере HaskiMail. - Нажмите на выпадающее меню рядом с шаблоном, который вы хотите дублировать, и выберите «Копировать». - Введите имя шаблона и выберите сервер, на который вы хотите скопировать шаблон, затем нажмите синюю кнопку «Копировать». - После дублирования у вас будет возможность отредактировать скопированный шаблон или вернуться к исходному шаблону. Использование API шаблонов Шаблоны можно копировать с исходного сервера на другой сервер с помощью API шаблонов. Этот способ полезен для программного поддержания синхронизации шаблонов между несколькими окружениями или для предоставления вашим пользователям возможности синхронизировать изменения шаблонов через ваш собственный интерфейс. При отправке каждый шаблон должен иметь уникальный псевдоним. Например, невозможно отправить макет шаблона с псевдонимом «welcome-email» на сервер, который уже имеет стандартный шаблон с таким же псевдонимом «welcome-email». Метод: PUT Endpoint: https://api.haskimail.ru/templates/push Тело JSON: { SourceServerID: <идентификатор исходного сервера>, DestinationServerID: <идентификатор целевого сервера>, PerformChanges: true } Пример команды curl: curl https://api.haskimail.ru/templates/push \ -X PUT \ -H Accept: application/json \ -H X-HaskiMail-Account-Token: <API токен аккаунта> \ -d {SourceServerID:<идентификатор исходного сервера>, DestinationServerID:<идентификатор целевого сервера>, PerformChanges:true}

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

Как скопировать шаблон с одного сервера на другой? HaskiMail предоставляет два способа перемещения шаблона с одного сервера на другой: дублирование одного шаблона и отправка всех шаблонов. Дублирование одного шаблона - Перейдите на вкладку "Шаблоны" в вашем сервере HaskiMail. - Нажмите на выпадающее меню рядом с шаблоном, который вы хотите дублировать, и выберите «Копировать». - Введите имя шаблона и выберите сервер, на который вы хотите скопировать шаблон, затем нажмите синюю кнопку «Копировать». - После дублирования у вас будет возможность отредактировать скопированный шаблон или вернуться к исходному шаблону. Как скопировать все шаблоны с одного сервера на другой? Использование API шаблонов Шаблоны можно копировать с исходного сервера на другой сервер с помощью API. Используйте этот метод для программного синхронизирования шаблонов между различными окружениями или для предоставления пользователям возможности синхронизировать изменения шаблонов через ваш интерфейс. Метод: PUT Конечная точка: https://api.haskimail.ru/templates/push Тело JSON: { SourceServerID: <идентификатор исходного сервера>, DestinationServerID: <идентификатор целевого сервера>, PerformChanges: true } Пример команды curl: curl https://api.haskimail.ru/templates/push \ -X PUT \ -H Accept: application/json \ -H X-HaskiMail-Account-Token: <API токен аккаунта> \ -d {SourceServerID:<идентификатор исходного сервера>, DestinationServerID:<идентификатор целевого сервера>, PerformChanges:true} Есть ли ограничение на количество шаблонов, которые я могу создать на сервере? Да, на сервере можно создать до 100 шаблонов. Есть ли ограничение на количество шаблонов, которые я могу отправить за раз? Да, вы можете отправить до 100 шаблонов за один раз. Как добавить ссылку для отписки в мой шаблон? Каждое сообщение, отправляемое через маркетинговый канал в HaskiMail, должно содержать ссылку для отписки. Если вы используете шаблоны, вы можете добавить плейсхолдер для отписки в HTML: По умолчанию ссылка для отписки будет содержать текст «Отписаться». Чтобы изменить этот текст, можно обработать плейсхолдер как гиперссылку: <a class="unsub_link" href="%ОТПИСАТЬСЯ%">отписаться</a> Ссылки для отписки, включенные в шаблоны, также будут работать для сообщений, отправленных через каналы транзакционных сообщений, хотя для них это не обязательно. Ознакомьтесь с нашим руководством о том, как добавить ссылки для отписки в ваши шаблоны. Как задать тему при отправке с использованием шаблона? Вы можете задать переменные в теме вашего шаблона, чтобы она была динамичной. Тему можно задать как статичную для всех писем или сделать её динамичной с помощью переменных шаблона. Вы не можете задать поле Тема в JSON для отправки письма напрямую, как это можно сделать при отправке без шаблона. Пример динамичной темы: Допустим, вы задали тему в шаблоне как «Screen-Shot-2018−02−20-at-1−18−15-PM.png». Затем вы можете передать значения переменных, такие как product_name и name, чтобы они отобразились в теме письма. Ошибка 1122 Проверьте, есть ли у вас тег в вашего шаблона HTML. Это не поддерживается и вызовет ошибку. Могу ли я отправить несколько писем с помощью API с использованием шаблона? Да, вы можете отправить массив сообщений с использованием шаблонов через конечную точку /email/batchWithTemplates для нескольких писем. Могу ли я использовать HASKIMAIL_API_TEST для тестирования отправки с шаблоном? Этот тестовый токен (HASKIMAIL_API_TEST) не работает с API-эндпоинтом для отправки с шаблоном.