مغادرة مجموعة (V2)
يتم تفعيله عند مغادرة عضو للمجموعة أو إزالته منها.
توصيات
Update your group member list in your backend database.
Check if it's a voluntary leave or an admin removal.
مغادرة المجموعة: تحليل دورة حياة العضوية
يعد ويب هوك [group.v2.leave] المكمل الضروري لحدث الانضمام. هو الإشارة التي تخبر نظامك بأن مستخدماً لم يعد جزءاً من مساحة العمل المشتركة. يعد تتبع هذا الحدث حيوياً للحفاظ على سلامة بياناتك وفهم معدلات بقاء المستخدمين (Retention).
🏗️ الفلسفة المعمارية: إنهاء صافحة العضوية
- تحديث دليل المزامنة: يجب أن يقوم هذا الويب هوك فوراً بتحديث "دليل الظل" الخاص بك لإزالة المستخدم من المجموعة. يمنع هذا إرسال رسائل أو بيانات حساسة لمستخدم لم يعد مشاركاً.
- تمييز سبب المغادرة: هل غادر المستخدم طوعاً أم تمت إزالته بواسطة مسؤول؟ (يمكن التحقق من ذلك بمقارنة الحدث مع سجلات المسؤولين). المغادرة الطوعية قد تستحق رسالة "نأسف لرحيلك"، بينما الإزالة بواسطة مسؤول قد تكون جزءاً من إجراء انضباطي.
🚀 حالات الاستخدام الاستراتيجي
1. تحليل الانقطاع (Churn Analysis)
سيساعدك رصد هذا الويب هوك على فهم "لماذا يغادر الناس؟". إذا لاحظت مغادرة جماعية بعد إرسال رسالة معينة من قبل النظام، فقد تكون النبرة غير ملائمة.
2. الأتمتة الإدارية للموارد
عندما يغادر موظف مجموعة عمل، يمكن للنظام تلقائياً إيقاف وصوله للموارد المرتبطة بتلك المجموعة في أنظمتك الأخرى (مثل Slack أو Drive)، مما يعزز الأمان الهيكلي للشركة.
الردود المتوقعة
استكشف كافة الردود والنتائج المحتملة من الخادم. قمنا بتوثيق كل كود حالة (Status Code) مع أمثلة للبيانات لتسهيل معالجة الأخطاء والنجاح.
Example
{
"id": "evt_01...",
"timestamp": 1634567890123,
"session": "default",
"metadata": {
"user.id": "123",
"user.email": "email@example.com"
},
"engine": "WEBJS",
"event": "group.v2.leave",
"payload": {
"chatId": "1234567890@g.us",
"participants": {
"0": "11111111111@c.us"
}
},
"me": {
"id": "11111111111@c.us",
"lid": "123@lid",
"pushName": "Instance"
}
}Command Palette
Search for a command to run...