Buat verifikasi nomor WhatsApp (API)

Periksa apakah daftar nomor telepon terdaftar di WhatsApp sebelum Anda mengirimi mereka pesan. Gunakan untuk membersihkan daftar kontak yang diimpor, memvalidasi nomor pendaftaran, atau menghapus nomor yang hanya akan gagal.

Request ini membuat tugas verifikasi dan langsung mengembalikan campaign_id. Nomor kemudian diperiksa di latar belakang oleh salah satu nomor WhatsApp Anda yang terhubung. Gunakan campaign_id dengan Status verifikasi untuk memantau progres, atau dengan Hasil verifikasi untuk membaca hasilnya.

Contoh singkat#

curl -X POST https://wbiztool.com/api/v1/verification/create/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "campaign_name": "Website leads - September",
    "numbers": ["919876543210", "+91 98765 43211", "14155550123"]
  }'

import requests

response = requests.post(
    "https://wbiztool.com/api/v1/verification/create/",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "campaign_name": "Website leads - September",
        "numbers": ["919876543210", "+91 98765 43211", "14155550123"],
    },
    timeout=60,
)
result = response.json()  # read the body even when the HTTP code is 4xx or 5xx

if result["status"] == "success":
    print("Task created, campaign_id", result["campaign_id"])
    print("Accepted numbers:", result["numbers_submitted"])
else:
    print(f"Failed ({response.status_code}):", result["message"])

// Node.js 18+ (built-in fetch). Save as .mjs to use top-level await.
const response = await fetch("https://wbiztool.com/api/v1/verification/create/", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    campaign_name: "Website leads - September",
    numbers: ["919876543210", "+91 98765 43211", "14155550123"],
  }),
});
const result = await response.json(); // read the body even when the HTTP code is 4xx or 5xx

if (result.status === "success") {
  console.log("Task created, campaign_id", result.campaign_id);
  console.log("Accepted numbers:", result.numbers_submitted);
} else {
  console.error(`Failed (${response.status}):`, result.message);
}

<?php
$payload = [
    'campaign_name' => 'Website leads - September',
    'numbers'       => ['919876543210', '+91 98765 43211', '14155550123'],
];

$ch = curl_init('https://wbiztool.com/api/v1/verification/create/');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer YOUR_API_KEY',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS     => json_encode($payload),
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 60,
]);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);

if (($result['status'] ?? '') === 'success') {
    echo 'Task created, campaign_id ' . $result['campaign_id'];
} else {
    echo 'Failed: ' . ($result['message'] ?? 'no response');
}

Ganti YOUR_API_KEY dengan key dari Settings → API keys (Pengaturan → Kunci API). Key menentukan workspace pemilik tugas tersebut.

Parameter request#

Respons#

Request yang berhasil mengembalikan HTTP 200:

{
  "status": "success",
  "message": "Verification task created successfully",
  "campaign_id": 4521,
  "numbers_count": 3,
  "numbers_submitted": ["919876543210", "919876543211", "14155550123"]
}

Setiap nomor yang diterima dimulai dengan status pending. Tugas ini juga muncul di halaman Number verification (Verifikasi nomor) di dashboard Anda. Kartunya di sana mungkin tetap menampilkan Processing setelah selesai, jadi gunakan Status verifikasi untuk keadaan yang sebenarnya.

Error#

Error mengembalikan body JSON dengan status bernilai "error" dan kode error HTTP:

{ "status": "error", "message": "No valid phone numbers found" }

Cara nomor diperiksa#

1. Tugas masuk antrean

   API menyimpan setiap nomor yang diterima sebagai pending dan langsung mengembalikan respons.

2. Nomor WhatsApp yang terhubung memeriksanya

   Nomor diperiksa hingga 10 sekaligus menggunakan nomor WhatsApp yang terhubung di WhatsApp settings (pengaturan WhatsApp). Setiap nomor menjadi verified jika terdaftar di WhatsApp, atau invalid jika tidak. Pemeriksaan hanya berjalan pada nomor terhubung yang tidak sedang sibuk mengirim pesan, sehingga selama kampanye besar pemeriksaan bisa menunggu sampai pengiriman selesai.

3. Anda membaca hasilnya

   Lakukan polling ke Status verifikasi sampai overall_status bernilai completed, lalu baca nomornya dari respons yang sama atau dari Hasil verifikasi.

Tips#

• Selalu sertakan kode negara. Nomor lokal 10 digit tanpa kode negara lolos pemeriksaan panjang, tetapi diperiksa persis seperti yang ditulis, sehingga hasilnya bukan untuk nomor yang Anda maksud.
• Jangan gunakan awalan internasional 00. Hanya satu angka 0 di depan yang dihapus, sehingga 00919876543210 diperiksa sebagai 0919876543210. Kirim 919876543210.
• Hapus duplikat sendiri sebelum mengirim, agar batas per request dari paket Anda tidak terpakai untuk nomor yang berulang.
• Periksa numbers_submitted untuk menemukan nomor yang dihilangkan karena terlalu pendek atau mengandung huruf.
• Daftar besar: jika Anda mencapai batas per request, kirim beberapa tugas yang lebih kecil dan pantau setiap campaign_id.

Baru menggunakan verifikasi nomor? Lihat panduan Verifikasi nomor.