בדיקת מספרים

בדיקת מספרים מבררת לאילו מספרי טלפון יש חשבון WhatsApp, בלי לשלוח להם כלום. נקו רשימה לפני קמפיין, או בדקו את המספר של מי שנרשם לפני שאתם שולחים לו הודעה. בדיקות שנוצרות עם ה-API זהות לרשימות שבדף אימות מספרים בלוח הבקרה.

התחלת בדיקה דורשת תוכנית שכוללת אימות מספרים; אחרת התגובה היא 403 plan_required. קריאת בדיקות עובדת בכל תוכנית.

התחלת בדיקה#

המספרים נכנסים לתור, והתגובה היא 201 עם הבדיקה בסטטוס pending. מספר WhatsApp מחובר של סביבת העבודה שלכם בודק אותם בדקות הקרובות. בצעו polling לבדיקה עד ש-status הוא completed, ואז קראו את התוצאות.

curl -X POST https://wbiztool.com/api/v2/number-checks \
  -H "Authorization: Bearer $WBIZTOOL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: october-leads" \
  -d '{
    "name": "October leads",
    "numbers": ["+919876543210", "+447700900123", "+14155550123"]
  }'

import os
import time
import requests

API = "https://wbiztool.com/api/v2"
headers = {"Authorization": f"Bearer {os.environ['WBIZTOOL_API_KEY']}"}

check = requests.post(f"{API}/number-checks", headers=headers, timeout=60, json={
    "name": "October leads",
    "numbers": ["+919876543210", "+447700900123", "+14155550123"],
}).json()
print("Skipped entries:", check["skipped"])

while check["status"] != "completed":
    time.sleep(30)
    check = requests.get(f"{API}/number-checks/{check['id']}", headers=headers, timeout=30).json()
    print(check["counts"])

params = {"limit": 100}
while True:
    page = requests.get(f"{API}/number-checks/{check['id']}/results",
                        headers=headers, params=params, timeout=30).json()
    for result in page["data"]:
        print(result["number"], result["status"])
    if not page["next_cursor"]:
        break
    params["cursor"] = page["next_cursor"]

// Node.js 18+ (built-in fetch). Save as .mjs to use top-level await.
const API = "https://wbiztool.com/api/v2";
const headers = { Authorization: `Bearer ${process.env.WBIZTOOL_API_KEY}`, "Content-Type": "application/json" };
const sleep = (ms) => new Promise((r) => setTimeout(r, ms));

let check = await (await fetch(`${API}/number-checks`, {
  method: "POST",
  headers,
  body: JSON.stringify({ name: "October leads", numbers: ["+919876543210", "+447700900123", "+14155550123"] }),
})).json();

while (check.status !== "completed") {
  await sleep(30000);
  check = await (await fetch(`${API}/number-checks/${check.id}`, { headers })).json();
}

const params = new URLSearchParams({ limit: "100" });
while (true) {
  const page = await (await fetch(`${API}/number-checks/${check.id}/results?${params}`, { headers })).json();
  for (const result of page.data) console.log(result.number, result.status);
  if (!page.next_cursor) break;
  params.set("cursor", page.next_cursor);
}

<?php
$ch = curl_init('https://wbiztool.com/api/v2/number-checks');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('WBIZTOOL_API_KEY'), 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS     => json_encode([
        'name'    => 'October leads',
        'numbers' => ['+919876543210', '+447700900123', '+14155550123'],
    ]),
    CURLOPT_RETURNTRANSFER => true,
]);
$check = json_decode(curl_exec($ch), true);
curl_close($ch);
// Save $check['id'], then poll GET /api/v2/number-checks/{id} until status is completed.
echo $check['id'] . ' ' . $check['status'] . ' skipped: ' . $check['skipped'];

תגובה (201):

{
  "id": 51207,
  "name": "October leads",
  "status": "pending",
  "counts": { "total": 3, "pending": 3, "on_whatsapp": 0, "not_on_whatsapp": 0, "cancelled": 0 },
  "created_at": "2026-10-18T10:40:02.511Z",
  "skipped": 0
}

‏skipped הוא מספר הרשומות שלא היו מספר טלפון (טקסט, פחות מ-7 או יותר מ-15 ספרות): הן לא נבדקות ולא נספרות במסגרת התוכנית שלכם.

מגבלות התוכנית#

התוכנית שלכם קובעת כמה מספרים אפשר לבדוק (ראו מגבלות התוכנית):

• לכל בדיקה: בבדיקה לא יכולים להיות יותר מספרים מהמספר שבתוכנית. מעבר לכך, הבדיקה נדחית עם too_many_numbers, עם count ו-limit.
• לכל תקופת חיוב: גם כל הבדיקות יחד, מה-API ומלוח הבקרה, לא יכולות לעבור אותו. בדיקה שהייתה עוברת אותו נדחית עם number_check_quota_reached, עם requested, ‏used ו-limit.
• בתוכנית בלי מגבלה אין אף אחת מהן. ה-API מקבל לכל היותר 10,000 מספרים בבקשה, בכל תוכנית.
• בדיקה שנדחתה לא מכניסה כלום לתור. פצלו את הרשימה, חכו לתקופה הבאה, או שדרגו.

שגיאות בהתחלת בדיקה#

רשימת בדיקות#

הבדיקות של סביבת העבודה, מהחדשה לישנה, בדפים (limit מ-1 עד 100, ברירת המחדל 25, ו-cursor), כולל בדיקות שהתחילו בלוח הבקרה. כל אחת מהן היא Number check.

curl https://wbiztool.com/api/v2/number-checks \
  -H "Authorization: Bearer $WBIZTOOL_API_KEY"

קבלת בדיקה#

הבדיקה וההתקדמות שלה. בצעו לה polling בערך כל 30 שניות עד ש-status הוא completed.

curl https://wbiztool.com/api/v2/number-checks/51207 \
  -H "Authorization: Bearer $WBIZTOOL_API_KEY"

{
  "id": 51207,
  "name": "October leads",
  "status": "processing",
  "counts": { "total": 3, "pending": 1, "on_whatsapp": 1, "not_on_whatsapp": 1, "cancelled": 0 },
  "created_at": "2026-10-18T10:40:02.511Z"
}

בדיקה שלא קיימת מחזירה 404 number_check_not_found.

הבדיקה דורשת מספר WhatsApp של סביבת העבודה שמחובר עם קוד QR או קוד צימוד, והיא ממתינה בזמן שהמספרים שלכם שולחים. בדיקה יכולה להישאר pending או processing לזמן מה; ראו איך הבדיקה עובדת.

קבלת התוצאות#

המספרים של הבדיקה ומה שנמצא, בדפים (limit מ-1 עד 100, ברירת המחדל 25, ו-cursor). אפשר לקרוא אותם בזמן שהבדיקה רצה: מספרים שעדיין לא נבדקו הם pending.

curl "https://wbiztool.com/api/v2/number-checks/51207/results?limit=100" \
  -H "Authorization: Bearer $WBIZTOOL_API_KEY"

{
  "data": [
    { "number": "14155550123", "on_whatsapp": null, "status": "pending", "checked_at": null },
    { "number": "447700900123", "on_whatsapp": false, "status": "not_on_whatsapp", "checked_at": "2026-10-18T10:42:57.204Z" },
    { "number": "919876543210", "on_whatsapp": true, "status": "on_whatsapp", "checked_at": "2026-10-18T10:42:51.880Z" }
  ],
  "next_cursor": null
}

האובייקט Number check#

מדריכים קשורים#

• אימות מספרים בלוח הבקרה
• תוכניות וחיובים
• שגיאות