التحقق من أرقام WhatsApp والاستعلام عن الملفات الشخصية APIs
واجهة التحقق من WhatsApp: اكتشف ما إذا كان الرقم على WhatsApp، واحصل على الصورة الشخصية، وحالة About، وحالة الاتصال، وملف الأعمال. تحقّق فوري من خطوتين واستعلام عن البيانات العامة. واجهة JSON مناسبة للتحقق من العملاء المحتملين، وإثراء جهات الاتصال، وأنظمة CRM، وقابلية الوصول عبر الرسائل. تستخدم البيانات العامة فقط.
فحص الوجود (بالرقم الكامل)
فحص وجود خفيف لرقم واحد — يُرجع فقط ما إذا كان الرقم مسجّلًا على WhatsApp، دون جلب الملف الشخصي/الصورة/تفاصيل الأعمال، وهو أرخص من الاستعلام الكامل عن الملف الشخصي. عندما تكون isExist=true، تتضمّن الاستجابة أيضًا userHash، والذي يجب تمريره إلى واجهات الملف الشخصي (للحصول على الصورة/About/ملف الأعمال/حالة الاتصال) لتفويض الاستعلامات الأثقل. تقوم الخادمية تلقائيًا بفصل رمز الدولة من الرقم الكامل، وتُعيد countryCode للتحقّق.
فحص الوجود (رمز الدولة + الرقم منفصلين)
مماثل لـ«فحص الوجود»، لكن يُمرَّر رمز الدولة والرقم المحلي كمعاملين منفصلين. استخدمه عندما تعرف رمز الدولة وترغب في تخطّي الفصل التلقائي في الخادمية. عندما تكون isExist=true، تتضمّن الاستجابة كذلك userHash القابل للتمرير إلى واجهات الملف الشخصي.
الحصول على الصورة الشخصية (صورة الملف الشخصي)
احصل على الصورة الشخصية العامة (DP) لمستخدم WhatsApp. تدفّق من خطوتين: استدعِ أولًا واجهة فحص الوجود للحصول على userHash للرقم المستهدف، ثم مرّره هنا. تُرفض الاستدعاءات بدون userHash صالح (أو منتهٍ/غير معروف). يُحلّ الرقم على جانب الخادم بواسطة userHash، ولا يُقبل تمرير الرقم كمعامل. إذا لم يكن للمستخدم صورة أو كانت مخفية بسبب الخصوصية، تكون hasAvatar=false. يمكن استخدام type لاختيار الصورة الأصلية أو معاينة مصغّرة بحجم صغير.
الحصول على نص About / الحالة
احصل على نص About (توقيع الحالة) للمستخدم ووقت تعيينه. تدفّق من خطوتين: احصل أولًا على userHash عبر واجهة فحص الوجود، ثم مرّره هنا. يُرفض userHash غير الصالح/المنتهي. عند عدم التعيين / الخصوصية (جهات الاتصال فقط) / عدم التسجيل، يُعاد about=null.
الحصول على ملف الأعمال
احصل على ملف الأعمال على WhatsApp: اسم النشاط، مستوى التوثيق، النبذة، العنوان، البريد الإلكتروني، الموقع الإلكتروني، ووقت الانضمام وغيرها. تدفّق من خطوتين: احصل أولًا على userHash عبر واجهة فحص الوجود، ثم مرّره هنا. يُرفض userHash غير الصالح/المنتهي. تُعيد الأرقام الشخصية (غير التجارية) isBusiness=false.
الحصول على حالة الاتصال / آخر ظهور
احصل على حالة الاتصال / وقت آخر ظهور. مقيّد بشدّة بخصوصية الهدف: إذا لم يكن الطرف الطالب من جهات اتصاله، ولم تكن خصوصية آخر ظهور/الاتصال لدى الهدف مضبوطة على «الجميع»، فلن تُرسَل حالة الاتصال، وتكون visible=false (نتيجة حقيقية لا يمكن تجاوزها). تدفّق من خطوتين: احصل أولًا على userHash عبر واجهة فحص الوجود، ثم مرّره هنا. قد يستغرق الاستدعاء الواحد نحو 17 ثانية كحدّ أقصى.
فحص حالة النشاط
تحقّق فوريًا مما إذا كان الرقم مسجّلًا ونشطًا على WhatsApp. يُعيد علامة النشاط مباشرةً للرقم الدولي الكامل — فحص مستقل لا يحتاج إلى userHash. مناسب للتحقّق السريع نعم/لا في تدفّقات التسجيل وتنقية القوائم.
فحص مجمّع (حتى 10 أرقام)
افحص حتى 10 أرقام في طلب واحد لمعرفة ما إذا كانت مسجّلة على WhatsApp، مع إرجاع حالة exist وisBusiness لكل رقم. مرّر قائمة الأرقام مفصولة بفواصل. مناسب للتحقّق من دفعة صغيرة من الأرقام دفعة واحدة.