جلب قائمة المجموعات

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

GET

https://api.wawp.net/v2/groups?access_token=123456789&instance_id=123456789

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

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

تسجيل الدخول

اختبار /v2/groups

يدعم

GET

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

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

الأداء

يمكن أن يكون مسح آلاف المجموعات بطيئًا. استخدم المرشحات إن وجدت.

المزامنة

استخدم هذا لتمهيد قاعدة بياناتك المحلية عند بدء التشغيل.

توصيات

قم بتشغيل هذا مرة واحدة عند بدء التشغيل، ثم اعتمد على Webhooks للتحديثات التزايدية.
قم بتصفية مجموعات 'الإعلان' إذا كان الروبوت الخاص بك يحتاج إلى اتصال ثنائي الاتجاه.
قم بتسوية هذه القائمة بشكل دوري مع قاعدة بياناتك للعثور على 'المجموعات الشبح'.

الجرد الشامل: التدقيق الاستراتيجي لانتشارك في المجموعات

في عمليات واتساب واسعة النطاق، لا تدير شركتك مجرد رسائل فردية، بل تدير منظومة كاملة من المجتمعات. واجهة جلب جميع المجموعات هي أداتك الأساسية لـ إدارة موارد المحادثات. إنها توفر رؤية شاملة لكل حالة مشتركة — سواء كانت "غرفة طوارئ" أو "مجموعة استقبال عملاء" — يشترك فيها مثيلك حالياً.

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

توفر هذه الواجهة "الاتساع" المطلوب للإدارة النظامية لمجتمعاتك.

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

🚀 أنماط التشغيل الاستراتيجية

1. بروتوكول الأرشفة الدورية

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

2. اكتشاف المجموعات المنشأة يدوياً

غالباً ما ينشئ الوكلاء مجموعات يدوياً عبر تطبيق واتساب. هذه المجموعات تكون "غير مرئية" للأتمتة حتى يتم اكتشافها عبر هذه الواجهة وربطها بسير عمل الـ CRM الرسمي.

البارامترات

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

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

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

	`string`		Your unique WhatsApp Instance ID مثال:
	`string`		Your API Access Token مثال:

أمثلة الكود

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

1const baseUrl = "https://api.wawp.net";
2const endpoint = "/v2/groups";
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    if (response.status === 401) {
23      console.error("Error 401: غير مصرح - مفتاح الوصول غير صالح أو مفقود");
24    }
25    if (response.status === 500) {
26      console.error("Error 500: خطأ في الخادم الداخلي - فشل غير متوقع");
27    }
28
29    const errorText = await response.text();
30    console.error(`Error ${response.status}: ${errorText}`);
31  })
32  .catch((error) => console.error("Network Error:", error));

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

Ln 32, Col 1javascript

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

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

List of groups retrieved successfully

application/json

object *

Example

{
"0": {
  "id": "1234567890@g.us",
  "name": "Project Team",
  "participants": {
    }
  }
}

غير مصرح - مفتاح الوصول غير صالح أو مفقود

خطأ في الخادم الداخلي - فشل غير متوقع