WhatsApp नंबर वेरिफिकेशन बनाएं (API)

किसी फोन नंबर सूची को संदेश भेजने से पहले जांचें कि वे नंबर WhatsApp पर रजिस्टर्ड हैं या नहीं। इसका इस्तेमाल इंपोर्ट की गई संपर्क सूचियों को साफ करने, साइन-अप नंबरों की जांच करने या उन नंबरों को हटाने के लिए करें जिन पर संदेश सिर्फ फेल ही होंगे।

रिक्वेस्ट एक वेरिफिकेशन टास्क बनाती है और तुरंत एक campaign_id लौटाती है। इसके बाद आपके किसी कनेक्टेड WhatsApp नंबर द्वारा बैकग्राउंड में नंबर जांचे जाते हैं। प्रोग्रेस देखने के लिए campaign_id को वेरिफिकेशन स्टेटस के साथ, या नतीजे पढ़ने के लिए वेरिफिकेशन नतीजे के साथ इस्तेमाल करें।

छोटा उदाहरण#

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 की जगह सेटिंग्स → API Keys से कोई की डालें। की से तय होता है कि टास्क किस वर्कस्पेस का होगा।

रिक्वेस्ट पैरामीटर#

रिस्पॉन्स#

सफल रिक्वेस्ट HTTP 200 लौटाती है:

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

हर स्वीकार किया गया नंबर pending से शुरू होता है। टास्क आपके डैशबोर्ड में नंबर सत्यापन पेज पर भी दिखता है। वहां उसका कार्ड पूरा होने के बाद भी Processing दिखाता रह सकता है, इसलिए असली स्थिति के लिए वेरिफिकेशन स्टेटस इस्तेमाल करें।

एरर#

एरर होने पर status = "error" वाली JSON बॉडी और HTTP एरर कोड लौटता है:

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

नंबर कैसे जांचे जाते हैं#

1. टास्क कतार में जाता है

   API हर स्वीकार किए गए नंबर को pending के रूप में सेव करता है और तुरंत जवाब लौटाता है।

2. कोई कनेक्टेड WhatsApp नंबर उन्हें जांचता है

   नंबर एक बार में ज़्यादा से ज़्यादा 10 करके, WhatsApp सेटिंग्स में कनेक्टेड किसी WhatsApp नंबर से जांचे जाते हैं। हर नंबर WhatsApp पर रजिस्टर्ड हो तो verified बन जाता है, और न हो तो invalid। जांच सिर्फ ऐसे कनेक्टेड नंबर पर चलती है जो संदेश भेजने में व्यस्त न हो, इसलिए बड़े कैंपेन के दौरान जांच भेजना पूरा होने तक रुक सकती है।

3. आप नतीजे पढ़ते हैं

   जब तक overall_status completed न हो जाए, वेरिफिकेशन स्टेटस को बार-बार कॉल (poll) करें, फिर नंबर उसी रिस्पॉन्स से या वेरिफिकेशन नतीजे से पढ़ें।

सुझाव#

• हमेशा कंट्री कोड शामिल करें। बिना कंट्री कोड वाला 10 अंकों का लोकल नंबर लंबाई की जांच में पास हो जाता है, लेकिन उसे ठीक वैसे ही जांचा जाता है जैसा लिखा है, इसलिए नतीजा उस नंबर का नहीं होगा जो आप चाहते थे।
• 00 इंटरनेशनल प्रीफिक्स इस्तेमाल न करें। शुरुआत का सिर्फ एक 0 हटाया जाता है, इसलिए 00919876543210 को 0919876543210 के रूप में जांचा जाता है। 919876543210 भेजें।
• डुप्लिकेट खुद हटाएं भेजने से पहले, ताकि आपके प्लान की प्रति-रिक्वेस्ट सीमा दोहराए गए नंबरों पर खर्च न हो।
• numbers_submitted जांचें ताकि वे नंबर मिल सकें जो बहुत छोटे होने या अक्षर होने की वजह से हटा दिए गए।
• बड़ी सूचियां: अगर आप प्रति-रिक्वेस्ट सीमा तक पहुंच जाते हैं, तो कई छोटे टास्क भेजें और हर campaign_id को ट्रैक करें।

नंबर वेरिफिकेशन में नए हैं? नंबर वेरिफिकेशन गाइड देखें।