> ## Documentation Index
> Fetch the complete documentation index at: https://gowa-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# إدارة المجموعة

> إنشاء مجموعات، وإدارة المشاركين والمشرفين، والتعامل مع طلبات الانضمام، وتغيير الإعدادات وإرسالها إلى المجموعات.

جميع مسارات المجموعات مرتبطة بجهاز محدد: أرسل `X-Device-Id`. معرّفات المجموعات هي معرّفات JID تنتهي بـ `@g.us`، مثل `120363025246125486@g.us`. تتطلب إجراءات الإدارة أن يكون الحساب مشرفًا في المجموعة.

```bash theme={null}
export GOWA=http://localhost:3000 AUTH=admin:changeme DEVICE=my-device
```

## إنشاء وتفتيش

```bash theme={null}
# create (participants: numbers or JIDs)
curl -u $AUTH -X POST $GOWA/group -H "X-Device-Id: $DEVICE" \
  -H "Content-Type: application/json" \
  -d '{"title": "Project Team", "participants": ["628111111111", "628222222222"]}'

# info and participants
curl -u $AUTH -H "X-Device-Id: $DEVICE" "$GOWA/group/info?group_id=120363025246125486@g.us"
curl -u $AUTH -H "X-Device-Id: $DEVICE" "$GOWA/group/participants?group_id=120363025246125486@g.us"

# participants as CSV
curl -u $AUTH -H "X-Device-Id: $DEVICE" "$GOWA/group/participants/export?group_id=120363025246125486@g.us" -o members.csv

# groups this account is in
curl -u $AUTH -H "X-Device-Id: $DEVICE" $GOWA/user/my/groups
```

## المشاركون

تعمل نفس الهيئة من أجل الإضافة والإزالة والترويج والزيادة:

```bash theme={null}
BODY='{"group_id": "120363025246125486@g.us", "participants": ["628333333333"]}'

curl -u $AUTH -X POST $GOWA/group/participants          -H "X-Device-Id: $DEVICE" -H "Content-Type: application/json" -d "$BODY"  # add
curl -u $AUTH -X POST $GOWA/group/participants/remove   -H "X-Device-Id: $DEVICE" -H "Content-Type: application/json" -d "$BODY"
curl -u $AUTH -X POST $GOWA/group/participants/promote  -H "X-Device-Id: $DEVICE" -H "Content-Type: application/json" -d "$BODY"
curl -u $AUTH -X POST $GOWA/group/participants/demote   -H "X-Device-Id: $DEVICE" -H "Content-Type: application/json" -d "$BODY"
```

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

## طلبات الانضمام

بالنسبة للمجموعات التي تتطلب موافقة المدير:

```bash theme={null}
curl -u $AUTH -H "X-Device-Id: $DEVICE" \
  "$GOWA/group/participant-requests?group_id=120363025246125486@g.us"

curl -u $AUTH -X POST $GOWA/group/participant-requests/approve \
  -H "X-Device-Id: $DEVICE" -H "Content-Type: application/json" \
  -d '{"group_id": "120363025246125486@g.us", "participants": ["628444444444"]}'
# reject: /group/participant-requests/reject with the same body
```

## الإعدادات

| الإعدادات | Endpoint | الجسم |
| - | - | - |
| الاسم | `POST /group/name` | `{"group_id": "...", "name": "New name"}` |
| الوصف | `POST /group/topic` | `{"group_id": "...", "topic": "About this group"}` (الفارغة تزيله) |
| صورة | `POST /group/photo` | متعدد الجزء: `group_id`, `photo` (حذف `photo` إلى الإزالة) |
| يقوم المشرفون فقط بتعديل المعلومات | `POST /group/locked` | `{"group_id": "...", "locked": true}` |
| فقط المشرفين يرسلون | `POST /group/announce` | `{"group_id": "...", "announce": true}` |

```bash theme={null}
curl -u $AUTH -X POST $GOWA/group/announce -H "X-Device-Id: $DEVICE" \
  -H "Content-Type: application/json" \
  -d '{"group_id": "120363025246125486@g.us", "announce": true}'
```

## روابط الدعوة

```bash theme={null}
# get the link (reset=true revokes the old one and creates a new one)
curl -u $AUTH -H "X-Device-Id: $DEVICE" \
  "$GOWA/group/invite-link?group_id=120363025246125486@g.us&reset=false"

# preview a group from a link without joining
curl -u $AUTH -H "X-Device-Id: $DEVICE" \
  "$GOWA/group/info-from-link?link=https://chat.whatsapp.com/AbCdEfGhIjKl"

# join
curl -u $AUTH -X POST $GOWA/group/join-with-link -H "X-Device-Id: $DEVICE" \
  -H "Content-Type: application/json" -d '{"link": "https://chat.whatsapp.com/AbCdEfGhIjKl"}'

# leave
curl -u $AUTH -X POST $GOWA/group/leave -H "X-Device-Id: $DEVICE" \
  -H "Content-Type: application/json" -d '{"group_id": "120363025246125486@g.us"}'
```

## مراسلة مجموعة

استخدم معرّف JID للمجموعة كقيمة `phone` في أي نقطة نهاية `/send/*`. أشر إلى الأعضاء باستخدام `mentions`، أو إلى الجميع باستخدام `"@everyone"`:

```bash theme={null}
curl -u $AUTH -X POST $GOWA/send/message -H "X-Device-Id: $DEVICE" \
  -H "Content-Type: application/json" \
  -d '{"phone": "120363025246125486@g.us", "message": "Standup in 5 minutes", "mentions": ["@everyone"]}'
```

## أحداث المجموعة

اشترك في `group.participants` (join, leave , promotion and demote) و `group.joined` (تمت إضافتها) webhooks. مثال:

```json theme={null}
{
  "event": "group.participants",
  "device_id": "628123456789@s.whatsapp.net",
  "payload": {"chat_id": "120363025246125486@g.us", "type": "join", "jids": ["628333333333@s.whatsapp.net"]}
}
```


## Related topics

- [معلومات المجموعة](https://gowa-docs.mintlify.site/ar/api-reference/group/معلومات-المجموعة.md)
- [مغادرة المجموعة](https://gowa-docs.mintlify.site/ar/api-reference/group/مغادرة-المجموعة.md)
- [تعيين موضوع المجموعة](https://gowa-docs.mintlify.site/ar/api-reference/group/تعيين-موضوع-المجموعة.md)
- [تعيين اسم المجموعة](https://gowa-docs.mintlify.site/ar/api-reference/group/تعيين-اسم-المجموعة.md)
- [تعيين صورة المجموعة](https://gowa-docs.mintlify.site/ar/api-reference/group/تعيين-صورة-المجموعة.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.