تغير حالة الجلسة
يتم تفعيل هذا الحدث عند تغير حالة الجلسة (مثلاً من WORKING إلى STOPPED).
توصيات
أعد تشغيل الجلسة إذا ظلت في حالة 'STARTING' لأكثر من 60 ثانية.
استخدم نقطة النهاية 'logout' لفصل الجلسة بشكل نظيف.
نبض المحرك: حوكمة الاتصال ودورة حياة الأرقام
في إدارة مراسلات الشركات واسعة النطاق، لا يعد الاتصال حالة ثابتة، بل هو دورة حياة ديناميكية. ويب هوك تغير حالة الجلسة هو الإشارة النهائية التي تبلغ بنيتك التحتية بصحة وأصالة محرك واتساب الخاص بك. إنه "جهاز مراقبة نبض القلب" لمجتمعك، ومكون لا غنى عنه في أي استراتيجية اتصال مرنة.
🏗️ الفلسفة المعمارية: الحالة كشرط مسبق للفعل
يجب أن يعمل نظامك بـ "وعي بالاتصال". إن محاولة إرسال رسالة عبر مثيل غير متصل هو إهدار للموارد ومخاطرة باستمرارية الأعمال.
- عامل التشغيل (WORKING): هذه هي الحالة الوحيدة التي يمكن للمحرك فيها تنفيذ عمليات القراءة والكتابة الكاملة. تستخدم الأنظمة الاحترافية هذه الحالة كـ "ضوء أخضر" لإدارة طوابير الرسائل الصادرة.
- بوابة الهوية (SCAN_QR_CODE): حدث عالي الأهمية يشير إلى أن الأرقام غير مصدق. يمكن لنظامك الرد على هذا الويب هوك بإرسال إشعار فوري للمسؤول أو عرض رمز الاستجابة السريعة في لوحة التحكم لإعادة الربط فوراً.
- الانقطاع الحرج (DISCONNECTED): يشير إلى فقدان الارتباط أو انقطاع الشبكة لفترة طويلة، مما يتطلب تدخلًا فوريًا لضمان عدم ضياع رسائل العملاء.
🚀 حالات الاستخدام الاستراتيجي
1. تخفيف التوقف والتبديل التلقائي (Failover)
في بيئة تدير عدة مثيلات، إذا توقف الأرقام (أ)، يمكن للموجه المركزي اكتشاف ذلك عبر الويب هوك وتحويل الاستفسارات الواردة إلى الأرقام (ب) تلقائياً، مما يضمن ألا يواجه العميل أبداً "دردشة مظلمة" لا يتم الرد فيها على رسائله.
2. تدفقات المصادقة المؤتمتة
يمكنك استخدام حدث [SCAN_QR_CODE] لتحديث واجهة المستخدم لدى عميلك وعرض الرمز فوراً، ثم الانتقال لعلامة "متصل" بمجرد وصول حالة [WORKING]، مما يخلق تجربة انضمام سلسة لا تتطلب من العميل تحديث الصفحة يدوياً.
🛡️ أفضل الممارسات التشغيلية
- ذاكرة حالة التشغيل: يجب أن تقوم كل وظيفة إرسال في تطبيقك بـ "فحص حالة مسبق" من الذاكرة المؤقتة. إذا لم تكن الحالة
WORKING، يمكن للنظام تأجيل الطلب وإبلاغ المستخدم: "اتصالنا المباشر في مرحلة إعادة الضبط، سيتم إرسال رسالتك قريباً". - التنبيه المتدرج: عند استلام [
SCAN_QR_CODE]، أرسل إشعاراً للمدير. إذا لم تتغير الحالة خلال 10 دقائق، صعد التنبيه لقسم تكنولوجيا المعلومات. - سجلات التوافر: قم بتخزين كل انتقال للحالة لتحليل أنماط الانقطاع وأداء التوافر (Uptime) لمثيلك على المدى الطويل.
الردود المتوقعة
استكشف كافة الردود والنتائج المحتملة من الخادم. قمنا بتوثيق كل كود حالة (Status Code) مع أمثلة للبيانات لتسهيل معالجة الأخطاء والنجاح.
Example
{
"id": "evt_01aaaaaaaaaaaaaaaaaaaaaaaa",
"timestamp": 1634567890123,
"session": "default",
"metadata": {
"user.id": "123",
"user.email": "email@example.com"
},
"engine": "WEBJS",
"event": "session.status",
"payload": {
"name": "default",
"status": "STOPPED"
},
"me": {
"id": "11111111111@c.us",
"lid": "123123@lid",
"pushName": "Wawp Instance"
}
}Command Palette
Search for a command to run...