· 2 min read
Deteksi Nomor WhatsApp — Verifikasi Massal melalui Platform atau API | CheckNumber.AI
Panduan langkah demi langkah untuk memeriksa registrasi nomor WhatsApp via API. Termasuk contoh curl, Python, Node.js. Pemrosesan batch massal, $0,8 / 10.000 pemeriksaan.
API Deteksi Nomor WhatsApp — Panduan Integrasi Langkah demi Langkah
Memverifikasi registrasi WhatsApp dalam skala besar sangat penting untuk pembersihan daftar pemasaran, deteksi penipuan, kualifikasi lead, dan validasi data CRM. Panduan ini memandu Anda mengintegrasikan API verifikasi massal WhatsApp dari CheckNumber.AI, dengan contoh kode dalam curl, Python, dan Node.js.
Cara Kerja
Pemeriksaan produksi berjalan sebagai tugas batch: unggah file, lakukan polling status, unduh hasil — bukan satu panggilan HTTP sinkron per nomor telepon. Pendekatan ini menangani verifikasi berskala besar secara efisien.
Referensi resmi: WhatsApp Checker — bulk registration.
Kirim tugas
POST https://api.checknumber.ai/v1/tasks
| Parameter | Deskripsi |
|---|---|
file | .txt / .csv, satu nomor E.164 per baris |
task_type | ws — pemeriksaan registrasi WhatsApp |
Contoh — curl:
curl --location 'https://api.checknumber.ai/v1/tasks' \
--header 'X-API-Key: API-KEY' \
--form 'file=@"./numbers.txt"' \
--form 'task_type="ws"'
Contoh — Python:
import requests
url = "https://api.checknumber.ai/v1/tasks"
headers = {"X-API-Key": "YOUR_API_KEY"}
with open("numbers.txt", "rb") as f:
files = {"file": f, "task_type": (None, "ws")}
response = requests.post(url, headers=headers, files=files)
print(response.json())
# Output: {"task_id": "xyz123", "status": "pending", "total": 1000}
Contoh — Node.js:
const FormData = require('form-data');
const fs = require('fs');
const axios = require('axios');
const form = new FormData();
form.append('file', fs.createReadStream('numbers.txt'));
form.append('task_type', 'ws');
axios.post('https://api.checknumber.ai/v1/tasks', form, {
headers: {
...form.getHeaders(),
'X-API-Key': 'YOUR_API_KEY'
}
}).then(res => console.log(res.data))
.catch(err => console.error(err.message));
Polling status
POST https://api.checknumber.ai/v1/gettasks
curl --location 'https://api.checknumber.ai/v1/gettasks' \
--header 'X-API-Key: API-KEY' \
--form 'task_id="TASK_ID"'
Kolom hasil
| Field | Deskripsi |
|---|---|
Number | Nomor telepon E.164 |
whatsapp | yes / no — terdaftar di WhatsApp |
Error Umum & Pemecahan Masalah
| Error | Penyebab | Solusi |
|---|---|---|
400 Bad Request | Kunci API tidak ada atau format file tidak valid | Pastikan header X-API-Key disertakan; gunakan format E.164 (mis. +41798284651) |
401 Unauthorized | Kunci API tidak valid | Periksa kunci API Anda di dasbor |
413 Payload Too Large | File melebihi batas ukuran | Bagi menjadi beberapa batch; maks. 50MB per unggahan |
500 Server Error | Masalah server sementara | Coba lagi dalam 30 detik |
FAQ
T: Berapa lama verifikasi massal berlangsung? J: Biasanya 5-30 detik untuk file hingga 100.000 nomor, tergantung beban antrean.
T: Berapa ukuran file minimum dan maksimum? J: Minimum 1 nomor, maksimum 50MB (biasanya ~5 juta nomor dalam format CSV).
T: Apakah kredit hanya dipotong untuk pemeriksaan yang berhasil? J: Ya. Hanya hasil yang berhasil diverifikasi yang memakai kredit. Baris yang gagal tidak dikenai biaya.
Langkah Berikutnya
- Siap memulai? Dapatkan 1.000 pemeriksaan gratis →
- Lihat harga lengkap: Halaman Harga →
- Dokumentasi API lengkap: Dokumentasi API →
Catatan integrasi
- Satu nomor per baris; sertakan kode negara dalam format E.164.
- Lakukan polling hingga
statusbernilaiexported, lalu gunakanresult_url. - Lihat dokumentasi resmi.
- Harga: halaman harga.