Особенности интеграции с SMTP

При отправке писем через SMTP адреса получателей проходят проверку по стоп-листам.

Стоп-лист — это список имейлов, которые исключаются из всех отправок.
Локальный — невалидные адреса по домену отправителя.
Глобальный — база невалидных адресов отправителей по всем доменам + база плохих имейлов сервиса Mailvalidator.

Ошибка 550 bounced check filter — адрес находится в стоп-листе.

Чтобы не переплачивать за отправку писем на невалидиный адрес — удаляйте такие адреса из собственной базы (списка имейлов).

При получении ошибки 550 bounced check filter в ответе в параметре ttl_date будет указана дата выхода имейла из стоп-листа. Пример:

Время нахождения в стоп-листе зависит от типа бануса. Если имейл находится в стоп-листе без возможности выхода, в ответе будет указано «ttl_date»: «0»

Нужно ли что-то делать с информацией в ttl_date? Обычно — нет. После выхода имейла из стоп-листа он вернётся в список на будущие отправки.

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

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

Важно: при выдаче API-ключа мы учитываем особенности ваших рассылок и по умолчанию включаем/отключаем нужные стоп-листы. Вы получите соответствующий комментарий в сообщении о подключении SMTP.

Если вы используете SMTP для отправки как транзакций, так и регулярных маркетинговых писем, — запросите два API-ключа и разделите отправки.

Для транзакционных писем — выключите глобальный стоп-лист, а для маркетинговых — включите, чтобы не попадать в спам и не навредить репутации домена отправителя.

Параметр template_id — для работы с шаблонами писем, которые хранятся в платформе Mailganer. При отправке в запросе не нужно будет передавать вёрстку письма, а только id шаблона. Удобно выносить шаблоны вовне, если его готовят разные отделы.

Интеграция поддерживает переменные. Для работы необходимо добавить заголовок Mg-Api-Key с API-ключом от Mailganer

Это связано с частыми недоставками на адреса в корпоративных доменах, которая зависит от настроек внутренних спам-фильтров сервера получателей, имейла в return-path и других технических нюансов.

Если вы работаете с B2B, лучше не ждать начала проблем с доставляемостью, а сразу использовать выделенный сендер (сервер с уникальным IP-адресом, с которого отправляются письма) с настройкой «под себя».

Сервера отправки нужно обслуживать. Так как мы никогда не обновляем одновременно все сервера, чтобы уровень доступности сервиса сохранялся на уровне 99,99%, то во время обновлений может разрываться SMTP-соединение или отваливаться API-запрос.

Решение только одно — повторить запрос. На уровне менеджера очередей настраивается правило, что если вы получаете такую-то ошибку, то попробуйте еще раз через таймаут. 5 попыток через такие интервалы: 5, 15, 30, 60, 90 секунд.

Если у вас интеграция через SMTP → скорее всего, вы используете Postfix или Exim, в котором встроена политика повторов для временных ошибок вида 4ХХ.

Если же у вас интеграция по API → нужно озадачиться на старте наличием менеджера очередей, например, Rabbit или Kafka.