إنشاء مجموعة

إنشاء مجموعة واتساب جديدة بالاسم والمشاركين المحددين.

POST

https://api.wawp.net/v2/groups?access_token=123456789&instance_id=123456789&name=New+Project&participants=%5B%7B%22id%22%3A%221234567890%40c.us%22%7D%5D

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

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

تسجيل الدخول

اختبار /v2/groups/create

يدعم

POST

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

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

حالة المسؤول

يصبح الروبوت الخاص بك تلقائيًا مسؤولاً متميزًا عن المجموعة التي تم إنشاؤها.

إعدادات الخصوصية

قد لا تتم إضافة المستخدمين ذوي إعدادات الخصوصية الصارمة مباشرةً؛ استخدم روابط الدعوة كبديل.

توصيات

قم دائمًا بتخزين معرف @g.us المرتجع فورًا.
أرسل رسالة ترحيب تشرح الغرض من المجموعة بمجرد إنشائها.
قتصر المشاركين الأوليين على جهات الاتصال المعروفة لتجنب بلاغات الرسائل العشوائية.

البداية البرمجية: تأسيس المجتمعات الرقمية

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

🏗️ الفلسفة المعمارية: تخصيص الحالة الذرية

من منظور تصميم النظام، يعد إنشاء المجموعة عملية ذرية. في معاملة واحدة، يحدد نظامك كلاً من هوية المجتمع و سكانه الأوليين.

ديناميكيات معرف المجموعة (G-JID)

عند إنشاء مجموعة، ينشئ نظام واتساب معرفاً فريداً ينتهي بـ @g.us.

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

🎭 صلاحيات المنشئ: فرض الحوكمة الدائمة

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

🚀 الاستخدام الاستراتيجي والخصوصية

التعامل مع إعدادات الخصوصية

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

حماية سمعة الحساب

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

البارامترات

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

محتوى الطلب

يرسل كـ JSON

	`string`		Your unique WhatsApp Instance ID مثال:
	`string`		Your API Access Token مثال:
	`string`		اسم المجموعة المراد إنشاؤها مثال:
	`array`		قائمة بمعرفات JIDs للمشاركين المراد إضافتهم للمجموعة مثال:

أمثلة الكود

استخدم أمثلة الكود الجاهزة لدمج واجهة برمجة التطبيقات (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();
7const body = {
8  "name": "New Project",
9  "participants": [
10    {
11      "id": "1234567890@c.us"
12    }
13  ]
14};
15
16fetch(`${baseUrl}${endpoint}${params ? '?' + params : ''}`, {
17  method: "POST",
18  headers: { "Content-Type": "application/json" },
19  body: JSON.stringify(body)
20})
21  .then(async (response) => {
22    if (response.ok) {
23      const data = await response.json();
24      console.log("Success:", data);
25      return data;
26    }
27    
28    // Error Handling
29    if (response.status === 401) {
30      console.error("Error 401: غير مصرح - مفتاح الوصول غير صالح أو مفقود");
31    }
32    if (response.status === 400) {
33      console.error("Error 400: طلب غير صالح - تنسيق المعامل غير صالح");
34    }
35    if (response.status === 500) {
36      console.error("Error 500: خطأ في الخادم الداخلي - فشل غير متوقع");
37    }
38
39    const errorText = await response.text();
40    console.error(`Error ${response.status}: ${errorText}`);
41  })
42  .catch((error) => console.error("Network Error:", error));

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

Ln 42, Col 1javascript

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

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

Group created successfully

طلب غير صالح - تنسيق المعامل غير صالح

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

Command Palette

Search for a command to run...