Memantau kesehatan domain email: MX, SPF, DKIM, dan DMARC sebelum pengguna mengeluh
Cara mengecek dan memantau MX, SPF, DKIM, dan DMARC setiap hari, arti kode masalah yang umum, dan menerima webhook saat status domain berubah.
Daftar isi
Record DNS email jarang berubah, tetapi saat berubah dampaknya besar. Seseorang memindahkan DNS ke penyedia lain dan lupa menyalin record DKIM, atau menambahkan layanan baru dan membuat SPF kedua. Email tetap terkirim, tetapi mulai masuk spam atau ditolak, dan Anda baru tahu setelah pengguna mengeluh. Pemantauan rutin menangkap masalah ini lebih awal.
Empat hal yang dicek
| Record | Yang diperiksa |
|---|---|
| MX | Domain punya server penerima email, bukan null MX |
| SPF | Tepat satu record, diakhiri ~all atau -all, dan paling banyak 10 lookup DNS |
| DKIM | Public key ada untuk selector yang Anda berikan (maksimal 5) |
| DMARC | Record ada, kebijakannya (p=) dan apakah laporan rua diaktifkan |
Untuk penjelasan dasar tiap record dan cara memasangnya, baca panduan SPF, DKIM, dan DMARC.
Kode masalah yang paling sering muncul
spf_missing: tidak ada record SPF sama sekali.spf_multiple_records: ada lebih dari satu record SPF. Penerima menganggap ini error, jadi gabungkan menjadi satu.spf_too_many_lookups: lebih dari 10 lookup DNS (dariinclude,a,mx, dan sejenisnya). SPF gagal dievaluasi.spf_allows_all: SPF diakhiri+all, artinya siapa pun boleh mengirim atas nama domain Anda.dkim_key_missing: selector DKIM tidak punya public key, biasanya karena record hilang saat pindah DNS.dmarc_missingdandmarc_policy_none: DMARC belum ada, atau masihp=nonesehingga tidak melindungi dari spoofing.dmarc_no_reports: tidak ada alamatrua, jadi Anda tidak menerima laporan agregat.
Setiap pengecekan juga punya status sendiri (pass, warn, fail, skipped, atau unknown bila DNS tidak bisa dihubungi), dan status keseluruhan domain adalah pass, warn, atau fail.
Cek sekali lewat API
import { CapiMail } from "@capimail/sdk";
const capimail = new CapiMail({ apiKey: process.env.CAPIMAIL_API_KEY! });
const result = await capimail.domains.check({
domain: "klien.co.id",
dkimSelectors: ["google", "s1"],
});
console.log(result.status); // "pass" | "warn" | "fail"
console.log(result.issues.map((i) => i.code));Pengecekan ini bekerja untuk domain apa pun, termasuk domain klien yang tidak mengirim lewat CapiMail. Agensi bisa memakainya untuk mengaudit domain klien sebelum onboarding.
Pantau setiap hari dan terima webhook
Untuk domain penting, buat monitor. Monitor dicek sekali sehari, dan CapiMail mengirim event domain.health_changed ke webhook Anda hanya saat status keseluruhan berubah, misalnya dari pass ke fail, bukan setiap kali dicek. Satu workspace bisa memantau hingga 50 domain.
const monitor = await capimail.domains.monitors.create({
domain: "klien.co.id",
dkimSelectors: ["google"],
});
// Saat statusnya berubah, webhook Anda menerima domain.health_changedBiaya
5 kredit per pengecekan sesekali, gratis untuk domain pengirim Anda yang terverifikasi. Pemantauan memakai 3 kredit per cek harian. Jika kredit habis, monitor dijeda dengan status paused_no_credits dan berjalan lagi setelah top up. Lihat harga add-on dan referensi Domain Health.
Pertanyaan yang sering diajukan
Apakah bisa mengecek domain yang tidak memakai CapiMail?
Bisa. Pengecekan Domain Health membaca DNS publik, jadi bekerja untuk domain apa pun, termasuk domain klien yang memakai layanan email lain.
Seberapa sering monitor mengirim webhook?
Monitor dicek sekali sehari, dan webhook domain.health_changed hanya dikirim saat status keseluruhan berubah, bukan pada setiap pengecekan.