الحصول على تواجد الدردشة

يسترجع معلومات التواجد الحالية لمعرف دردشة معين.

GET
https://api.wawp.net/v2/presence/{chatId}?access_token=YOUR_ACCESS_TOKEN&chatId=123456789%40c.us&instance_id=123456789

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

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

تسجيل الدخول
اختبار /v2/presence/{chatId}
GET
GET

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

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

توصيات

  • استخدم هذا باعتدال؛ الاقتراع المستمر محدود المعدل.

  • اشترك في تحديثات الحضور بدلاً من الاقتراع.

رؤية الأشباح: التحقق من تواجد المستخدم

تسمح نقطة النهاية /v2/presence/{chatId} لنظامك بالاستعلام عن حالة "متصل" لمستخدم أو جهة اتصال معينة على واتساب. عند استخدامها بشكل صحيح، فإنها تحول البوت الخاص بك من "مجيب آلي بسيط" إلى "مساعد مدرك للسياق".


🎯 فلسفة "اللقطة"

من الضروري فهم أن نقطة النهاية هذه توفر لقطة في الوقت الحالي، وليست تدفقاً مستمراً.

  • الاستجابة: "المستخدم 12345 متصل الآن."
  • الواقع: قد يغلقون التطبيق بعد ثانية واحدة.
  • أفضل ممارسة: تعامل مع حالة online كإشارة قوية بأن المستخدم يمسك بهاتفه، ولكن ليس كضمان للرد.

🏗️ سير العمل التقني

1. التحقق قبل الإرسال

قبل إرسال رسالة عالية القيمة (مثل رمز التحقق أو تنبيه زمني)، استدعِ نقطة النهاية هذه.

  • إذا كان "متصل": أرسلها عبر واتساب فوراً. احتمالية قراءة عالية في غضون 10 ثوانٍ.
  • إذا كان "غير متصل":
    • الخيار أ: أرسلها على أي حال (تسليم قياسي).
    • الخيار ب (ذكي): أرسلها عبر SMS كبديل إذا كانت الرسالة حرجة.

2. حاجز الخصوصية

تحترم نقطة النهاية هذه إعدادات الخصوصية للمستخدم على هاتفه.

  • النتيجة: إذا كان المستخدم يخفي حالته، فستتلقى دائماً offline حتى لو كان يدردش معك الآن.

3. حدود المعدل ومنع الحظر

تحذير: هذه هي النقطة الأكثر حساسية في مجموعة واجهة برمجة التطبيقات بأكملها.

  • النمط الممنوع: إذا قمت بالمرور على 1000 رقم للتحقق من "هل أنت متصل؟"، فسيقوم ذكاء واتساب الاصطناعي بحظر حسابك.
  • الحد الآمن: تحقق واحد لكل مستخدم كل 5 دقائق.

البارامترات

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

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

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

WhatsApp Instance ID

مثال:
string

API Access Token

مثال:
string

معرف الدردشة للتحقق من التواجد له

مثال:

أمثلة الكود

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

1const baseUrl = "https://api.wawp.net";
2const endpoint = "/v2/presence/123456789@c.us";
3const params = new URLSearchParams({
4 "instance_id": "123456789",
5 "access_token": "YOUR_ACCESS_TOKEN"
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) مع أمثلة للبيانات لتسهيل معالجة الأخطاء والنجاح.

ناجح - تم إكمال الطلب بنجاح
النوع:
application/json
boolean *
string *

Example

{
"success": true,
"message": "Operation completed successfully"
}
طلب غير صالح - معاملات مطلوبة مفقودة
غير مصرح - مفتاح الوصول غير صالح أو مفقود
غير موجود - الجلسة غير موجودة
خطأ في الخادم الداخلي - فشل غير متوقع
بوابة غير صالحة - فشل الاتصال بالخادم الرئيسي
الموضوع السابقتعيين تواجد الجلسة
الموضوع التاليالحصول على التواجد العام

Command Palette

Search for a command to run...