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.

Tim CapiMailTerbit 2 menit baca
Daftar isi
  1. Empat hal yang dicek
  2. Kode masalah yang paling sering muncul
  3. Cek sekali lewat API
  4. Pantau setiap hari dan terima webhook
  5. Biaya

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

RecordYang diperiksa
MXDomain punya server penerima email, bukan null MX
SPFTepat satu record, diakhiri ~all atau -all, dan paling banyak 10 lookup DNS
DKIMPublic key ada untuk selector yang Anda berikan (maksimal 5)
DMARCRecord 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 (dari include, 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_missing dan dmarc_policy_none: DMARC belum ada, atau masih p=none sehingga tidak melindungi dari spoofing.
  • dmarc_no_reports: tidak ada alamat rua, 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

Mengecek domain klien dengan SDK TypeScript· ts
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.

Membuat monitor harian· ts
const monitor = await capimail.domains.monitors.create({
  domain: "klien.co.id",
  dkimSelectors: ["google"],
});
// Saat statusnya berubah, webhook Anda menerima domain.health_changed

Biaya

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.

Semua artikel