WhatsApp numara doğrulaması oluşturma (API)

Mesaj göndermeden önce bir telefon numarası listesinin WhatsApp'a kayıtlı olup olmadığını kontrol edin. İçe aktarılan kişi listelerini temizlemek, kayıt numaralarını doğrulamak veya zaten başarısız olacak numaraları çıkarmak için kullanın.

İstek bir doğrulama görevi oluşturur ve hemen bir campaign_id döndürür. Numaralar ardından bağlı WhatsApp numaralarınızdan biri tarafından arka planda kontrol edilir. İlerlemeyi takip etmek için campaign_id değerini Doğrulama durumu ile, sonuçları okumak için Doğrulama sonuçları ile kullanın.

Hızlı örnek#

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

YOUR_API_KEY değerini Ayarlar → API anahtarları sayfasındaki bir anahtarla değiştirin. Görevin hangi çalışma alanına ait olacağını anahtar belirler.

İstek parametreleri#

Yanıt#

Başarılı bir istek HTTP 200 döndürür:

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

Kabul edilen her numara pending olarak başlar. Görev, panelinizdeki Numara doğrulama sayfasında da görünür. Oradaki kartı, görev bittikten sonra da Processing (İşleniyor) göstermeye devam edebilir; gerçek durum için Doğrulama durumu endpoint'ini kullanın.

Hatalar#

Hatalar, status değeri "error" olan bir JSON gövdesi ve bir HTTP hata kodu döndürür:

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

Numaralar nasıl kontrol edilir#

1. Görev kuyruğa alınır

   API kabul edilen her numarayı pending olarak kaydeder ve hemen yanıt döner.

2. Bağlı bir WhatsApp numarası bunları kontrol eder

   Numaralar, WhatsApp ayarları sayfasında bağlı bir WhatsApp numarası kullanılarak bir seferde en fazla 10 adet kontrol edilir. Her numara WhatsApp'a kayıtlıysa verified, değilse invalid olur. Kontroller yalnızca mesaj göndermekle meşgul olmayan bağlı bir numarada çalışır; bu yüzden büyük bir kampanya sırasında gönderim bitene kadar bekleyebilirler.

3. Sonuçları okursunuz

   overall_status değeri completed olana kadar Doğrulama durumu endpoint'ini sorgulayın, ardından numaraları aynı yanıttan veya Doğrulama sonuçları endpoint'inden okuyun.

İpuçları#

• Her zaman ülke kodunu ekleyin. Ülke kodu olmayan 10 haneli yerel bir numara uzunluk kontrolünden geçer, ancak tam olarak yazıldığı gibi kontrol edilir; bu yüzden sonuç kastettiğiniz numara için olmaz.
• 00 uluslararası önekini kullanmayın. Baştaki yalnızca bir 0 kaldırılır, bu yüzden 00919876543210, 0919876543210 olarak kontrol edilir. 919876543210 gönderin.
• Tekrarları kendiniz kaldırın: planınızın istek başına sınırını tekrarlara harcamamak için göndermeden önce tekrarları temizleyin.
• numbers_submitted değerini kontrol edin: çok kısa oldukları veya harf içerdikleri için çıkarılan numaraları bulun.
• Büyük listeler: istek başına sınıra ulaşırsanız, birkaç küçük görev gönderin ve her campaign_id değerini takip edin.

Numara doğrulamada yeni misiniz? Numara doğrulama rehberine bakın.