Kirim email melalui akun Mailgun Anda sendiri

Anda memerlukan akun Mailgun dan akses ke DNS domain Anda.

Dokumentasi Mailgun sendiri: Adding and verifying a domain · API keys · Sign up

1. Tambahkan domain pengiriman Anda ke Mailgun

Di dasbor Mailgun, buka Send → Domains → Add New Domain dan masukkan subdomain, misalnya mail.yourdomain.com.

⚠️ Panduan dari Mailgun sendiri adalah menggunakan subdomain, dan hal ini lebih penting di sini dibandingkan dengan beberapa penyedia layanan lainnya: Mailgun menetapkan catatan SPF dan DKIM sendiri pada apa pun yang Anda berikan, dan mengarahkannya ke domain akar (root domain) Anda berarti catatan tersebut akan berdampingan dengan catatan yang diandalkan oleh kotak surat bisnis Anda.

Pilih wilayah yang sesuai dengan tempat Anda ingin menyimpan data Anda — AS (US) atau Uni Eropa (EU). Catat wilayah tersebut; Anda akan memerlukannya pada langkah 4, dan ini adalah kesalahan yang paling sering terjadi.

2. Publikasikan catatan DNS yang diberikan oleh Mailgun

Mailgun menampilkan daftar kepada Anda. Tambahkan setiap catatan tersebut di penyedia DNS Anda.

| Jenis | Host | Tujuan | | --- | --- | --- | | TXT | mail.yourdomain.com | SPF — v=spf1 include:mailgun.org ~all | | TXT | mailo._domainkey.mail.yourdomain.com | Kunci publik DKIM | | CNAME | email.mail.yourdomain.com | Pelacakan dan penanganan bounce | | MX | mail.yourdomain.com | Menerima bounce (dua host MX Mailgun) |

⛔ Jika subdomain pengiriman Anda sudah memiliki catatan SPF, ubah catatan tersebut — jangan menambahkan yang kedua. Domain dengan dua catatan TXT SPF akan langsung gagal melewati pemeriksaan SPF, yang jauh lebih buruk daripada tidak memilikinya sama sekali.

Kemudian tekan Verify DNS Settings di Mailgun. Proses ini dapat memakan waktu hingga satu jam untuk menjadi hijau.

⭐ Tambahkan catatan MX meskipun Anda hanya mengirim email. Catatan tersebut adalah cara Mailgun mengumpulkan bounce. Tanpa catatan tersebut, alamat yang tidak valid akan terpental ke tempat yang tidak diketahui, Mailgun tidak dapat meredamnya, dan Anda akan terus membayar untuk mengirim ke alamat yang tidak akan pernah menerima apa pun.

3. Dapatkan kunci API (API key) Anda

Send → Sending → Domain settings → API keys, atau halaman API Keys di akun Anda.

Gunakan kunci pengiriman (sending key) yang dicakupkan (scoped) ke domain ini jika paket Anda menyediakannya, alih-alih menggunakan kunci API privat akun Anda. Kunci pengiriman hanya dapat mengirim; kunci privat dapat membaca log Anda dan mengubah akun Anda. Tidak ada alasan bagi kami untuk memegang kunci yang kedua.

4. Hubungkan di Zinn®

Buka Email sending di dasbor Anda dan isi bagian berikut:

• Provider — Mailgun
• Send from this domain — mail.yourdomain.com (sebuah domain, bukan alamat)
• Mailgun sending domain — domain yang sama dengan yang Anda tambahkan di Mailgun
• Region — us atau eu, yang cocok dengan langkah 1
• Mailgun API key — kunci dari langkah 3

⛔⛔ Pastikan wilayahnya benar. Akun Mailgun yang di-host di EU dilayani dari host API yang sepenuhnya berbeda. Mengirim kunci akun EU ke host US akan menghasilkan pesan "401 Unauthorized" — yang terbaca persis seperti kunci yang salah. Jika kunci Anda sudah pasti benar dan Anda mendapatkan kesalahan 401, hampir selalu inilah penyebabnya.

5. Kirim uji coba dan masukkan kode

Tekan Send test message, menggunakan kotak masuk (inbox) pada domain yang berbeda — alamat Gmail sangat ideal. Baca kode dari kotak masuk tersebut dan masukkan. Surel Anda akan langsung beralih.

Saat fitur tidak berfungsi

401 Unauthorized — wilayah salah (lihat di atas), atau Anda menempelkan kunci dari akun Mailgun yang berbeda. Buat ulang kunci tersebut daripada mengetiknya ulang; awalan key- sangat mudah terlewat.

Pesan uji coba tidak pernah sampai — periksa halaman Logs di Mailgun. Jika Mailgun sama sekali tidak memiliki catatan tentangnya, kredensial atau nama domain Anda salah. Jika Mailgun menerimanya dan gagal setelahnya, alasannya akan ada di sana dalam bentuk teks yang jelas, dan hampir selalu masalah DNS.

"Domain not found" — kolom Mailgun sending domain harus persis berupa domain seperti yang tercantum di Mailgun, termasuk subdomainnya. yourdomain.com dan mail.yourdomain.com adalah dua domain yang berbeda bagi Mailgun.

Berfungsi lalu berhenti — periksa apakah masa uji coba gratis Anda telah berakhir. Akun uji coba Mailgun hanya dapat mengirim ke penerima yang diizinkan (authorised recipients), sehingga pesan uji coba ke alamat Anda sendiri akan terus berfungsi sementara semua pesan ke klien Anda diam-diam gagal terkirim.