جلب قائمة المشاركين

استرداد قائمة بجميع المشاركين في المجموعة.

GET

https://api.wawp.net/v2/groups/{id}/participants?access_token=123456789&id=1234567890%40g.us&instance_id=123456789

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

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

تسجيل الدخول

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

يدعم

GET

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

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

التوسع

المجموعات الكبيرة تعيد مصفوفات كبيرة. تعامل مع تقسيم الصفحات أو المهلة.

الأدوار

تتضمن الاستجابة دور (مسؤول، مسؤول متميز، مشارك) لكل مستخدم.

توصيات

قم بتخزين قائمة المشاركين مؤقتًا وتحديثها فقط في أحداث 'تغيير المشارك'.
استخدم هذا لمراجعة من هو موجود بالفعل في المجموعة مقابل قاعدة بياناتك.
قم بالتصفية حسب الدور للعثور على جميع المسؤولين بسرعة.

ذكاء الديموغرافيا: التدقيق الاستراتيجي لعضوية المجتمع

في إدارة الشبكات البشرية الموزعة، يعد فهم من في الغرفة هو أساس التفاعل والأمان والتخصيص. تعد واجهة جلب المشاركين أداتك الأساسية لـ التدقيق الديموغرافي الاستراتيجي ورسم خرائط السكان. فهي تتيح لأنظمتك المؤتمتة الحصول على تعداد شامل لكل معرف واتساب (@c.us) مرتبط حالياً بمجموعة محددة.

🏗️ الفلسفة المعمارية: استرجاع حالة السكان

من منظور تقني، واجهة جلب المشاركين هي لقطة لحالة الربط بين "واحد إلى متعدد".

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

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

1. التدقيق الجنائي والتحقق من الامتثال

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

2. مزامنة الجمهور عبر القنوات

إذا كنت تدير حملة مشتركة بين البريد الإلكتروني وواتساب، فإن قائمة مشاركي المجموعة هي "مصدر الحقيقة" الخاص بك لقطاع واتساب، مما يتيح لك مطابقة المعرفات مع عناوين البريد الإلكتروني في CRM الخاص بك لضمان اتساق الرسائل.

🛡️ أفضل الممارسات التشغيلية

نوصي باستخدام "نموذج هجين": الاستماع للويب هوك لـ 99% من التحديثات، واستخدام واجهة جلب المشاركين كـ "المرجع النهائي" لحالات الحواف أو عند إعادة تهيئة النظام وضمان دقة العرض في لوحة التحكم الخاصة بك.

البارامترات

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

بارامترات الرابط

جزء من مسار الرابط أو استعلام

	`string`		Your unique WhatsApp Instance ID مثال:
	`string`		Your API Access Token مثال:
	`string`		The unique ID of the group مثال:

أمثلة الكود

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

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

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

Ln 27, Col 1javascript

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

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

Participants retrieved

application/json

object *

Example

{
"0": {
  "id": "1234567890@c.us",
  "isAdmin": true,
  "isSuperAdmin": false
  }
}

الموضوع السابقإلغاء كود دعوة المجموعة وتوليد كود جديد

الموضوع التاليإضافة مشاركين