إضافة مشاركين

إضافة مشارك واحد أو أكثر إلى المجموعة.

POST

https://api.wawp.net/v2/groups/{id}/participants/add?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/add

يدعم

POST

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

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

الخصوصية

يمكن للمستخدمين حظر إضافتهم إلى المجموعات من قبل الغرباء.

الفشل

إذا فشلت الإضافة، قد تحتاج إلى إرسال رابط دعوة بدلاً من ذلك.

توصيات

تحقق مما إذا كان المستخدم موجودًا على واتساب قبل محاولة الإضافة.
لا تقم بإضافة المستخدمين الذين غادروا سابقًا بشكل عشوائي.
تعامل مع النجاحات الجزئية (تمت إضافة بعض المستخدمين وفشل البعض الآخر).

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

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

🏗️ الفلسفة المعمارية: تلاقي الهوية والسلطة

من منظور تصميم النظام، إضافة مشارك هي حدث تفويض. أنت تمنح معرف واتساب (JID) صلاحية الوصول إلى تاريخ الرسائل والبيانات الوصفية للمجتمع.

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

🚀 تجاوز "درع الخصوصية": الإضافة المباشرة مقابل روابط الدعوة

أحد أكثر التحديات شيوعاً هو جدار خصوصية واتساب. يمكن للمستخدمين التحكم في من يضيفهم للمجموعات.

سيناريو فشل الإذن: إذا ضبط المستخدم خصوصيته على "جهات الاتصال فقط" ولم يكن مثيلك في سجل هاتفهم، فقد تظهر عملية الإضافة "ناجحة" تقنياً ولكن المستخدم لن يظهر فعلياً في المجموعة.
النمط الاستراتيجي البديل: نوصي بتنفيذ تسلسل "إضافة -> تحقق -> رابط":
1. حاول إضافة المستخدم مباشرة.
2. تحقق من قائمة الأعضاء بعد ثوانٍ.
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/add";
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 added

application/json

boolean *

Example

{
"ok": true
}

الموضوع السابقجلب قائمة المشاركين

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