تحديث التواجد
يتم تفعيله عندما يبدأ جهة اتصال في الكتابة، أو تسجيل صوت، أو تغيير حالة اتصاله بالإنترنت.
توصيات
استخدم متغيرات البيئة لبيانات الاعتماد الحساسة مثل رموز الوصول.
قم بتنفيذ معالجة قوية للأخطاء ومنطق إعادة المحاولة.
النبض الرقمي: إتقان ويب هوك التواجد والنشاط
في هندسة نظام مراسلة عالي الأداء، النص هو نصف المحادثة فقط. النصف الآخر هو التواجد — الإشارات الدقيقة عالية التردد التي تشير إلى متى ينظر الإنسان إلى شاشته، أو يصيغ فكرة، أو يسجل ملاحظة صوتية. ويب هوك presence.update هو "المستشعر الاجتماعي" لمنصة Wawp.
🏗️ الفلسفة الهندسية: العقد الاجتماعي للتوفر
لإتقان واجهة برمجة تطبيقات التواجد، يجب إدراك الوزن النفسي لمؤشر "يكتب...". إنه يمثل التركيز النشط.
1. تسلسل هرمي للنشاط
يلتقط حدث التواجد تطور التفاعل بين الإنسان والجهاز:
- Composing (الكتابة): المستخدم يدخل النص حالياً. هذه أقوى إشارة لـ "إدخال معلق".
- Recording (التسجيل): المستخدم يضغط على زر الميكروفون لتسجيل ملاحظة صوتية. يوفر هذا "تحذيراً للميديا" — يجب أن يتوقع نظامك حمولة صوتية قريباً.
- Paused (متوقف مؤقتاً): توقف المستخدم عن الكتابة ولكن نافذة الدردشة لا تزال مفتوحة.
🚀 حالات الاستخدام الاستراتيجي: تمكين البوتات الذكية اجتماعياً
1. بوت "الذكاء الاصطناعي المحترم" (تجنب الاصطدام)
من أكثر تجارب المستخدم إحباطاً أن يرسل البوت إجابة طويلة بينما لا يزال المستخدم يكتب سؤاله التالي.
سير العمل الاستراتيجي: عندما يولد البوت رداً، فإنه يتحقق أولاً من "حالة النشاط" لمعرف الدردشة. إذا وصل حدث composing في آخر 10 ثوانٍ، فإن البوت يوقف مخرجاته مؤقتاً. ينتظر المستخدم حتى ينتهي من الكتابة ويرسل رسالته قبل تقديم إجابته الخاصة. هذا يخلق تدفقاً يحاكي المحادثة البشرية الطبيعية.
2. مزامنة لوحة التحكم في الوقت الفعلي
بالنسبة لفرق الدعم التي يقودها البشر، ويب هوك التواجد هو محرك ميزة "وعي الوكيل". عندما يرى الوكيل "العميل يكتب..." على لوحة التحكم، فإنه يعرف أن عليه الانتظار بدلاً من السؤال "هل أنت هناك؟".
🛡️ أفضل الممارسات التشغيلية
- استراتيجية "Debounce": يمكن أن تنطلق تحديثات التواجد كل بضع ثوانٍ. لا تقم بتشغيل كتابة في قاعدة البيانات لكل حزمة "المستخدم يكتب". بدلاً من ذلك، استخدم ذاكرة تخزين مؤقت (مثل Redis) لتخزين "الحالة الحالية" للدردشة.
- عمر الحالة البصرية: يجب أن يكون لمؤشرات الكتابة "وقت للعيش" (TTL) على لوحة التحكم الخاصة بك. إذا لم تتلقَ تحديثاً جديداً خلال 15 ثانية، فقم بإخفاء مؤشر "يكتب..." تلقائياً.
الردود المتوقعة
استكشف كافة الردود والنتائج المحتملة من الخادم. قمنا بتوثيق كل كود حالة (Status Code) مع أمثلة للبيانات لتسهيل معالجة الأخطاء والنجاح.
Example
{
"id": "evt_01...",
"timestamp": 1634567890123,
"session": "default",
"metadata": {
"user.id": "123",
"user.email": "email@example.com"
},
"engine": "WEBJS",
"event": "presence.update",
"payload": {
"chatId": "11111111111@c.us",
"type": "composing",
"from": "11111111111@c.us"
},
"me": {
"id": "11111111111@c.us",
"lid": "123@lid",
"pushName": "Instance"
}
}Command Palette
Search for a command to run...