يتحقق مما إذا كان رقم الهاتف مسجلاً على واتساب.

مكافحة الكشط

قد تؤدي الشيكات المفرطة على أرقام عشوائية إلى الإبلاغ عن حسابك ككاشط.

جهات الاتصال

التحقق من رقم على واتساب

التحقق مما إذا كان رقم الهاتف مسجلاً في واتساب.

GET

https://api.wawp.net/v2/contacts/check-exists?access_token=123456789&instance_id=123456789&phone=1234567890

تسجيل الدخول مطلوب

سجل الدخول لاستبدال المعرفات (Instance ID) ورمز الوصول (Access Token) بمعلومات حسابك الحقيقي لاختبار ال API مباشرة.

تسجيل الدخول

اختبار /v2/contacts/check-exists

يدعم

GET

لا توجد معاملات استعلام مطلوبة

هذه النهاية الطرفية لا تتوقع بيانات في الرابط.

توصيات

تحقق من صحة الأرقام قبل إرسال رسالتك الأولى لتحسين معدلات التسليم.
لا تستخدم هذا 'لإحماء' الأرقام؛ استخدامه بصرامة للتحقق.

حارس البوابة: التحقق من أرقام الهواتف

نقطة النهاية /v2/contacts/check-exists هي خط دفاعك الأول ضد البيانات منخفضة الجودة. فهي تستعلم من دليل واتساب العالمي للتحقق مما إذا كان رقم الهاتف يوافق حساب واتساب نشطاً.

🏗️ لماذا هذا أمر بالغ الأهمية؟

إرسال رسائل إلى أرقام غير صالحة هو أحد أسرع الطرق لتعرض الحساب للحظر.

الإشارة: إذا حاولت مراسلة رقم غير موجود وفشلت، فإن خوارزميات واتساب تصنف حسابك كـ "مرسل عشوائي".
الحل: تحقق من 100% من الأرقام الجديدة باستخدام هذه الواجهة قبل إرسال رسالتك الأولى.

🚦 حدود المعدل والأمان

تجري هذه الواجهة عملية بحث في الشبكة في الوقت الفعلي.

الحد: يجب ألا تتجاوز عملية تحقق واحدة في الثانية لكل مثيل.
خطر "المسح" (Scraping): إذا قمت بإدخال قائمة تسلسلية (مثل +15550001, +15550002...)، فسيقوم واتساب باكتشاف نمط المسح وحظر رقمك نهائياً.
أفضل ممارسة: تحقق فقط من الأرقام التي قدمها المستخدمون لك صراحة. لا تستخدم هذا "لتنظيف" قاعدة بيانات مشتراة.

🔮 أنماط التكامل

النمط أ: نموذج التسجيل

يسجل المستخدم في موقعك.
يستدعي النظام /v2/contacts/check-exists.
النتيجة: إذا كان الرقم موجوداً، أظهر شعار "واتساب" بجانب رقمه، وإذا لم يكن موجوداً، قم بتعطيل زر "إرسال عبر واتساب" أو استخدم SMS كبديل.

النمط ب: منظف CRM

إذا كان لديك 10,000 رقم قديم، لا تفحصها جميعاً الآن. انتظر حتى يحين وقت مراسلة أحدهم، وافحصه "في الوقت المناسب" (JIT) قبل ثانية واحدة من الإرسال.

❓ الأسئلة الشائعة

س: هل يعرف المستخدم أنني تحققت من رقمه؟ أ: لا. هذه عملية بحث صامتة في الدليل. لا تسبب إشعاراً أو أي ظهور لدى المستخدم.

س: هل يمكنني الحصول على صورته هنا؟ أ: لا. هذه الواجهة تعيد نتيجة منطقية (موجود/غير موجود) فقط. للحصول على الصورة، يجب أولاً تأكيد الوجود ثم استدعاء /v2/contacts/profile-picture.

البارامترات

قم بتهيئة المعاملات المطلوبة للتفاعل مع نقطة النهاية هذه. جميع وسائط الاستعلام والبيانات مدرجة أدناه مع تفاصيلها.

بارامترات الرابط

جزء من مسار الرابط أو استعلام

	`string`		Your unique WhatsApp Instance ID مثال:
	`string`		Your API Access Token مثال:
	`string`		رقم الهاتف المراد التحقق منه (أرقام فقط) مثال:

أمثلة الكود

استخدم أمثلة الكود الجاهزة لدمج واجهة برمجة التطبيقات (API) في مشروعك بسرعة وكفاءة. اختر لغة البرمجة والمكتبة التي تفضلها.

1const baseUrl = "https://api.wawp.net";
2const endpoint = "/v2/contacts/check-exists";
3const params = new URLSearchParams({
4  "instance_id": "123456789",
5  "access_token": "123456789",
6  "phone": "1234567890"
7}).toString();
8
9
10fetch(`${baseUrl}${endpoint}${params ? '?' + params : ''}`, {
11  method: "GET",
12  headers: { "Content-Type": "application/json" },
13  
14})
15  .then(async (response) => {
16    if (response.ok) {
17      const data = await response.json();
18      console.log("Success:", data);
19      return data;
20    }
21    
22    // Error Handling
23    if (response.status === 401) {
24      console.error("Error 401: غير مصرح - مفتاح الوصول غير صالح أو مفقود");
25    }
26    if (response.status === 400) {
27      console.error("Error 400: طلب غير صالح - تنسيق المعامل غير صالح");
28    }
29    if (response.status === 500) {
30      console.error("Error 500: خطأ في الخادم الداخلي - فشل غير متوقع");
31    }
32
33    const errorText = await response.text();
34    console.error(`Error ${response.status}: ${errorText}`);
35  })
36  .catch((error) => console.error("Network Error:", error));

عينات تفاعليةUTF-8

Ln 36, Col 1javascript

الردود المتوقعة

استكشف كافة الردود والنتائج المحتملة من الخادم. قمنا بتوثيق كل كود حالة (Status Code) مع أمثلة للبيانات لتسهيل معالجة الأخطاء والنجاح.

Check completed

application/json

boolean *

string *

Example

{
"exists": true,
"jid": "1234567890@c.us"
}

طلب غير صالح - تنسيق المعامل غير صالح

غير مصرح - مفتاح الوصول غير صالح أو مفقود

Command Palette

Search for a command to run...