جهات الاتصال

جلب معلومات جهة الاتصال

الحصول على المعلومات الأساسية لجهة اتصال محددة.

GET
https://api.wawp.net/v2/contacts?access_token=123456789&contactId=123456789%40c.us&instance_id=123456789

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

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

تسجيل الدخول
اختبار /v2/contacts
GET
GET

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

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

توصيات

  • استخدم 'اسم الإشعار' إذا لم تكن جهة الاتصال محفوظة في دفتر العناوين الخاص بك.

  • قم بتحديث سجلك المحلي إذا تغيرت تفاصيل جهة الاتصال.

من هذا؟ الحصول على تفاصيل جهة الاتصال

تسترجع نقطة النهاية /v2/contacts/[chatId] البيانات العامة لأي مستخدم واتساب صالح. هذه أداتك الأساسية "لإثراء" ملفات تعريف المستخدمين في تطبيقك.

🧩 فهم حقول البيانات

عند جلب جهة اتصال، تتلقى عدة حقول قد تبدو زائدة عن الحاجة ولكنها تخدم أغراضاً مختلفة تماماً.

1. id._serialized (المفتاح)

  • القيمة: 15551234567@c.us
  • الاستخدام: هذا هو المفتاح الأساسي غير القابل للتغيير. قم دائماً بتخزين هذا في قاعدة بياناتك. لا تحاول معالجة رقم الهاتف يدوياً؛ تعامل مع السلسلة بأكملها كمعرف.

2. pushname (الاسم العام)

  • القيمة: "Alice"
  • المصدر: هذا هو الاسم الذي وضعه المستخدم لنفسه في إعدادات واتساب. هي المرجعية للأشخاص الذين لم يسبق لك تخزينهم.

3. name (الاسم المحلي)

  • القيمة: "Alice from Gym"
  • المصدر: هذا هو الاسم الذي قمت أنت بحفظه في دفتر عناوين هاتفك لهذا الرقم.
  • الأولوية: في واجهة المستخدم، يجب عليك عادةً عرض name (إذا كان متاحاً) كبديل لـ pushname.

4. number (رقم الهاتف النظيف)

  • القيمة: 15551234567
  • الاستخدام: رقم MSISDN الخام بدون لاحقة @c.us.

🏢 علامات الأعمال والشركات

ترجع الواجهة علامتين تساعدانك في تصنيف المستخدمين:

  • isBusiness: إذا كانت true تعني أن المستخدم يستخدم تطبيق "واتساب للأعمال".
  • isEnterprise: إذا كانت true تعني أن المستخدم يستخدم "واجهة برمجة تطبيقات واتساب للأعمال" (Cloud API). هذا يعني غالباً أنه بوت أو شركة كبيرة. قد ترغب في تعطيل ردودك التلقائية في هذه الحالة لتجنب الحلقات اللانهائية.

🔍 الخصوصية وبيانات "الشبح"

إذا استعلمت عن رقم صالح وحصلت على بيانات محدودة:

  • السبب: المستخدم لديه إعدادات خصوصية صارمة.
  • الإجراء: لا شيء، لا يمكن للواجهة إجبار البيانات على الظهور. يجب عليك عرض قيمة افتراضية (مثلاً "مستخدم واتساب").

البارامترات

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

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

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

Your unique WhatsApp Instance ID

مثال:
string

Your API Access Token

مثال:
string

المعرف الفريد لجهة الاتصال (مثال: 123456789@c.us)

مثال:

أمثلة الكود

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

1const baseUrl = "https://api.wawp.net";
2const endpoint = "/v2/contacts";
3const params = new URLSearchParams({
4  "instance_id": "123456789",
5  "access_token": "123456789",
6  "contactId": "123456789@c.us"
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));
عينات تفاعلية
Ln 36, Col 1javascript

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

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

Contact info retrieved successfully
application/json
string *
string *
string *
boolean *
boolean *

Example

{
"id": "123456789@c.us",
"name": "John Doe",
"pushname": "John",
"isBusiness": false,
"isEnterprise": false
}
طلب غير صالح - تنسيق المعامل غير صالح
غير مصرح - مفتاح الوصول غير صالح أو مفقود
خطأ في الخادم الداخلي - فشل غير متوقع
الموضوع السابقجلب جميع جهات الاتصال
الموضوع التاليالتحقق من رقم على واتساب

Command Palette

Search for a command to run...