انتقل إلى المحتوى
Wbiztool

API التحقق من الأرقام

إنشاء تحقق من أرقام WhatsApp ‏(API)

تحقّق مما إذا كانت قائمة من أرقام الهواتف مسجّلة على WhatsApp قبل مراسلتها. استخدمه لتنظيف قوائم جهات الاتصال المستوردة، أو للتحقق من أرقام التسجيل، أو لإزالة الأرقام التي لن تؤدي إلا إلى الفشل.

POSThttps://wbiztool.com/api/v1/verification/create/

النص (Body): JSON (application/json)

ينشئ الطلب مهمة تحقق ويُرجع 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"]
  }'

استبدل YOUR_API_KEY بمفتاح من Settings → API keys (الإعدادات ← مفاتيح API). المفتاح هو الذي يحدّد مساحة العمل التي تنتمي إليها المهمة.

معاملات الطلب#

الترويسة

Authorizationheaderمطلوب

‏Bearer YOUR_API_KEY. يجب أن يكون المفتاح نشطًا وغير محذوف. لا حاجة إلى client_id في هذا API.

Content-Typestringمطلوب

يجب أن تكون application/json. مع أي نوع محتوى آخر، لا يُقرأ numbers وستحصل على Numbers array is required.

الجسم

numbersarray of stringsمطلوب

أرقام الهواتف المراد التحقق منها، كل رقم مع رمز الدولة، مثل 919876543210 لرقم هندي. قبل التحقق، يُنظَّف كل رقم:

  • تُزال المسافات و+ و- والأقواس
  • يُزال صفر 0 بادئ واحد
  • يجب أن تحتوي النتيجة على أرقام فقط وأن تتكون من 10 أرقام على الأقل

تُستبعد الأرقام التي لا تجتاز ذلك بصمت. لا تُحذف الأرقام المكررة، لذا يُتحقق من كل نسخة على حدة.

campaign_namestringاختياري

اسم للعثور على المهمة في لوحة التحكم. إذا حذفته، يكون الاسم API Verification متبوعًا بتاريخ الخادم ووقته بتوقيت IST ‏(UTC+5:30)، مثل API Verification 20260916_154500. يمكن أن يصل طول الاسم إلى 500 حرف. لا ترسل null: الأسماء الأطول أو القيمة null تفشل مع HTTP 500.

الاستجابة#

يُرجع الطلب الناجح HTTP 200:

{
  "status": "success",
  "message": "Verification task created successfully",
  "campaign_id": 4521,
  "numbers_count": 3,
  "numbers_submitted": ["919876543210", "919876543211", "14155550123"]
}
الحقلالنوعالوصف
statusstring‏"success". تُرجع الأخطاء "error".
messagestring‏Verification task created successfully.
campaign_idintegerمعرّف مهمة التحقق. استخدمه مع حالة التحقق ونتائج التحقق.
numbers_countintegerعدد الأرقام التي قُبلت بعد التنظيف.
numbers_submittedarray of stringsالأرقام المنظّفة التي سيُتحقق منها. قارنها بما أرسلته لمعرفة الأرقام التي استُبعدت.

يبدأ كل رقم مقبول بالحالة pending. وتظهر المهمة أيضًا في صفحة التحقق من الأرقام في لوحة التحكم. قد تظل بطاقتها هناك تعرض Processing (قيد المعالجة) حتى بعد انتهائها، لذا استخدم حالة التحقق لمعرفة الحالة الفعلية.

الأخطاء#

تُرجع الأخطاء جسم JSON مع status بقيمة "error" ورمز خطأ HTTP:

{ "status": "error", "message": "No valid phone numbers found" }
HTTPالرسالةطريقة الإصلاح
405Only POST method allowedأرسل طلب POST.
401API key requiredأضف الترويسة Authorization: Bearer YOUR_API_KEY.
401Invalid API keyتأكد من أن المفتاح موجود ولم يُحذف أو يُعطَّل.
403Verification feature not available for your planباقتك لا تتضمن التحقق من الأرقام. قم بترقية باقتك.
400Numbers array is requiredأرسل numbers كمصفوفة JSON غير فارغة، مع Content-Type: application/json.
400No valid phone numbers foundلم يحتوِ أي رقم على 10 أرقام أو أكثر بعد التنظيف. ضمّن رمز الدولة.
400Request contains N numbers but your plan allows only M verificationsباقتك تحدّ من عدد الأرقام في الطلب الواحد. قسّم القائمة إلى طلبات أصغر.
500Internal server error: …غالبًا يكون جسم JSON غير صالح، مثلًا بسبب فاصلة زائدة في النهاية.

كيف يُتحقق من الأرقام#

  1. تدخل المهمة قائمة الانتظار

    يخزّن API كل رقم مقبول بالحالة pending ويستجيب فورًا.

  2. يتحقق منها رقم WhatsApp متصل

    يُتحقق من الأرقام بمعدل 10 أرقام كحد أقصى في كل مرة باستخدام رقم WhatsApp متصل في إعدادات WhatsApp. يصبح كل رقم verified إذا كان مسجّلًا على WhatsApp، أو invalid إذا لم يكن كذلك. لا تُجرى الفحوص إلا على رقم متصل غير مشغول بإرسال الرسائل، لذا قد تنتظر أثناء حملة كبيرة حتى ينتهي الإرسال.

  3. تقرأ النتائج

    استعلم من حالة التحقق حتى تصبح قيمة overall_status هي completed، ثم اقرأ الأرقام من الاستجابة نفسها أو من نتائج التحقق.

نصائح#

  • ضمّن رمز الدولة دائمًا. الرقم المحلي المكوّن من 10 أرقام بدون رمز الدولة يجتاز فحص الطول، لكنه يُتحقق منه كما هو مكتوب تمامًا، فلن تكون النتيجة للرقم الذي قصدته.
  • لا تستخدم البادئة الدولية 00. يُزال صفر بادئ واحد فقط، لذا يُتحقق من 00919876543210 على أنه 0919876543210. أرسل 919876543210.
  • احذف الأرقام المكررة بنفسك قبل الإرسال، حتى لا تستهلك حد باقتك لكل طلب على التكرارات.
  • تحقّق من numbers_submitted لمعرفة الأرقام التي استُبعدت لأنها قصيرة جدًا أو تحتوي على أحرف.
  • القوائم الكبيرة: إذا بلغت الحد لكل طلب، فأرسل عدة مهام أصغر وتتبّع كل campaign_id.

جديد على التحقق من الأرقام؟ راجع دليل التحقق من الأرقام.