Trebat će vam Mailgun račun i pristup DNS-u vaše domene.
Mailgunova vlastita dokumentacija: Dodavanje i verifikacija domene · API ključevi · Registracija
1. Dodajte svoju domenu za slanje u Mailgun
Na Mailgun upravljačkoj ploči idite na Send → Domains → Add New Domain i unesite poddomenu, na primjer mail.yourdomain.com.
⚠️ Mailgunova vlastita preporuka je poddomena, a ovdje je to važnije nego kod nekih pružatelja usluga: Mailgun postavlja vlastite SPF i DKIM zapise na sve što mu dodijelite, a usmjeravanje na vašu korijensku domenu znači da se ti zapisi nalaze uz one na koje se oslanjaju vaši poslovni sandučići.
Odaberite regiju koja odgovara mjestu gdje želite da se nalaze vaši podaci — US ili EU. Zapišite je; trebat će vam u koraku 4, a to je ujedno i najčešća pogreška.
2. Objavite DNS zapise koje vam Mailgun pruža
Mailgun vam prikazuje popis. Dodajte svaki od njih kod svog DNS pružatelja usluga.
| Vrsta | Host | Svrha |
|---|
TXT | mail.yourdomain.com | SPF — v=spf1 include:mailgun.org ~all |
TXT | mailo._domainkey.mail.yourdomain.com | DKIM javni ključ |
CNAME | email.mail.yourdomain.com | Praćenje i rukovanje odbijenim porukama |
MX | mail.yourdomain.com | Primanje odbijenih poruka (Mailgunova dva MX hosta) |
⛔ Ako vaša poddomena za slanje već ima SPF zapis, uredite ga — nemojte dodavati drugi. Domena s dva SPF TXT zapisa potpuno pada na SPF provjeri, što je gore nego nemati nijedan.
Zatim pritisnite Verify DNS Settings u Mailgunu. Može proći do sat vremena dok ne postane zeleno.
⭐ Dodajte MX zapise iako samo šaljete. Putem njih Mailgun prikuplja odbijene poruke. Bez njih se neispravna adresa odbija u nepovrat, Mailgun je ne može potisnuti, a vi nastavljate plaćati slanje na adresu koja nikada ništa neće primiti.
3. Preuzmite svoj API ključ
Send → Sending → Domain settings → API keys, ili stranica API Keys vašeg računa.
Upotrijebite ključ za slanje ograničen na ovu domenu ako ga vaš paket nudi, umjesto privatnog API ključa vašeg računa. Ključ za slanje može samo slati; privatni ključ može čitati vaše zapise i mijenjati vaš račun. Nema razloga da zadržavamo ovaj drugi.
4. Povežite ga u Zinn®
Otvorite Slanje e-pošte na svojoj upravljačkoj ploči i ispunite:
- Pružatelj usluga — Mailgun
- Šalji s ove domene —
mail.yourdomain.com (domena, a ne adresa)
- Mailgun domena za slanje — ista domena koju ste dodali u Mailgunu
- Regija —
us ili eu, u skladu s korakom 1
- Mailgun API ključ — ključ iz koraka 3
⛔⛔ Pripazite na točnost regije. Mailgun računi smješteni u EU-u poslužuju se s potpuno drugog API hosta. Slanje ključa EU računa na US host vraća "401 Unauthorized" — što izgleda upravo kao pogrešan ključ. Ako je vaš ključ sigurno točan, a primate 401, ovo je gotovo uvijek razlog.
5. Pošaljite test i unesite kod
Pritisnite Pošalji testnu poruku, koristeći sandučić na drugoj domeni — Gmail adresa je idealna. Očitajte kod iz tog sandučića i unesite ga. Vaša e-pošta odmah prelazi na novi sustav.
Kada ne radi
401 Unauthorized — pogrešna regija (vidi gore) ili ste zalijepili ključ s drugog Mailgun računa. Ponovno generirajte ključ umjesto da ga ponovno tipkate; početni key- lako se izgubi.
Testna poruka nikada ne stiže — provjerite stranicu Logs u Mailgunu. Ako Mailgun uopće nema zapis o tome, vjerodajnica ili naziv domene su pogrešni. Ako ju je Mailgun prihvatio, a nakon toga nije uspjela, razlog će biti jasno naveden, i gotovo je uvijek u pitanju DNS.
"Domain not found" — polje Mailgun domena za slanje mora biti točno onakva domena kakva je navedena u Mailgunu, uključujući poddomenu. yourdomain.com i mail.yourdomain.com dvije su različite domene za Mailgun.
Radilo je, a zatim je prestalo — provjerite je li vam isteklo besplatno probno razdoblje. Mailgun probni računi mogu slati samo ovlaštenim primateljima, pa testna poruka na vašu vlastitu adresu nastavlja raditi dok sve prema vašim klijentima tiho prestaje raditi.