الحصول على التواجد العام

احصل على حالة التواجد الحالية (متصل/غير متصل) للجلسة المصرح بها.

GET
https://api.wawp.net/v2/presence?access_token=123456789&instance_id=123456789

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

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

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

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

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

مرآتي يا مرآتي: التحقق من انعكاسك الخاص

تسمح لك نقطة النهاية /v2/presence (بواسطة GET) بالتحقق برمجياً من كيفية ظهور جلسة واتساب الخاصة بك للعالم الخارجي. في حين يمكنك تعيين حالتك باستخدام طريقة POST، فإن طريقة GET هذه حاسمة للتدقيق والمزامنة.


🏗️ التحقق من الحالة

لماذا تتحقق من حالتك الخاصة؟

1. حلقات التدقيق

إذا كنت تدير أسطولاً من 50 بوت دعم، فأنت بحاجة إلى لوحة تحكم لمعرفة أي منها "متصل" حالياً ويقبل الدردشات.

  • تنبيه: إذا كان من المفترض أن يكون البوت متصلاً ولكنه يعيد offline، فقم بتشغيل تنبيه لفريق الهندسة. قد تكون الجلسة قد توقفت أو تم تبديلها يدوياً بواسطة إنسان باستخدام تطبيق الهاتف.

2. مزامنة واجهة المستخدم

إذا كنت تبني نظام CRM مخصصاً مع زر تبديل "انتقل إلى وضع الاتصال":

  • الحل: استدعِ نقطة النهاية هذه عند تحميل الصفحة. إذا أعادت available، فاجعل الزر باللون الأخضر (نشط).

🔄 حلقة الملاحظات

نمط "التصحيح التلقائي"

يمكن أن تنحرف جلسات واتساب أحياناً. على سبيل المثال، إذا فقد الهاتف الفعلي الاتصال بالإنترنت لمدة 10 دقائق، فقد يتم تمييز الجلسة تلقائياً كـ unavailable.

  1. مهمة مجدولة تعمل كل 5 دقائق.
  2. الخطوة أ: استدعاء GET /v2/presence.
  3. الخطوة ب: إذا كانت النتيجة offline والحالة المتوقعة هي online -> استدعاء POST /v2/presence لفرض العودة للوضع النشط.

البارامترات

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

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

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

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

مثال:
string

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

مثال:

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

MCP READY

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

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

أمثلة الكود

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

1const baseUrl = "https://api.wawp.net";
2const endpoint = "/v2/presence";
3const params = new URLSearchParams({
4 "instance_id": "123456789",
5 "access_token": "123456789"
6}).toString();
7
8
9fetch(`${baseUrl}${endpoint}${params ? '?' + params : ''}`, {
10 method: "GET",
11 headers: { "Content-Type": "application/json" },
12
13})
14 .then(async (response) => {
15 if (response.ok) {
16 const data = await response.json();
17 console.log("Success:", data);
18 return data;
19 }
20
21 // Error Handling
22 if (response.status === 400) {
23 console.error("Error 400: طلب غير صالح - معاملات مطلوبة مفقودة");
24 }
25 if (response.status === 400) {
26 console.error("Error 400: طلب غير صالح (تنسيق XML)");
27 }
28 if (response.status === 400) {
29 console.error("Error 400: طلب غير صالح (نص عادي)");
30 }
31 if (response.status === 401) {
32 console.error("Error 401: غير مصرح - مفتاح الوصول غير صالح أو مفقود");
33 }
34 if (response.status === 401) {
35 console.error("Error 401: غير مصرح (تنسيق XML)");
36 }
37 if (response.status === 404) {
38 console.error("Error 404: غير موجود - الجلسة غير موجودة");
39 }
40 if (response.status === 404) {
41 console.error("Error 404: غير موجود (تنسيق XML)");
42 }
43 if (response.status === 500) {
44 console.error("Error 500: خطأ في الخادم الداخلي - فشل غير متوقع");
45 }
46 if (response.status === 500) {
47 console.error("Error 500: خطأ في الخادم الداخلي (HTML)");
48 }
49 if (response.status === 502) {
50 console.error("Error 502: بوابة غير صالحة - فشل الاتصال بالخادم الرئيسي");
51 }
52 if (response.status === 502) {
53 console.error("Error 502: بوابة غير صالحة (تنسيق XML)");
54 }
55
56 const errorText = await response.text();
57 console.error(`Error ${response.status}: ${errorText}`);
58 })
59 .catch((error) => console.error("Network Error:", error));
عينات تفاعلية
Ln 59, Col 1javascript

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

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

Presence status retrieved
النوع:
السيناريو:
application/json
string *

Example

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

Command Palette

Search for a command to run...