Kakailanganin ninyo ng isang Mailgun account at access sa DNS ng inyong domain.
Sariling dokumentasyon ng Mailgun: Pagdaragdag at pag-verify ng domain · Mga API key · Mag-sign up
1. Idagdag ang inyong sending domain sa Mailgun
Sa dashboard ng Mailgun pumunta sa Send → Domains → Add New Domain at maglagay ng isang subdomain, halimbawa mail.yourdomain.com.
⚠️ Ang sariling gabay ng Mailgun ay isang subdomain, at mas mahalaga ito rito kaysa sa ibang mga provider: Nagtatakda ang Mailgun ng sarili nitong mga SPF at DKIM record sa anumang ibigay ninyo rito, at ang pagturo nito sa inyong root domain ay nangangahulugang tatabi ang mga record na iyon sa mga pinagbabatayan ng inyong mga mailbox ng negosyo.
Piliin ang rehiyon na tumutugma kung saan ninyo nais mamalagi ang inyong data — US o EU. Isulat ito; kakailanganin ninyo ito sa hakbang 4, at ito ang nag-iisang pinakakaraniwang bagay na nagkakamali.
2. I-publish ang mga DNS record na ibinibigay ng Mailgun sa inyo
Nagpapakita ang Mailgun sa inyo ng isang listahan. Idagdag ang bawat isa sa mga ito sa inyong DNS provider.
| Uri | Host | Layunin |
|---|
TXT | mail.yourdomain.com | SPF — v=spf1 include:mailgun.org ~all |
TXT | mailo._domainkey.mail.yourdomain.com | Pampublikong key ng DKIM |
CNAME | email.mail.yourdomain.com | Pag-track at pamamahala ng bounce |
MX | mail.yourdomain.com | Pagtanggap ng mga bounce (ang dalawang MX host ng Mailgun) |
⛔ Kung ang inyong sending subdomain ay mayroon nang SPF record, i-edit ito — huwag magdagdag ng pangalawa. Ang isang domain na may dalawang SPF TXT record ay direktang nabibigo sa SPF, na mas malala kaysa sa walang kahit isa.
Pagkatapos ay pindutin ang Verify DNS Settings sa Mailgun. Maaari itong tumagal nang hanggang isang oras bago maging berde.
⭐ Idagdag ang mga MX record kahit na nagpapadala lamang kayo. Ang mga ito ang paraan kung paano kinokolekta ng Mailgun ang mga bounce. Kung wala ang mga ito, magba-bounce ang isang maling address sa kawalan, hindi ito masusupil ng Mailgun, at patuloy kayong magbabayad upang magpadala sa isang address na hindi kailanman makatatanggap ng anuman.
3. Kunin ang inyong API key
Send → Sending → Domain settings → API keys, o ang pahina ng API Keys ng inyong account.
Gumamit ng isang sending key na nakasaklaw sa domain na ito kung nag-aalok ang inyong plano, sa halip na ang pribadong API key ng inyong account. Ang isang sending key ay maaari lamang magpadala; ang pribadong key ay maaaring magbasa ng inyong mga log at magbago ng inyong account. Walang dahilan para hawakan namin ang pangalawa.
4. Ikonekta ito sa Zinn®
Buksan ang Email sending sa inyong dashboard at punan ang:
- Provider — Mailgun
- Send from this domain —
mail.yourdomain.com (isang domain, hindi isang address)
- Mailgun sending domain — ang parehong domain na idinagdag ninyo sa Mailgun
- Region —
us o eu, na tumutugma sa hakbang 1
- Mailgun API key — ang key mula sa hakbang 3
⛔⛔ Gawing tama ang rehiyon. Ang mga EU-hosted Mailgun account ay pinagsisilbihan mula sa isang ganap na kakaibang API host. Ang pagpapadala ng key ng isang EU account sa US host ay nagbabalik ng "401 Unauthorized" — na mababasa nang eksakto tulad ng isang maling key. Kung talagang tama ang inyong key at nakakakuha kayo ng 401, ito halos palagi ang dahilan.
5. Ipadala ang pagsubok at ilagay ang code
Pindutin ang Send test message, gamit ang isang inbox sa ibang domain — mainam ang isang Gmail address. Basahin ang code mula sa inbox na iyon at ilagay ito. Agad na lilipat ang inyong mail.
Kapag hindi ito gumagana
401 Unauthorized — maling rehiyon (tingnan sa itaas), o nag-paste kayo ng key mula sa ibang Mailgun account. I-regenerate ang key sa halip na i-type itong muli; madaling maiwala ang key- sa unahan.
Hindi dumarating kailanman ang test message — suriin ang pahina ng Logs ng Mailgun. Kung walang rekord ang Mailgun nito, mali ang kredensyal o ang pangalan ng domain. Kung tinanggap ito ng Mailgun at nabigo ito pagkatapos, naroroon ang dahilan sa malinaw na mga salita, at halos palaging DNS ito.
"Domain not found" — ang field ng Mailgun sending domain ay dapat eksaktong domain tulad ng nakalista sa Mailgun, kabilang ang subdomain. Dalawang magkaibang domain ang yourdomain.com at mail.yourdomain.com para sa Mailgun.
Gumana ito at pagkatapos ay huminto — suriin kung natapos na ang inyong libreng pagsubok. Ang mga trial account ng Mailgun ay maaari lamang magpadala sa mga awtorisadong tatanggap, kaya patuloy na gumagana ang pansubok na mensahe sa sarili ninyong address habang ang lahat ng papunta sa inyong mga kliyente ay tahimik na hindi gumagana.