الاشتراك في التواجد
اشترك في تحديثات التواجد في الوقت الفعلي (متصل/غير متصل) لجهة اتصال معينة.
تسجيل الدخول مطلوب
سجل الدخول لاستبدال المعرفات (Instance ID) ورمز الوصول (Access Token) بمعلومات حسابك الحقيقي لاختبار ال API مباشرة.
تسجيل الدخوللا توجد معاملات استعلام مطلوبة
هذه النهاية الطرفية لا تتوقع بيانات في الرابط.
توصيات
اشترك فقط عندما يكون المستخدم في نافذة دردشة نشطة.
قم بإلغاء الاشتراك عندما يتم إلغاء تحميل مكون واجهة المستخدم لتوفير النطاق الترددي.
النبض الرقمي: الاشتراك في التواجد في الوقت الفعلي
تعد نقطة النهاية /v2/presence/{chatId}/subscribe هي "السلك الحي" لواجهة برمجة التطبيقات. على عكس طريقة "اللقطة"، يصدر هذا الأمر تعليمات لمحرك واتساب لفتح تدفق بيانات مستمر لمستخدم معين.
⚡ ميكانيكا الاشتراك
كيف يعمل؟
عندما تستدعي نقطة النهاية هذه لهدف معين (مثل 12345@c.us):
- المصافحة: يرسل مثيلك بروتوكولاً إلى خوادم واتساب يقول "أنا مهتم بـ 12345".
- التدفق: تبدأ خوادم واتساب في دفع أحداث
presence.updateإلى الـ socket الخاص بك. - المدة: هذا التدفق ليس دائماً. يستمر عادةً لمدة تتراوح بين 20 إلى 60 ثانية بعد آخر تفاعل أو تجديد للاشتراك.
🏗️ بنية التنفيذ
لبناء ميزة "حالة مباشرة" قوية (مثل نقطة "متصل" في واجهة الدردشة)، تحتاج إلى حلقة نبضات القلب (Heartbeat Loop).
حلقة نبضات القلب
- حدث الواجهة: الوكيل يفتح نافذة الدردشة للمستخدم أ.
- الواجهة: ترسل حدث "تركيز" إلى نظامك الخلفي.
- النظام الخلفي: يستدعي
/v2/presence/UserA/subscribe. - الحلقة: كل 30 ثانية طالما نافذة الدردشة مفتوحة، يكرر النظام الخلفي استدعاء الاشتراك.
- التوقف: عندما يغلق الوكيل نافذة الدردشة، يوقف النظام الخلفي الحلقة. ينتهي الاشتراك تلقائياً بعد 30 ثانية.
🛡️ القيود الاستراتيجية
- حدود التزامن: عادةً لا يمكنك الاشتراك في أكثر من ~50-100 مستخدم فريد في نفس الوقت.
- حالة الاستخدام: تم تصميم هذه الميزة لـ "الدعم الفردي" (رؤية الوكيل للأعضاء النشطين)، وليس لـ "المراقبة الجماعية" لجميع عملائك في وقت واحد.
البارامترات
قم بتهيئة المعاملات المطلوبة للتفاعل مع نقطة النهاية هذه. جميع وسائط الاستعلام والبيانات مدرجة أدناه مع تفاصيلها.
محتوى الطلب
يرسل كـ JSONstring | Your unique WhatsApp Instance ID مثال: | ||
string | Your API Access Token مثال: | ||
string | المعرف الخاص بجهة الاتصال (@c.us) مثال: |
أمثلة الكود
استخدم أمثلة الكود الجاهزة لدمج واجهة برمجة التطبيقات (API) في مشروعك بسرعة وكفاءة. اختر لغة البرمجة والمكتبة التي تفضلها.
الردود المتوقعة
استكشف كافة الردود والنتائج المحتملة من الخادم. قمنا بتوثيق كل كود حالة (Status Code) مع أمثلة للبيانات لتسهيل معالجة الأخطاء والنجاح.
Example
{
"success": true,
"message": "Operation completed successfully"
}Command Palette
Search for a command to run...