الحصول على تواجد الدردشة
يسترجع معلومات التواجد الحالية لمعرف دردشة معين.
تسجيل الدخول مطلوب
سجل الدخول لاستبدال المعرفات (Instance ID) ورمز الوصول (Access Token) بمعلومات حسابك الحقيقي لاختبار ال API مباشرة.
تسجيل الدخوللا توجد معاملات استعلام مطلوبة
هذه النهاية الطرفية لا تتوقع بيانات في الرابط.
توصيات
استخدم هذا باعتدال؛ الاقتراع المستمر محدود المعدل.
اشترك في تحديثات الحضور بدلاً من الاقتراع.
رؤية الأشباح: التحقق من تواجد المستخدم
تسمح نقطة النهاية /v2/presence/{chatId} لنظامك بالاستعلام عن حالة "متصل" لمستخدم أو جهة اتصال معينة على واتساب. عند استخدامها بشكل صحيح، فإنها تحول البوت الخاص بك من "مجيب آلي بسيط" إلى "مساعد مدرك للسياق".
🎯 فلسفة "اللقطة"
من الضروري فهم أن نقطة النهاية هذه توفر لقطة في الوقت الحالي، وليست تدفقاً مستمراً.
- الاستجابة: "المستخدم 12345 متصل الآن."
- الواقع: قد يغلقون التطبيق بعد ثانية واحدة.
- أفضل ممارسة: تعامل مع حالة
onlineكإشارة قوية بأن المستخدم يمسك بهاتفه، ولكن ليس كضمان للرد.
🏗️ سير العمل التقني
1. التحقق قبل الإرسال
قبل إرسال رسالة عالية القيمة (مثل رمز التحقق أو تنبيه زمني)، استدعِ نقطة النهاية هذه.
- إذا كان "متصل": أرسلها عبر واتساب فوراً. احتمالية قراءة عالية في غضون 10 ثوانٍ.
- إذا كان "غير متصل":
- الخيار أ: أرسلها على أي حال (تسليم قياسي).
- الخيار ب (ذكي): أرسلها عبر SMS كبديل إذا كانت الرسالة حرجة.
2. حاجز الخصوصية
تحترم نقطة النهاية هذه إعدادات الخصوصية للمستخدم على هاتفه.
- النتيجة: إذا كان المستخدم يخفي حالته، فستتلقى دائماً
offlineحتى لو كان يدردش معك الآن.
3. حدود المعدل ومنع الحظر
تحذير: هذه هي النقطة الأكثر حساسية في مجموعة واجهة برمجة التطبيقات بأكملها.
- النمط الممنوع: إذا قمت بالمرور على 1000 رقم للتحقق من "هل أنت متصل؟"، فسيقوم ذكاء واتساب الاصطناعي بحظر حسابك.
- الحد الآمن: تحقق واحد لكل مستخدم كل 5 دقائق.
البارامترات
قم بتهيئة المعاملات المطلوبة للتفاعل مع نقطة النهاية هذه. جميع وسائط الاستعلام والبيانات مدرجة أدناه مع تفاصيلها.
بارامترات الرابط
جزء من مسار الرابط أو استعلامstring | WhatsApp Instance ID مثال: | ||
string | API Access Token مثال: | ||
string | معرف الدردشة للتحقق من التواجد له مثال: |
أمثلة الكود
استخدم أمثلة الكود الجاهزة لدمج واجهة برمجة التطبيقات (API) في مشروعك بسرعة وكفاءة. اختر لغة البرمجة والمكتبة التي تفضلها.
الردود المتوقعة
استكشف كافة الردود والنتائج المحتملة من الخادم. قمنا بتوثيق كل كود حالة (Status Code) مع أمثلة للبيانات لتسهيل معالجة الأخطاء والنجاح.
Example
{
"success": true,
"message": "Operation completed successfully"
}Command Palette
Search for a command to run...