Надсилайте електронні листи через власний обліковий запис 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 у Mailgun. Позеленіння статусу може зайняти до години.

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

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

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

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

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

Відкрийте розділ Надсилання пошти у своїй панелі керування та заповніть поля:

Провайдер — Mailgun
Надсилати з цього домену — mail.yourdomain.com (домен, а не адреса)
Домен надсилання Mailgun — той самий домен, який ви додали в Mailgun
Регіон — us або eu, відповідно до кроку 1
Ключ API Mailgun — ключ із кроку 3

⛔⛔ Правильно вкажіть регіон. Облікові записи Mailgun, які розміщені в ЄС, обслуговуються зовсім іншим хостом API. Надсилання ключа облікового запису ЄС на хост США повертає помилку "401 Unauthorized" — що сприймається саме як неправильний ключ. Якщо ваш ключ абсолютно правильний, але ви отримуєте помилку 401, майже завжди справа в цьому.

5. Надішліть тестове повідомлення та введіть код

Натисніть Send test message, використовуючи поштову скриньку на іншому домені — адреса Gmail підійде ідеально. Знайдіть код у тій поштовій скриньці та введіть його. Ваша пошта перемкнеться негайно.

Якщо це не працює

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

Тестове повідомлення ніколи не надходить — перевірте сторінку Logs у Mailgun. Якщо Mailgun взагалі не має запису про нього, облікові дані або ім'я домену вказано неправильно. Якщо Mailgun прийняв його, але після цього сталася помилка, причина буде вказана там зрозумілою мовою, і майже завжди справа в DNS.

"Domain not found" — поле Домен надсилання Mailgun має точно збігатися з доменом у тому вигляді, у якому його показує Mailgun, включаючи субдомен. yourdomain.com і mail.yourdomain.com для Mailgun є двома різними доменами.

Все працювало, а потім зупинилося — перевірте, чи не закінчився ваш безкоштовний пробний період. Пробні облікові записи Mailgun можуть надсилати повідомлення лише на авторизовані адреси отримувачів, тому тестове повідомлення на вашу власну адресу продовжує надсилатися, тоді як усі повідомлення вашим клієнтам мовчки не доставляються.