Szüksége lesz egy Mailgun-fiókra és hozzáférésre a domainje DNS-éhez.
A Mailgun saját dokumentációja: Domain hozzáadása és ellenőrzése · API-kulcsok · Regisztráció
1. Adja hozzá a küldő domainjét a Mailgunhoz
A Mailgun vezérlőpultján lépjen a Send → Domains → Add New Domain menüpontra, és adjon meg egy aldomaint, például: mail.yourdomain.com.
⚠️ A Mailgun saját útmutatása szerint érdemes aldomaint használni, és ez itt fontosabb, mint néhány más szolgáltatónál: a Mailgun a saját SPF- és DKIM-rekordjait állítja be bármire, amit megad, és ha a gyökérdomainre irányítja, ezek a rekordok azok mellett fognak szerepelni, amelyekre az üzleti postaládái támaszkodnak.
Válassza ki azt a régiót, amely megfelel annak, ahol az adatait tárolni szeretné — US vagy EU. Írja fel; szüksége lesz rá a 4. lépésben, és ez a leggyakoribb hibaforrás.
2. Tegye közzé a Mailgun által megadott DNS-rekordokat
A Mailgun megjelenít egy listát. Adja hozzá mindegyiket a DNS-szolgáltatójánál.
| Típus | Hoszt | Cél |
|---|
TXT | mail.yourdomain.com | SPF — v=spf1 include:mailgun.org ~all |
TXT | mailo._domainkey.mail.yourdomain.com | DKIM nyilvános kulcs |
CNAME | email.mail.yourdomain.com | Nyomon követés és visszapattanó levelek kezelése |
MX | mail.yourdomain.com | Visszapattanó levelek fogadása (a Mailgun két MX-hosztja) |
⛔ Ha a küldő aldomainje már rendelkezik SPF-rekorddal, szerkessze azt — ne adjon hozzá egy másodikat. Egy két SPF TXT-rekorddal rendelkező domainnél az SPF azonnal sikertelen lesz, ami rosszabb, mintha egyáltalán nem lenne.
Ezután kattintson a Verify DNS Settings gombra a Mailgunban. Akár egy órát is igénybe vehet, amíg zöldre vált.
⭐ Adja hozzá az MX-rekordokat akkor is, ha csak küldésre használja. A Mailgun ezeken keresztül gyűjti be a visszapattanó leveleket. Nélkülük a hibás címek a semmibe pattannak vissza, a Mailgun nem tudja letiltani őket, és Ön továbbra is fizetni fog az olyan címekre történő küldésért, amelyek soha semmit nem fognak megkapni.
3. Kérje le az API-kulcsát
Send → Sending → Domain settings → API keys, vagy a fiókja API Keys oldala.
Használjon egy erre a domainre korlátozott küldési kulcsot (sending key), ha a csomagja biztosít ilyet, ahelyett, hogy a fiók privát API-kulcsát használná. A küldési kulcs csak küldeni tud; a privát kulcs képes olvasni a naplófájljait és módosítani a fiókját. Semmi okunk sincs arra, hogy a másodikat birtokoljuk.
4. Csatlakoztassa a Zinn® felületén
Nyissa meg az Email sending menüpontot a vezérlőpultján, és töltse ki a következőket:
- Szolgáltató — Mailgun
- Küldés erről a domainről —
mail.yourdomain.com (egy domain, nem egy e-mail-cím)
- Mailgun küldő domain — ugyanaz a domain, amelyet hozzáadott a Mailgunhoz
- Régió —
us vagy eu, az 1. lépésnek megfelelően
- Mailgun API-kulcs — a 3. lépésben megszerzett kulcs
⛔⛔ Ügyeljen a helyes régióra. Az EU-ban tárolt Mailgun-fiókokat egy teljesen más API-hoszt szolgálja ki. Ha egy EU-s fiók kulcsát a US hosztnak küldi el, az "401 Unauthorized" választ ad — ami pontosan úgy néz ki, mintha rossz lenne a kulcs. Ha a kulcsa biztosan helyes, és mégis 401-es hibát kap, szinte mindig ez az oka.
5. Küldje el a tesztet, és adja meg a kódot
Kattintson a Send test message gombra, egy másik domainen lévő postaládát használva — egy Gmail-cím ideális erre. Olvassa le a kódot abból a postaládából, és adja meg. A levelezése azonnal átáll.
Ha nem működik
401 Unauthorized — hibás régió (lásd fent), vagy egy másik Mailgun-fiókból másolta be a kulcsot. Generálja újra a kulcsot ahelyett, hogy újra begépelné; a kezdő key- rész könnyen lemaradhat.
A tesztüzenet soha nem érkezik meg — ellenőrizze a Mailgun Logs oldalát. Ha a Mailgunnál semmilyen nyoma sincs, a hitelesítési adat vagy a domainnév hibás. Ha a Mailgun elfogadta, és utána hiúsult meg, az ok ott lesz egyértelműen leírva, és ez szinte mindig a DNS.
"Domain not found" — a Mailgun küldő domain mezőnek pontosan a Mailgun által listázott domainnek kell lennie, beleértve az aldomaint is. A yourdomain.com és a mail.yourdomain.com két különböző domain a Mailgun számára.
Működött, majd leállt — ellenőrizze, hogy nem járt-e le az ingyenes próbaidőszaka. A Mailgun próbaverziós fiókjai csak engedélyezett címzetteknek (authorised recipients) küldhetnek üzeneteket, így a saját címére küldött tesztüzenet továbbra is működik, míg az ügyfeleinek szánt levelek némán meghiúsulnak.