דלגו לתוכן
Wbiztool

API לאימות מספרים

סטטוס אימות מספרי WhatsApp (API)

בדקו את ההתקדמות של משימת אימות מספרים וקבלו את התוצאה של כל מספר בה. אחרי יצירת משימת אימות, קראו ל-endpoint הזה שוב ושוב עד שהמשימה מסתיימת.

GEThttps://wbiztool.com/api/v1/verification/status/?campaign_id=4521

דוגמה מהירה#

curl "https://wbiztool.com/api/v1/verification/status/?campaign_id=4521" \
  -H "Authorization: Bearer YOUR_API_KEY"

פרמטרי הבקשה#

Authorizationheaderחובה

Bearer YOUR_API_KEY, עם מפתח מהדף Settings → API keys. אפשר במקום זאת להעביר את המפתח כפרמטר שאילתה api_key, אבל הכותרת מונעת ממנו להופיע בלוגים של שרתים ושל פרוקסי.

campaign_idintegerחובה

ה-campaign_id שהוחזר מ-יצירת אימות, שנשלח ב-query string. הוא חייב להיות משימת אימות באותה סביבת עבודה כמו מפתח ה-API.

תגובה#

בקשה מוצלחת מחזירה HTTP 200:

{
  "status": "success",
  "campaign_id": 4521,
  "campaign_name": "Website leads - September",
  "overall_status": "processing",
  "progress": {
    "total": 3,
    "pending": 1,
    "verified": 1,
    "invalid": 1,
    "completed_percentage": 66.67
  },
  "results": [
    {
      "number": "14155550123",
      "status": "pending",
      "checked_at": null,
      "created_at": "2026-09-16T10:15:00.483101+00:00"
    },
    {
      "number": "919876543210",
      "status": "verified",
      "checked_at": "2026-09-16T10:16:12.204551+00:00",
      "created_at": "2026-09-16T10:15:00.482913+00:00"
    },
    {
      "number": "919876543211",
      "status": "invalid",
      "checked_at": "2026-09-16T10:16:19.915372+00:00",
      "created_at": "2026-09-16T10:15:00.483020+00:00"
    }
  ],
  "created_at": "2026-09-16T10:15:00.471820+00:00",
  "last_updated": "2026-09-16T10:15:00.471820+00:00"
}
שדהסוגתיאור
statusstring"success". שגיאות מחזירות "error".
campaign_idintegerהמזהה של משימת האימות.
campaign_namestringשם המשימה.
overall_statusstringpending, processing או completed. ראו ערכי סטטוס כללי.
progress.totalintegerמספר המספרים במשימה.
progress.pendingintegerמספרים שעוד לא נבדקו.
progress.verifiedintegerמספרים שרשומים ב-WhatsApp.
progress.invalidintegerמספרים שסומנו invalid (לא ב-WhatsApp, לא מספר תקין, או בדיקה שנכשלה).
progress.completed_percentagenumberהמספרים שנבדקו (verified + invalid) כאחוז מתוך total, מעוגל ל-2 ספרות אחרי הנקודה.
resultsarrayכל המספרים במשימה, ממוינים לפי מספר. כל הרשימה מוחזרת בבת אחת, בלי חלוקה לדפים.
results[].numberstringמספר הטלפון המנוקה.
results[].statusstringpending, verified, invalid או unknown. ראו ערכי סטטוס של מספר.
results[].checked_atstring or nullמתי המספר נבדק, או null כל עוד הוא ממתין.
results[].created_atstringמתי המספר נוסף.
created_atstringמתי המשימה נוצרה.
last_updatedstringמתי רשומת המשימה שונתה לאחרונה. הערך לא משתנה כשמספרים נבדקים, לכן השתמשו ב-checked_at כדי לראות פעילות אחרונה.

כל חותמות הזמן הן בפורמט ISO 8601 לפי UTC, עם מיקרו-שניות והפרש +00:00, למשל 2026-09-16T10:16:12.204551+00:00.

ערכי סטטוס של מספר#

ערךמשמעות
pendingממתין לבדיקה.
verifiedהמספר רשום ב-WhatsApp.
invalidהמספר לא רשום ב-WhatsApp, אינו מספר טלפון תקין, או שלא ניתן היה לבדוק אותו בגלל שגיאת עיבוד. אם מספר שאתם מצפים שיהיה תקין מוצג כ-invalid, אמתו אותו שוב במשימה חדשה.
unknownהבדיקה בוטלה על ידי התמיכה של Wbiztool. עיבוד רגיל לא מגדיר את הערך הזה.

ערכי סטטוס כללי#

ערךמשמעות
pendingעוד לא נבדק אף מספר.
processingחלק מהמספרים נבדקו וחלק עדיין ממתינים.
completedאין מספרים ממתינים.

משימה במצב completed יכולה להציג completed_percentage נמוך מ-100 אם חלק מהבדיקות בוטלו, כי מספרים שהבדיקה שלהם בוטלה נספרים ב-total אבל לא באחוז.

שגיאות#

שגיאות מחזירות גוף JSON עם status שמוגדר ל-"error" וקוד שגיאת HTTP:

{ "status": "error", "message": "Campaign not found" }
HTTPהודעהאיך לתקן
405Only GET method allowedשלחו בקשת GET.
401API key requiredהוסיפו את הכותרת Authorization: Bearer YOUR_API_KEY.
401Invalid API keyודאו שהמפתח קיים ולא נמחק או הושבת.
400campaign_id is requiredהוסיפו campaign_id ל-query string.
404Campaign not foundהמזהה לא קיים, אינו משימת אימות, או שייך לסביבת עבודה אחרת. השתמשו במפתח מסביבת העבודה שיצרה את המשימה.
500Internal server error: …לרוב campaign_id אינו מספר. שלחו ספרות בלבד.

טיפים#

  • בדקו בעדינות. עד 10 מספרים נבדקים ברקע בכל ריצה, כך שבדיקה כל 30 עד 60 שניות מספיקה בהחלט, ומשימה גדולה יכולה להימשך זמן רב.
  • הפסיקו לבדוק כש-overall_status הוא completed.
  • תקוע על pending? אימות דורש מספר WhatsApp שמחובר בדף הגדרות WhatsApp באותה סביבת עבודה. בלעדיו, המספרים אף פעם לא נבדקים. הבדיקות גם ממתינות בזמן שהמספר המחובר שלכם עסוק בשליחת הודעות.
  • משימות גדולות: ה-endpoint הזה מחזיר את כל המספרים בתגובה אחת. כדי לקרוא תוצאות דף אחר דף, או רק את המספרים במצב verified, השתמשו ב-תוצאות אימות.