إنشاء مجموعة

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

POST
https://api.wawp.net/v2/groups?instance_id=123456789&access_token=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
POST

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

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

توصيات

  • قم دائمًا بتخزين معرف @g.us المرتجع فورًا.

  • أرسل رسالة ترحيب تشرح الغرض من المجموعة بمجرد إنشائها.

  • قتصر المشاركين الأوليين على جهات الاتصال المعروفة لتجنب بلاغات الرسائل العشوائية.

البارامترات

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

محتوى الطلب

يرسل كـ 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));
عينات تفاعلية
Ln 42, Col 1javascript

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

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

Group created successfully
طلب غير صالح - تنسيق المعامل غير صالح
غير مصرح - مفتاح الوصول غير صالح أو مفقود
خطأ في الخادم الداخلي - فشل غير متوقع
الموضوع السابقجلب قائمة المجموعات
الموضوع التاليالانضمام للمجموعة / جلب معلومات الانضمام

Command Palette

Search for a command to run...