Trimiteți e-mailuri prin propriul cont Mailgun

Veți avea nevoie de un cont Mailgun și de acces la setările DNS ale domeniului dumneavoastră.

Documentația oficială Mailgun: Adăugarea și verificarea unui domeniu · Chei API · Înregistrare

1. Adăugați domeniul de trimitere în Mailgun

În panoul de control Mailgun mergeți la Send → Domains → Add New Domain și introduceți un subdomeniu, de exemplu mail.yourdomain.com.

⚠️ Recomandarea proprie a celor de la Mailgun este utilizarea unui subdomeniu, iar acest lucru contează mai mult aici decât la alți furnizori: Mailgun configurează propriile înregistrări SPF și DKIM pentru orice îi furnizați, iar dacă îl direcționați către domeniul rădăcină, aceste înregistrări se vor suprapune peste cele pe care se bazează căsuțele dumneavoastră de e-mail profesionale.

Alegeți regiunea care corespunde locului în care doriți să fie stocate datele dumneavoastră — US sau EU. Notați-o; veți avea nevoie de ea la pasul 4 și este cea mai frecventă sursă de erori.

2. Publicați înregistrările DNS furnizate de Mailgun

Mailgun vă afișează o listă. Adăugați fiecare dintre aceste înregistrări la furnizorul dumneavoastră de DNS.

⛔ Dacă subdomeniul dumneavoastră de trimitere are deja o înregistrare SPF, editați-o — nu adăugați o a doua. Un domeniu cu două înregistrări SPF de tip TXT eșuează complet validarea SPF, ceea ce este mai grav decât să nu aveți niciuna.

Apoi apăsați pe Verify DNS Settings în Mailgun. Poate dura până la o oră până când starea devine verde.

⭐ Adăugați înregistrările MX chiar dacă trimiteți doar mesaje. Prin intermediul lor colectează Mailgun respingerile. Fără ele, un e-mail trimis la o adresă greșită este respins în neant, Mailgun nu o poate suprima, iar dumneavoastră veți continua să plătiți pentru a trimite către o adresă care nu va primi niciodată nimic.

3. Obțineți cheia API

Send → Sending → Domain settings → API keys, sau pagina API Keys a contului dumneavoastră.

Utilizați o cheie de trimitere alocată strict acestui domeniu dacă abonamentul dumneavoastră permite acest lucru, mai degrabă decât cheia API privată a contului. O cheie de trimitere poate doar să trimită; cheia privată vă poate citi jurnalele și poate modifica contul. Nu există niciun motiv pentru care noi ar trebui să o deținem pe a doua.

4. Conectați-l în Zinn®

Deschideți Email sending în panoul dumneavoastră de control și completați:

• Provider — Mailgun
• Send from this domain — mail.yourdomain.com (un domeniu, nu o adresă)
• Mailgun sending domain — exact același domeniu pe care l-ați adăugat în Mailgun
• Region — us sau eu, corespunzător pasului 1
• Mailgun API key — cheia de la pasul 3

⛔⛔ Alegeți corect regiunea. Conturile Mailgun găzduite în EU sunt deservite de o gazdă API complet diferită. Trimiterea cheii unui cont din EU către gazda din US returnează „401 Unauthorized” — ceea ce seamănă perfect cu o cheie greșită. Dacă sunteți sigur că ați introdus cheia corectă și primiți eroarea 401, aproape întotdeauna aceasta este cauza.

5. Trimiteți testul și introduceți codul

Apăsați pe Send test message, folosind o căsuță poștală de pe un domeniu diferit — o adresă de Gmail este ideală. Citiți codul primit în acea căsuță și introduceți-l. Serviciul dumneavoastră de e-mail va face trecerea imediat.

Când lucrurile nu funcționează

401 Unauthorized — regiune greșită (vezi mai sus), sau ați inserat o cheie dintr-un cont Mailgun diferit. Regenerați cheia în loc să o rescrieți manual; prefixul key- este ușor de omis.

Mesajul de test nu ajunge niciodată — verificați pagina Logs din Mailgun. Dacă Mailgun nu are nicio evidență despre acesta, datele de autentificare sau numele domeniului sunt incorecte. Dacă Mailgun l-a acceptat și a eșuat ulterior, motivul va fi explicat clar acolo și este aproape întotdeauna legat de DNS.

„Domain not found” — câmpul Mailgun sending domain trebuie să coincidă exact cu domeniul așa cum este listat în Mailgun, inclusiv subdomeniul. yourdomain.com și mail.yourdomain.com sunt două domenii diferite pentru Mailgun.

A funcționat și apoi s-a oprit — verificați dacă perioada de probă gratuită a expirat. Conturile de probă Mailgun pot trimite doar către destinatari autorizați, astfel că mesajul de test către propria dumneavoastră adresă continuă să funcționeze, în timp ce toate trimiterile către clienți eșuează silențios.