Ще ви трябват акаунт в 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 на вашия акаунт.
Използвайте ключ за изпращане (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 могат да изпращат само до оторизирани получатели, така че тестовото съобщение до вашия собствен адрес продължава да работи, докато всички съобщения към вашите клиенти безшумно се провалят.