Инструкция

Отправка транзакционных писем в Mailganer

Через API или SMTP + как отключить проверку ссылки отписки
Транзакционные письма и их особенность
Транзакционные письма — это подтип триггерных писем, считающиеся техническими, а не рекламными.

Главная особенность транзакционного письма — это то, что в них можно не добавлять ссылку отписки, как в обычных рассылках и триггерах. Ведь если он отпишется от служебных писем, то не сможет получать дальнейшие уведомления.
Подробнее о транзакционных письмах читайте в этой статье ›

Как отправлять транзакционное письма в Mailganer

Метод 1: настройка транзакционных триггеров через личный кабинет по АПИ

Для того, чтобы отправить транзакционные письма подписчикам из отдельного списка, используйте API-метод отправки триггера.
Согласно анти-спам политике, отправить API-триггер можно только на имейл подписчика, у которого статус в базе равен «Активен». Но транзакционные письма могут отправляться даже на те имейлы, статус которых в базе равен «Отписался» или «Адресат считает спамом».

Поэтому для корректной работы метода при отправке служебных рассылок нужно использовать в запросе параметры ignore_unsubscribed и ignore_spam.
{
  "email": "test@example.com",
  "phone": "79991112233",
  "ignore_unsubscribed": true,
  "ignore_spam": true
}
Триггер можно отправить на подписчика, который есть в базе. Чтобы не делать вызов метода добавления подписчика, тогда вы можете запросить doi_ok и тогда при отправке триггера провериться наличие его в базе, если подписчика нет — имейл добавится в базу.
{
  "email": "test@example.com",
  "phone": "79991112233",
  "ignore_unsubscribed": true,
  "ignore_spam": true,
  "doi_ok": true,
}

Почему для транзакционных триггеров нужен отдельный список и как убрать проверку ссылки отписки

Обычно в аккаунте работают с одним списком имейлов для своего домена. Все массовые и триггерные рассылки привязываются только к нему.

Технически мы можем убрать проверку ссылок отписки только у списка целиком, а не у конкретных имейлов. Если мы применим эту функцию к основному, где есть другие триггеры и цепочки писем, то отписка пропадёт у них всех. Это будет нарушением прав пользователя.

Поэтому мы рекомендуем создать новый список для транзакционных писем и соответствующие триггеры привязывать к нему. После — написать в поддержку с просьбой отключить у нового списка проверку наличия ссылки отписки. Убедитесь, что нужный список состоит только из транзакционных триггеров.
Метод 2: настройка транзакционных триггеров через SMTP
Второй способ отправлять служебные имейлы — это SMTP. В этом случае вы передаёте данные, минуя личный кабинет и визуальный редактор писем.
В SMTP-отправке нет проверки вёрстки = нет проверки ссылки отписки.
В методах отправки SMTP не предусмотрена проверка наличия переменной {{unsubsсribeUrl}}, поэтому он подходит для отправки служебных писем.

Вёрстка в этом методе не проверяется, ведь для технических сообщений она будет минимальная. В основном вся информация текстовая. Пример запроса:
{
  "email_from": "Domain <from@domain.com>",
  "email_to": "to@domain.com",
  "subject": "Привет {{ user }}",
  "message_text": "<html><img src=\"logo.jpg\"/>Текст сообщения {{ other }} для {% if other == \"шмель\" %}того самого{% else %}вас{% endif %}. Пример с одинарной угловой скобкой &lt; </html>",
  "check_stop_list": true,
  "track_open": true,
  "track_click": true,
  "x_track_id": "bar",
  "track_domain": "click.mydomain.com", // работает, только если передан x_track_id
  "headers": {
      "foo1": "bar1",
      "foo2": "bar2"
  },
  "params": {
     "user": "Вася",
     "other": "шмель" 
  }
}
Какой метод отправки транзакционных писем выбрать
Если вам важна вёрстка и внешний вид служебных сообщений, возможность добавлять другие блоки, а также наличие в этих письмах футера — выбирайте отправку через личный кабинет.

В этом случае программисты один раз настраивают интеграцию, а вёрсткой занимаются уже другие. Этот вариант чаще всего выбирают маркетологи.

Если ваши служебные письма в основном текстовые, и вёрстка вам не критична — выбирайте отправку по SMTP.

В этом случае один раз выбирается какая-то минимальная вёрстка, заносится в запрос и применяется ко всем отправкам. За любыми изменениями вёрстки и обновлением информации в этом варианте придётся идти к программистам.
Вариант отправки через личный кабинет часто выбирают крупные компании, которым важна идентичность бренда во всех коммуникациях.

Например, наши клиенты — «Бизнес Коннект». Их транзакционные письма отправляются с вёрсткой, а подвал в триггерных рассылках сделан с помощью сниппета, который позволяет быстро менять данные в нём при необходимости.
Если вам нужна помощь — напишите на support@mailganer.ru или в онлайн-чате.