Anda memerlukan akaun Mailgun dan akses kepada DNS domain anda.
Dokumentasi Mailgun sendiri: Menambah dan mengesahkan domain · Kunci API · Daftar
1. Tambah domain penghantaran anda ke Mailgun
Dalam papan pemuka Mailgun, pergi ke Send → Domains → Add New Domain dan masukkan subdomain, contohnya mail.yourdomain.com.
⚠️ Panduan Mailgun sendiri mencadangkan subdomain, dan ini lebih penting di sini berbanding dengan sesetengah penyedia lain: Mailgun menetapkan rekod SPF dan DKIM miliknya sendiri pada apa sahaja yang anda berikan kepadanya, dan menghalakannya ke domain akar anda bermakna rekod-rekod tersebut diletakkan bersama rekod yang digunakan oleh peti mel perniagaan anda.
Pilih rantau yang sepadan dengan tempat data anda ingin disimpan — US atau EU. Catatkannya; anda memerlukannya dalam langkah 4, dan ini merupakan kesilapan yang paling kerap berlaku.
2. Terbitkan rekod DNS yang diberikan oleh Mailgun kepada anda
Mailgun memaparkan senarai kepada anda. Tambah setiap satunya di penyedia DNS anda.
| Type | Host | Purpose |
|---|
TXT | mail.yourdomain.com | SPF — v=spf1 include:mailgun.org ~all |
TXT | mailo._domainkey.mail.yourdomain.com | Kunci awam DKIM |
CNAME | email.mail.yourdomain.com | Penjejakan dan pengendalian lantunan |
MX | mail.yourdomain.com | Menerima lantunan (dua hos MX Mailgun) |
⛔ Jika subdomain penghantaran anda sudah mempunyai rekod SPF, edit rekod tersebut — jangan tambah rekod kedua. Domain dengan dua rekod TXT SPF gagal dalam SPF sepenuhnya, yang mana lebih buruk daripada tiada langsung.
Kemudian tekan Verify DNS Settings dalam Mailgun. Ia mungkin mengambil masa sehingga satu jam untuk bertukar hijau.
⭐ Tambah rekod MX walaupun anda hanya menghantar mel. Ini adalah cara Mailgun mengumpul lantunan. Tanpa rekod ini, alamat yang tidak sah akan melantun tanpa hala tuju, Mailgun tidak dapat menyekatnya, dan anda terus membayar untuk menghantar ke alamat yang tidak akan menerima apa-apa.
3. Dapatkan kunci API anda
Send → Sending → Domain settings → API keys, atau halaman API Keys akaun anda.
Gunakan kunci penghantaran yang terhad skopnya pada domain ini jika pelan anda menawarkannya, berbanding kunci API peribadi akaun anda. Kunci penghantaran hanya boleh menghantar; kunci peribadi boleh membaca log anda dan mengubah akaun anda. Tiada sebab bagi kami untuk menyimpan kunci yang kedua itu.
4. Sambungkannya dalam Zinn®
Buka Email sending dalam papan pemuka anda dan isi:
- Provider — Mailgun
- Send from this domain —
mail.yourdomain.com (domain, bukan alamat)
- Mailgun sending domain — domain yang sama seperti yang anda tambahkan dalam Mailgun
- Region —
us atau eu, sepadan dengan langkah 1
- Mailgun API key — kunci daripada langkah 3
⛔⛔ Pastikan rantau adalah betul. Akaun Mailgun yang dihoskan di EU dikendalikan daripada hos API yang berbeza sama sekali. Menghantar kunci akaun EU ke hos US mengembalikan "401 Unauthorized" — yang kelihatan betul-betul seperti ralat kunci yang salah. Jika kunci anda pasti betul dan anda mendapat 401, ini hampir selalunya menjadi puncanya.
5. Hantar ujian dan masukkan kod
Tekan Send test message, menggunakan peti masuk pada domain yang berbeza — alamat Gmail adalah yang terbaik. Baca kod daripada peti masuk tersebut dan masukkannya. Mel anda bertukar serta-merta.
Apabila ia tidak berfungsi
401 Unauthorized — rantau salah (lihat di atas), atau anda menampal kunci daripada akaun Mailgun yang berbeza. Jana semula kunci tersebut berbanding menaipnya semula; awalan key- mudah tercicir.
Mesej ujian tidak pernah sampai — periksa halaman Logs Mailgun. Jika Mailgun tidak mempunyai sebarang rekod mengenainya langsung, kelayakan atau nama domain adalah salah. Jika Mailgun menerimanya dan ia gagal selepas itu, puncanya akan dipaparkan dengan jelas, dan ia hampir selalunya disebabkan oleh DNS.
"Domain not found" — medan Mailgun sending domain mestilah tepat seperti domain yang disenaraikan oleh Mailgun, termasuk subdomain. yourdomain.com dan mail.yourdomain.com merupakan dua domain yang berbeza bagi Mailgun.
Ia berfungsi dan kemudian terhenti — periksa sama ada percubaan percuma anda telah tamat. Akaun percubaan Mailgun hanya boleh menghantar kepada penerima yang dibenarkan, jadi mesej ujian ke alamat anda sendiri terus berfungsi sementara semua mesej kepada pelanggan anda secara senyap-senyap tidak berfungsi.