Надсилайте електронні листи через власний обліковий запис Mailgun

Вам знадобиться обліковий запис 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-провайдера.

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

Потім натисніть Verify DNS Settings у Mailgun. Може знадобитися до однієї години, доки статус стане зеленим.

⭐ Додайте записи MX, навіть якщо ви тільки надсилаєте пошту. Саме завдяки їм Mailgun збирає повернення. Без них лист із неправильної адреси повертається в нікуди, Mailgun не може її заблокувати, і ви продовжуватимете платити за надсилання на адресу, яка ніколи нічого не отримає.

3. Отримайте свій ключ API

Send → Sending → Domain settings → API keys, або сторінка API Keys вашого облікового запису.

Використовуйте ключ надсилання (sending key), призначений для цього домену, якщо ваш тарифний план це дозволяє, а не приватний ключ API вашого облікового запису. Ключ надсилання може лише надсилати; приватний ключ може читати ваші журнали та змінювати ваш обліковий запис. Для нас немає жодних підстав зберігати другий.

4. Підключіть його у Zinn®

Відкрийте Email sending на панелі керування та заповніть:

• Provider — Mailgun
• Send from this domain — mail.yourdomain.com (домен, а не адреса)
• Mailgun sending domain — той самий домен, який ви додали в Mailgun
• Region — us або eu, відповідно до кроку 1
• Mailgun API key — ключ із кроку 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 можуть надсилати пошту лише авторизованим одержувачам, тому тестове повідомлення на вашу власну адресу продовжує надходити, тоді як усі листи вашим клієнтам непомітно блокуються.