Validasi email sebelum mengirim: kapan perlu, apa yang dicek, dan cara memakai bulk validation
Cara membersihkan list email sebelum mengirim: apa yang bisa dan tidak bisa dibuktikan validasi, arti setiap hasil, dan contoh job massal dengan webhook.
Daftar isi
Alamat email yang salah ketik atau sudah mati adalah penyebab paling umum hard bounce. Satu atau dua bounce tidak masalah, tetapi tingkat bounce yang tinggi merusak reputasi domain pengirim Anda, dan email penting seperti OTP ikut terdampak. Validasi sebelum mengirim adalah cara murah untuk mencegahnya.
Kapan validasi email perlu dilakukan
- Saat impor list lama. Data dari sistem lama, spreadsheet, atau CRM sering berisi alamat yang sudah tidak aktif.
- Saat pendaftaran. Cek alamat sebelum akun dibuat agar pengguna bisa memperbaiki salah ketik saat itu juga.
- Sebelum kampanye atau migrasi. Bersihkan list sekali sebelum volume besar dikirim, bukan setelah bounce terlanjur terjadi.
Apa yang dicek, dan batasannya
Validasi Email CapiMail memeriksa sintaks, server email domain (record MX, atau A/AAAA sebagai cadangan), alamat sekali pakai (disposable) yang dikenal, dan alamat peran seperti info@ atau admin@.
Arti setiap hasil
| Hasil | Arti | Saran |
|---|---|---|
valid | Tidak ditemukan masalah | Kirim seperti biasa |
risky | Bisa menerima email, tetapi ada peringatan: disposable, alamat peran, atau tanpa record MX | Kirim untuk email transaksional, pertimbangkan ulang untuk list marketing |
invalid | Tidak bisa menerima email, misalnya domain tidak ada | Jangan kirim; minta pengguna memperbaiki alamat |
unknown | Pencarian DNS gagal saat dicek | Coba lagi nanti; tidak dipotong kredit |
Setiap hasil juga membawa reasons, kode mesin seperti domain_not_found, role_address, atau disposable_domain, sehingga backend Anda bisa memutuskan sendiri apa yang dilakukan.
Cek hingga 100 alamat secara langsung
Untuk form pendaftaran atau list kecil, panggil endpoint sinkron. Alamat duplikat (tanpa membedakan huruf besar kecil) hanya dicek sekali.
import { CapiMail } from "@capimail/sdk";
const capimail = new CapiMail({ apiKey: process.env.CAPIMAIL_API_KEY! });
const { results } = await capimail.validation.check({
emails: ["budi@contoh.co.id", "info@contoh.co.id"],
});
for (const r of results) {
console.log(r.email, r.verdict, r.reasons);
}List besar: job massal dengan webhook
Untuk list hingga 10.000 alamat, buat job yang berjalan di latar belakang. Kecepatannya sekitar 500 sampai 2.000 alamat per menit, tergantung berapa banyak domain berbeda di list. Saat selesai, CapiMail mengirim event validation.completed ke webhook Anda, jadi backend tidak perlu terus memeriksa status.
const job = await capimail.validation.jobs.create({
emails: addresses, // hingga 10.000 alamat
suppressInvalid: true, // alamat invalid langsung masuk daftar supresi
metadata: { list_id: "import-2026-11" },
idempotencyKey: "validate-import-2026-11",
});
console.log(job.id, job.status); // "queued"- Idempotency key sangat disarankan. Permintaan yang diulang dengan kunci yang sama mengembalikan job yang sama, bukan membuat job kedua.
- `suppress_invalid` menambahkan alamat invalid ke daftar supresi saat job selesai, sehingga pengiriman berikutnya otomatis melewatinya.
- `metadata` (hingga 20 pasangan string) dikembalikan di job dan di webhook, jadi Anda tahu list mana yang selesai.
- Hasil per alamat tersedia di
GET /api/v1/validations/{id}/results, 1.000 per halaman, bisa difilter?verdict=invalid. Hasil disimpan 30 hari setelah job selesai.
import { constructWebhookEvent } from "@capimail/sdk";
export async function POST(request: Request) {
const event = await constructWebhookEvent({
payload: await request.text(), // body mentah, jangan di-parse dulu
signature: request.headers.get("x-capimail-signature"),
secret: process.env.CAPIMAIL_WEBHOOK_SECRET!,
});
if (event.type === "validation.completed") {
const { job_id, summary, metadata } = event.data;
await markListValidated(metadata.list_id, job_id, summary);
}
return new Response(null, { status: 204 });
}Biaya
Validasi memakai saldo kredit yang sama dengan pengiriman: 2 kredit per alamat unik yang mendapat hasil. Alamat dengan hasil unknown tidak dipotong. Untuk job massal, kredit dipotong saat job dimulai dan hasil unknown dikembalikan saat selesai. Jika saldo tidak cukup untuk seluruh list, permintaan ditolak dengan 402 insufficient_credits tanpa memotong apa pun. Lihat harga add-on dan referensi API.
Pertanyaan yang sering diajukan
Apakah validasi email menjamin email sampai ke inbox?
Tidak. Validasi menyaring alamat yang pasti gagal atau berisiko dari sintaks, DNS, dan daftar domain sekali pakai. Ia tidak terhubung ke server penerima, jadi tidak bisa membuktikan kotak surat tertentu ada, dan tidak memengaruhi penyaringan spam.
Apakah key test bisa dipakai untuk validasi?
Validasi Email adalah add-on berbayar dan membutuhkan live key (cm_live_).