Kirim email melalui akun Mailgun Anda sendiri

Anda akan memerlukan akun Mailgun dan akses ke DNS domain Anda.

Dokumentasi resmi Mailgun: Menambahkan dan memverifikasi domain · Kunci API · Daftar

1. Tambahkan domain pengiriman Anda ke Mailgun

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

⚠️ Panduan resmi Mailgun menyarankan penggunaan subdomain, dan hal ini lebih penting di sini dibandingkan pada beberapa penyedia lain: Mailgun menetapkan data SPF dan DKIM miliknya sendiri pada apa pun yang Anda berikan, dan mengarahkannya ke domain root berarti data tersebut akan berdampingan dengan data yang digunakan oleh kotak surat bisnis Anda.

Pilih wilayah yang sesuai dengan lokasi data yang Anda inginkan — US atau EU. Catat hal ini; Anda akan membutuhkannya di langkah 4, dan ini adalah kesalahan paling umum yang sering terjadi.

2. Publikasikan data DNS yang diberikan Mailgun

Mailgun menampilkan sebuah daftar kepada Anda. Tambahkan setiap data tersebut pada penyedia DNS Anda.

⛔ Jika subdomain pengiriman Anda sudah memiliki data SPF, edit data tersebut — jangan menambahkan data kedua. Domain dengan dua data TXT SPF akan langsung gagal dalam verifikasi SPF, yang mana lebih buruk daripada tidak memilikinya sama sekali.

Kemudian tekan Verify DNS Settings di Mailgun. Proses verifikasi hingga berwarna hijau dapat memakan waktu hingga satu jam.

⭐ Tambahkan data MX meskipun Anda hanya melakukan pengiriman email. Data ini adalah cara Mailgun mengumpulkan pantulan (bounce). Tanpa data tersebut, alamat yang tidak valid akan memantul tanpa tujuan, Mailgun tidak dapat memblokirnya, dan Anda akan terus membayar biaya pengiriman ke alamat yang tidak akan pernah menerima apa pun.

3. Dapatkan kunci API Anda

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

Gunakan kunci pengiriman (sending key) yang dikhususkan untuk domain ini jika paket Anda menyediakannya, daripada 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 menyimpan kunci yang kedua.

4. Hubungkan di Zinn®

Buka Pengiriman email di dasbor Anda dan isi:

• Penyedia — Mailgun
• Kirim dari domain ini — mail.yourdomain.com (domain, bukan alamat email)
• Domain pengiriman Mailgun — domain yang sama dengan yang Anda tambahkan di Mailgun
• Wilayah — us atau eu, sesuai dengan langkah 1
• Kunci API Mailgun — kunci dari langkah 3

⛔⛔ Pastikan wilayahnya tepat. Akun Mailgun yang dihosting di EU dilayani dari host API yang sepenuhnya berbeda. Mengirimkan 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 kode 401, hal inilah yang hampir selalu menjadi penyebabnya.

5. Kirim pengujian dan masukkan kodenya

Tekan Kirim pesan pengujian, menggunakan kotak masuk pada domain yang berbeda — alamat Gmail adalah pilihan ideal. Baca kode dari kotak masuk tersebut dan masukkan kodenya. Layanan email Anda akan segera beralih saat itu juga.

Ketika prosesnya tidak berjalan

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

Pesan pengujian tidak kunjung sampai — periksa halaman Logs di Mailgun. Jika Mailgun tidak memiliki catatan apa pun mengenainya sama sekali, kredensial atau nama domain tersebut salah. Jika Mailgun menerimanya dan gagal setelahnya, alasannya akan tertera di sana secara jelas, dan hal itu hampir selalu terkait dengan DNS.

"Domain not found" — kolom Domain pengiriman Mailgun harus sama persis dengan domain seperti yang tercantum di Mailgun, termasuk subdomainnya. Bagi Mailgun, yourdomain.com dan mail.yourdomain.com adalah dua domain yang berbeda.

Sebelumnya berhasil lalu berhenti — periksa apakah masa uji coba gratis Anda telah berakhir. Akun uji coba Mailgun hanya dapat mengirim ke penerima yang diotorisasi, sehingga pesan pengujian ke alamat Anda sendiri akan tetap terkirim sementara semua pesan ke klien Anda tidak terkirim tanpa pemberitahuan.