Отправляйте электронные письма через собственную учетную запись Mailgun

Подключите собственный аккаунт Mailgun: добавление поддомена для отправки, записей SPF, DKIM и MX для публикации, ключа отправки вместо вашего секретного API-ключа, а также причины, по которой размещенный в EU аккаунт возвращает ошибку 401 при запросе к хосту в US.

Вам потребуется учетная запись Mailgun и доступ к DNS вашего домена.

Официальная документация Mailgun: Добавление и подтверждение домена · Ключи API · Регистрация

1. Добавьте свой домен для отправки в Mailgun

В панели управления Mailgun перейдите в раздел Send → Domains → Add New Domain (Отправка → Домены → Добавить новый домен) и введите поддомен, например mail.yourdomain.com.

⚠️ Собственные рекомендации Mailgun предполагают использование поддомена, и здесь это важно как ни у какого другого провайдера: Mailgun устанавливает собственные записи SPF и DKIM для всего, что вы ему предоставите, и указание на ваш корневой домен означает, что эти записи окажутся рядом с теми, на которые опираются ваши бизнес-почтовые ящики.

Выберите регион, соответствующий месту хранения ваших данных — US или EU. Запишите его; он понадобится вам на шаге 4, и это самая распространенная ошибка.

2. Опубликуйте DNS-записи, предоставленные Mailgun

Mailgun покажет вам список. Добавьте каждую из них у своего провайдера DNS.

| Тип | Хост | Назначение | | --- | --- | --- | | TXT | mail.yourdomain.com | SPF — v=spf1 include:mailgun.org ~all | | TXT | mailo._domainkey.mail.yourdomain.com | Открытый ключ DKIM | | CNAME | email.mail.yourdomain.com | Отслеживание и обработка возвратов | | MX | mail.yourdomain.com | Получение возвратов (два хоста MX Mailgun) |

⛔ Если для вашего поддомена отправки уже существует запись SPF, отредактируйте ее — не добавляйте вторую. Домен с двумя записями SPF TXT полностью не проходит проверку SPF, что хуже, чем полное их отсутствие.

Затем нажмите Verify DNS Settings (Проверить настройки DNS) в Mailgun. Переход в зеленый статус может занять до часа.

⭐ Добавьте MX-записи, даже если вы только отправляете почту. С их помощью Mailgun собирает возвраты (bounces). Без них неверный адрес возвращается в никуда, Mailgun не может заблокировать его, и вы продолжаете платить за отправку на адрес, который ничего не получит.

3. Получите ключ API

Send → Sending → Domain settings → API keys (Отправка → Отправка → Настройки домена → Ключи API) или страница API Keys (Ключи API) вашей учетной записи.

Используйте ключ отправки (sending key), привязанный к этому домену, если ваш тарифный план предоставляет его, а не личный ключ API вашей учетной записи. Ключ отправки может только отправлять; личный ключ может читать ваши логи и изменять вашу учетную запись. У нас нет причин хранить второй.

4. Подключите его в Zinn®

Откройте Email sending (Отправка электронной почты) в своей панели управления и заполните:

Provider (Провайдер) — Mailgun
Send from this domain (Отправлять с этого домена) — mail.yourdomain.com (домен, а не адрес)
Mailgun sending domain (Домен отправки Mailgun) — тот же домен, который вы добавили в Mailgun
Region (Регион) — us или eu, в соответствии с шагом 1
Mailgun API key (Ключ API Mailgun) — ключ из шага 3

⛔⛔ Укажите правильный регион. Учетные записи Mailgun, размещенные в EU, обслуживаются совершенно другим хостом API. Отправка ключа учетной записи EU на хост US возвращает ошибку "401 Unauthorized" — что выглядит точно так же, как неверный ключ. Если ваш ключ определенно правильный и вы получаете 401, почти всегда дело именно в этом.

5. Отправьте тестовое сообщение и введите код

Нажмите Send test message (Отправить тестовое сообщение), используя почтовый ящик в другом домене — адрес Gmail подойдет идеально. Прочитайте код из этого почтового ящика и введите его. Ваша почта переключается немедленно.

Если это не работает

401 Unauthorized — неверный регион (см. выше) или вы вставили ключ из другой учетной записи Mailgun. Пересоздайте ключ, а не перепечатывайте его; префикс key- легко потерять.

Тестовое сообщение не приходит — проверьте страницу Logs (Логи) в Mailgun. Если в Mailgun нет никаких записей о нем, учетные данные или имя домена указаны неверно. Если Mailgun принял его и после этого произошел сбой, причина будет указана там понятным языком, и почти всегда это связано с DNS.

"Domain not found" (Домен не найден) — поле Mailgun sending domain (Домен отправки Mailgun) должно точно совпадать с доменом в том виде, в каком он указан в Mailgun, включая поддомен. yourdomain.com и mail.yourdomain.com для Mailgun — это два разных домена.

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