جلب قسم 'حول' لجهة الاتصال
الحصول على نص 'حول' (الحالة) لجهة اتصال.
تسجيل الدخول مطلوب
سجل الدخول لاستبدال المعرفات (Instance ID) ورمز الوصول (Access Token) بمعلومات حسابك الحقيقي لاختبار ال API مباشرة.
تسجيل الدخوللا توجد معاملات استعلام مطلوبة
هذه النهاية الطرفية لا تتوقع بيانات في الرابط.
توصيات
قم بتخزين هذه القيمة مؤقتًا؛ نادرًا ما يغير المستخدمون نص الحول الخاص بهم.
استخدم هذا لتخصيص واجهة المستخدم بالحالة المزاجية الحالية لجهة الاتصال.
قسم "حول" (الحالة سابقاً)
تسترجع نقطة النهاية /v2/contacts/about الحالة النصية للمستخدم (مثل: "متوفر"، "في النادي الرياضي"، "البطارية على وشك النفاد").
📜 لبس في المصطلحات
"أليست الحالة هي القصة؟"
- واتساب القديم: كان النص الموجود تحت اسمك يسمى "الحالة" (Status).
- واتساب الجديد: تشير "الحالة" الآن إلى القصص المؤقتة لـ 24 ساعة. تم تغيير اسم الحقل النصي إلى "حول" (About).
- هذه الواجهة: تسترجع الحقل النصي، وليس طبقة القصص.
🔍 حالات الاستخدام
1. اكتشاف التوافر
لا يزال العديد من المستخدمين يستخدمون هذا الحقل لغرضه المقصود (مثلاً: "في اجتماع"، "نائم"، "للمكالمات الطارئة فقط").
2. التحقق من الهوية
تضع بعض الشركات موقعها الرسمي أو تفاصيل التحقق في قسم "حول".
🛡️ حواجز الخصوصية
تماماً مثل صور الملف الشخصي، يخضع هذا الحقل لإعدادات الخصوصية.
- الافتراضي: "جهات اتصالي".
- النتيجة: إذا راسلت مستخدماً جديداً، فمن المرجح أن تتلقى قيمة فارغة حتى يقوم بحفظ رقمك.
🚦 حدود المعدل
يتطلب جلب نص "حول" استعلاماً من خوادم واتساب الأساسية.
- التخزين المؤقت: تقوم الواجهة بتخزين هذه القيمة لمدة 48 ساعة لأن المستخدمين نادراً ما يغيرونها.
البارامترات
قم بتهيئة المعاملات المطلوبة للتفاعل مع نقطة النهاية هذه. جميع وسائط الاستعلام والبيانات مدرجة أدناه مع تفاصيلها.
معاملات الاستعلام والطلب (Query & Body Parameters)
تدعم التمرير عبر الرابط (Query String) أو كـ JSON Bodystring | معرف الجلسة الفريد (Instance ID) الخاص برقمك مثال: | ||
string | مفتاح الوصول السري للـ API (Access Token) مثال: | ||
string | المعرف الفريد لجهة الاتصال مثال: |
برمج بالذكاء الاصطناعي باستخدام Wawp MCP
MCP READYقم بربط الـ API مباشرة مع Cursor أو Windsurf أو Claude Desktop، ودع الذكاء الاصطناعي يكتب لك كود الربط وينفذه تلقائياً!
أمثلة الكود
استخدم أمثلة الكود الجاهزة لدمج واجهة برمجة التطبيقات (API) في مشروعك بسرعة وكفاءة. اختر لغة البرمجة والمكتبة التي تفضلها.
الردود المتوقعة
استكشف كافة الردود والنتائج المحتملة من الخادم. قمنا بتوثيق كل كود حالة (Status Code) مع أمثلة للبيانات لتسهيل معالجة الأخطاء والنجاح.
Example
{
"about": "Available"
}Command Palette
Search for a command to run...