إزالة مشاركين

إزالة مشارك واحد أو أكثر من المجموعة.

POST

https://api.wawp.net/v2/groups/{id}/participants/remove?access_token=123456789&id=1234567890%40g.us&instance_id=123456789&participants=%5B%7B%22id%22%3A%221234567890%40c.us%22%7D%5D

تسجيل الدخول مطلوب

سجل الدخول لاستبدال المعرفات (Instance ID) ورمز الوصول (Access Token) بمعلومات حسابك الحقيقي لاختبار ال API مباشرة.

تسجيل الدخول

اختبار /v2/groups/{id}/participants/remove

يدعم

POST

لا توجد معاملات استعلام مطلوبة

هذه النهاية الطرفية لا تتوقع بيانات في الرابط.

للمسؤولين فقط

يمكن لمسؤولي المجموعة فقط إزالة المشاركين.

إشعار

سيشاهد المستخدم الذي تمت إزالته رسالة نظام تفيد بأنك قمت بإزالته.

توصيات

سجل سبب الإزالة في نظامك الداخلي.
أرسل رسالة تحذير للمستخدم قبل إزالته إذا كان ذلك مناسبًا.
قم بإزالة المستخدم من تعيين قاعدة بياناتك المحلية أيضًا.

تقليم الحالة: الحوكمة الاستراتيجية لإزالة المشاركين

في دورة حياة المجتمع المدار، تعد القدرة على سحب الوصول بشكل انتقائي لا تقل أهمية عن القدرة على منحه. تعد واجهة إزالة المشاركين أداتك الأساسية لـ الحوكمة الهيكلية وفرض الأمن. هي تتيح لك تقليم قائمة أعضاء المجموعة برمجياً، مما يضمن أن أصحاب المصلحة المعنيين فقط هم من يملكون حق الوصول للمحادثة.

🏗️ الفلسفة المعمارية: فرض حدود الحالة

من منظور تقني، إزالة مشارك هي إلغاء للتفويض. أنت تقطع الرابط بين JID محدد وسياق المجموعة المستمر.

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

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

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

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

2. بروتوكول تقليم "التذكرة المحلولة"

بمجرد تأكيد حل مشكلة تقنية في CRM، يمكن للنظام تلقائياً إزالة جميع الخبراء التقنيين الثانويين مع ترك مدير الحساب والعميل فقط، لتركيز المحادثة على خطوات الإغلاق النهائية.

3. فرض انتهاء صلاحية الاشتراك

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

🛡️ نظافة التشغيل والاحترافية

نوصي بنمط "إشعار الخروج"؛ قبل تنفيذ إزالة قوية، أرسل رسالة مهذبة توضح السبب بمحافظة على سمعة علامتك المهنية. كما نوصي بـ "تقليم تدريجي" (5-10 مستخدمين في الدقيقة) لضمان استقرار النظام وسلامة الحساب.

البارامترات

قم بتهيئة المعاملات المطلوبة للتفاعل مع نقطة النهاية هذه. جميع وسائط الاستعلام والبيانات مدرجة أدناه مع تفاصيلها.

محتوى الطلب

يرسل كـ JSON

	`string`		Your unique WhatsApp Instance ID مثال:
	`string`		Your API Access Token مثال:
	`string`		The unique ID of the group مثال:
	`array`		قائمة بمعرفات الواتساب (@c.us) المراد إزالتها مثال:

أمثلة الكود

استخدم أمثلة الكود الجاهزة لدمج واجهة برمجة التطبيقات (API) في مشروعك بسرعة وكفاءة. اختر لغة البرمجة والمكتبة التي تفضلها.

1const baseUrl = "https://api.wawp.net";
2const endpoint = "/v2/groups/1234567890@g.us/participants/remove";
3const params = new URLSearchParams({
4  "instance_id": "123456789",
5  "access_token": "123456789"
6}).toString();
7const body = {
8  "participants": [
9    {
10      "id": "1234567890@c.us"
11    }
12  ]
13};
14
15fetch(`${baseUrl}${endpoint}${params ? '?' + params : ''}`, {
16  method: "POST",
17  headers: { "Content-Type": "application/json" },
18  body: JSON.stringify(body)
19})
20  .then(async (response) => {
21    if (response.ok) {
22      const data = await response.json();
23      console.log("Success:", data);
24      return data;
25    }
26    
27    // Error Handling
28    
29
30    const errorText = await response.text();
31    console.error(`Error ${response.status}: ${errorText}`);
32  })
33  .catch((error) => console.error("Network Error:", error));

عينات تفاعليةUTF-8

Ln 33, Col 1javascript

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

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

Participants removed

application/json

boolean *

Example

{
"ok": true
}

الموضوع السابقإضافة مشاركين

الموضوع التاليترقية المشاركين إلى مسؤولين