Cipta pengesahan nombor WhatsApp (API)

Semak sama ada senarai nombor telefon berdaftar di WhatsApp sebelum anda menghantar mesej kepada mereka. Gunakannya untuk membersihkan senarai kenalan yang diimport, mengesahkan nombor pendaftaran atau membuang nombor yang hanya akan gagal.

Permintaan ini mencipta tugas pengesahan dan memulangkan campaign_id serta-merta. Nombor kemudiannya disemak di latar belakang oleh salah satu nombor WhatsApp anda yang disambungkan. Gunakan campaign_id dengan Status pengesahan untuk memantau kemajuan, atau dengan Keputusan pengesahan untuk membaca keputusan.

Contoh ringkas#

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');
}

Gantikan YOUR_API_KEY dengan kunci dari Settings → API keys (Tetapan → Kunci API). Kunci menentukan ruang kerja yang memiliki tugas ini.

Parameter permintaan#

Respons#

Permintaan yang berjaya memulangkan HTTP 200:

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

Setiap nombor yang diterima bermula sebagai pending. Tugas ini juga muncul di halaman Number verification (Pengesahan nombor) dalam papan pemuka anda. Kadnya di sana mungkin terus memaparkan Processing selepas tugas selesai, jadi gunakan Status pengesahan untuk keadaan sebenar.

Ralat#

Ralat memulangkan badan JSON dengan status ditetapkan kepada "error" dan kod ralat HTTP:

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

Cara nombor disemak#

1. Tugas dimasukkan ke dalam baris gilir

   API menyimpan setiap nombor yang diterima sebagai pending dan memberi respons serta-merta.

2. Nombor WhatsApp yang disambungkan menyemaknya

   Nombor disemak sehingga 10 pada satu masa menggunakan nombor WhatsApp yang disambungkan di tetapan WhatsApp. Setiap nombor menjadi verified jika ia berdaftar di WhatsApp, atau invalid jika tidak. Semakan hanya dijalankan pada nombor yang disambungkan dan tidak sibuk menghantar mesej, jadi semasa kempen besar, semakan mungkin menunggu sehingga penghantaran selesai.

3. Anda membaca keputusannya

   Tinjau Status pengesahan sehingga overall_status ialah completed, kemudian baca nombor daripada respons yang sama atau daripada Keputusan pengesahan.

Petua#

• Sentiasa sertakan kod negara. Nombor tempatan 10 digit tanpanya lulus semakan panjang, tetapi ia disemak tepat seperti yang ditulis, jadi keputusannya bukan untuk nombor yang anda maksudkan.
• Jangan gunakan awalan antarabangsa 00. Hanya satu 0 di hadapan dibuang, jadi 00919876543210 disemak sebagai 0919876543210. Hantar 919876543210.
• Buang pendua sendiri sebelum menghantar, supaya anda tidak membazirkan had setiap permintaan pelan anda untuk nombor berulang.
• Semak numbers_submitted untuk mencari nombor yang digugurkan kerana terlalu pendek atau mengandungi huruf.
• Senarai besar: jika anda mencapai had setiap permintaan, hantar beberapa tugas yang lebih kecil dan jejaki setiap campaign_id.

Baru menggunakan pengesahan nombor? Lihat panduan Pengesahan nombor.