جلب قسم 'حول' لجهة الاتصال

الحصول على نص 'حول' (الحالة) لجهة اتصال.

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

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

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

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

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

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

توصيات

  • قم بتخزين هذه القيمة مؤقتًا؛ نادرًا ما يغير المستخدمون نص الحول الخاص بهم.

  • استخدم هذا لتخصيص واجهة المستخدم بالحالة المزاجية الحالية لجهة الاتصال.

قسم "حول" (الحالة سابقاً)

تسترجع نقطة النهاية /v2/contacts/about الحالة النصية للمستخدم (مثل: "متوفر"، "في النادي الرياضي"، "البطارية على وشك النفاد").


📜 لبس في المصطلحات

"أليست الحالة هي القصة؟"

  • واتساب القديم: كان النص الموجود تحت اسمك يسمى "الحالة" (Status).
  • واتساب الجديد: تشير "الحالة" الآن إلى القصص المؤقتة لـ 24 ساعة. تم تغيير اسم الحقل النصي إلى "حول" (About).
  • هذه الواجهة: تسترجع الحقل النصي، وليس طبقة القصص.

🔍 حالات الاستخدام

1. اكتشاف التوافر

لا يزال العديد من المستخدمين يستخدمون هذا الحقل لغرضه المقصود (مثلاً: "في اجتماع"، "نائم"، "للمكالمات الطارئة فقط").

2. التحقق من الهوية

تضع بعض الشركات موقعها الرسمي أو تفاصيل التحقق في قسم "حول".


🛡️ حواجز الخصوصية

تماماً مثل صور الملف الشخصي، يخضع هذا الحقل لإعدادات الخصوصية.

  • الافتراضي: "جهات اتصالي".
  • النتيجة: إذا راسلت مستخدماً جديداً، فمن المرجح أن تتلقى قيمة فارغة حتى يقوم بحفظ رقمك.

🚦 حدود المعدل

يتطلب جلب نص "حول" استعلاماً من خوادم واتساب الأساسية.

  • التخزين المؤقت: تقوم الواجهة بتخزين هذه القيمة لمدة 48 ساعة لأن المستخدمين نادراً ما يغيرونها.

البارامترات

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

معاملات الاستعلام والطلب (Query & Body Parameters)

تدعم التمرير عبر الرابط (Query String) أو كـ JSON Body
string

معرف الجلسة الفريد (Instance ID) الخاص برقمك

مثال:
string

مفتاح الوصول السري للـ API (Access Token)

مثال:
string

المعرف الفريد لجهة الاتصال

مثال:

برمج بالذكاء الاصطناعي باستخدام Wawp MCP

MCP READY

قم بربط الـ API مباشرة مع Cursor أو Windsurf أو Claude Desktop، ودع الذكاء الاصطناعي يكتب لك كود الربط وينفذه تلقائياً!

طريقة الربط والإعداد

أمثلة الكود

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

1const baseUrl = "https://api.wawp.net";
2const endpoint = "/v2/contacts/about";
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) مع أمثلة للبيانات لتسهيل معالجة الأخطاء والنجاح.

About info retrieved
application/json
string *

Example

{
"about": "Available"
}
طلب غير صالح - تنسيق المعامل غير صالح
غير مصرح - مفتاح الوصول غير صالح أو مفقود
خطأ في الخادم الداخلي - فشل غير متوقع
الموضوع السابقالتحقق من رقم على واتساب
الموضوع التاليجلب صورة الملف الشخصي

Command Palette

Search for a command to run...