API
Verifikasi Nomor WhatsApp
POST /contacts/verify — cek apakah daftar nomor terdaftar di WhatsApp.
Cek apakah satu atau banyak nomor telepon terdaftar di WhatsApp. Berguna untuk membersihkan database kontak sebelum kampanye, atau memvalidasi input form pendaftaran.
Endpoint
POST /contacts/verifyBase URL
https://dash.ngirimwa.com/api/v1Headers
x-api-key: API_KEY_ANDA
Content-Type: application/jsonRequest
{
"phones": [
"628123456789",
"628987654321",
"628111111111"
]
}Respon Sukses
{
"success": true,
"message": "Numbers verified",
"data": [
{ "phone": "628123456789", "exists": true, "jid": "628123456789@s.whatsapp.net" },
{ "phone": "628987654321", "exists": false, "jid": null },
{ "phone": "628111111111", "exists": true, "jid": "628111111111@s.whatsapp.net" }
]
}Parameter
| Parameter | Tipe | Wajib | Deskripsi |
|---|---|---|---|
phones | string[] | ✅ | 1–50 nomor per request. Format Indonesia (628..., 08..., atau 8...) — sistem otomatis normalisasi. |
Field Respon
| Field | Tipe | Deskripsi |
|---|---|---|
phone | string | Nomor yang Anda kirim (dinormalisasi) |
exists | boolean | true jika nomor terdaftar di WhatsApp |
jid | string | null | JID lengkap (untuk dipakai endpoint lain) jika terdaftar, null jika tidak |
Contoh cURL
curl -X POST https://dash.ngirimwa.com/api/v1/contacts/verify \
-H "x-api-key: API_KEY_ANDA" \
-H "Content-Type: application/json" \
-d '{
"phones": ["628123456789", "628987654321"]
}'Use Case
Sebelum broadcast kampanye — filter dulu nomor yang tidak terdaftar supaya tidak membuang quota & menghindari pengiriman gagal.
Validasi form — saat pelanggan mendaftar via website, verify nomor sebelum simpan supaya CS tahu nomor tersebut bisa di-WA.
Cleaning database — batch process kontak lama untuk hapus nomor yang sudah tidak aktif di WhatsApp.
Catatan Penting
- Maksimal 50 nomor per request. Untuk batch lebih besar, panggil endpoint berulang dengan chunk 50.
- Endpoint ini tidak menghabiskan kuota pesan — verifikasi adalah operasi metadata, bukan pengiriman.
- Endpoint memerlukan device dalam status
connected. Bila device sedang offline, response 400 dengan pesan "Device not connected". - Hasil tidak di-cache — setiap request mengecek langsung ke server WhatsApp. Hindari memanggil ulang untuk nomor yang sama dalam interval singkat.