تغيير رتب المشاركين في المجموعة

يتم تفعيله عند ترقية أحد المشاركين إلى مسؤول (Admin) أو تنزيل رتبته.

توصيات

  • Update the 'isAdmin' status for participants in your database.

  • Trigger specific administrative workflows when new admins are appointed.

تغيير أدوار المشاركين: تتبع ديناميكيات السلطة

يعد ويب هوك [group.v2.participants] الأداة الأساسية لمراقبة توزيع الصلاحيات داخل المجموعة. ففي بيئات العمل، يعني تغيير الرتبة تحولاً في الأهلية لإدارة المحادثة، ويجب أن يكون نظامك على علم تام بهذا التحول لحظة وقوعه.


🏗️ الفلسفة المعمارية: تحديث مصفوفة الصلاحيات

  • مراقبة الأهلية: إذا كان البوت يرفض الأوامر من غير المسؤولين، فإن هذا الويب هوك يضمن تحديث "قائمة المسموح لهم" فوراً.
  • الأمان الهيكلي: تتبع من يقوم بالترقية. إذا قام مستخدم غير مصرح له بترقية نفسه (عبر ثغرة أو خطأ بشري)، يمكن للنظام اكتشاف ذلك عبر هذا الويب هوك واتخاذ إجراء تصحيحي فوري.

🚀 حالات الاستخدام الاستراتيجي

1. تدوير السلطة الإدارية

عند ترقية مشارك جديد إلى مسؤول، يمكن للنظام إرسال "دليل المسؤول" له تلقائياً عبر رسالة خاصة، يشرح له فيها كيفية استخدام أوامر البوت المتقدمة وإدارة المجموعة بكفاءة.

2. المصالحة مع أنظمة الموارد البشرية (HR)

ربط رتبة المستخدم في واتساب بمركزه الوظيفي في الشركة. إذا تمت ترقية موظف في CRM الخاص بك، يمكن للنظام التأكد من ترقيته في مجموعات العمل المرتبطة عبر هذا الويب هوك.

الردود المتوقعة

استكشف كافة الردود والنتائج المحتملة من الخادم. قمنا بتوثيق كل كود حالة (Status Code) مع أمثلة للبيانات لتسهيل معالجة الأخطاء والنجاح.

Webhook Payload Example
application/json
string *
number *
string *
object *
string *
string *
object *
object *

Example

{
"id": "evt_01...",
"timestamp": 1634567890123,
"session": "default",
"metadata": {
  "user.id": "123",
  "user.email": "email@example.com"
  },
"engine": "WEBJS",
"event": "group.v2.participants",
"payload": {
  "chatId": "1234567890@g.us",
  "action": "promote",
  "participants": {
    "0": "11111111111@c.us"
    }
  },
"me": {
  "id": "11111111111@c.us",
  "lid": "123@lid",
  "pushName": "Instance"
  }
}

Command Palette

Search for a command to run...