> ## 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.

# قنوات واتساب

> البحث عن النشرات الإخبارية ومتابعتها وقراءتها وتحميل وسائط القناة وتلقي تحديثات المشاركة المباشرة.

تستدعي GOWA القنوات **النشرات الإخبارية** في واجهة برمجة التطبيقات الخاصة بها. جميع الطلبات في هذه الصفحة تستخدم المصادقة الأساسية وجهاز تسجيل الدخول المحدد بواسطة `X-Device-Id`. ينتهي معرف القناة في `@newsletter`؛ رقم الاتصال أو مجموعة JID ليس معرف القناة.

عيّن عنوان URL للسيرفر ووثائق الاعتماد قبل تشغيل أمثلة الستريل. استخدم عنوان HTTPS العام للخادم البعيد وشمل `APP_BASE_PATH` عند تكوينه.

```bash theme={null}
export GOWA_URL=http://localhost:3000
export GOWA_USER=admin
export GOWA_PASSWORD=replace-with-your-password
export DEVICE_ID=my-device
```

## البحث عن قناة

ابحث عن البيانات الوصفية للقناة إما عن طريق `newsletter_id` أو `invite`. قم بالتوريد بالضبط. يمكن أن تكون الدعوة رابط `https://whatsapp.com/channel/...` أو تعليماتها.

```bash theme={null}
curl --user "$GOWA_USER:$GOWA_PASSWORD" --get \
  -H "X-Device-Id: $DEVICE_ID" \
  --data-urlencode 'invite=https://whatsapp.com/channel/0029Va4K0PZ5a245NkngBA2M' \
  "$GOWA_URL/newsletter/info"
```

يحتوي `results` على البيانات الوصفية للقناة، بما فيها معرّفها والبيانات الوصفية لسلسلة المحادثة وللمشاهد. يتيح البحث عبر الدعوة الحصول على البيانات الوصفية العامة دون متابعة القناة. يعتمد البحث بمعرّف JID على صلاحية وصول الحساب المحدد إلى القناة. قد تكون قيمة `viewer_metadata` هي `null` عندما يوفّر WhatsApp البيانات الوصفية العامة فقط.

لتصفح الدليل، قم بتوفير رمز بلد واحد على الأقل. للبحث عن طريق الاسم، استخدم `search_text`.

```bash theme={null}
curl --user "$GOWA_USER:$GOWA_PASSWORD" --get \
  -H "X-Device-Id: $DEVICE_ID" \
  --data-urlencode 'country_codes=ID' --data-urlencode 'view=TRENDING' \
  --data-urlencode 'limit=20' "$GOWA_URL/newsletter/directory"

curl --user "$GOWA_USER:$GOWA_PASSWORD" --get \
  -H "X-Device-Id: $DEVICE_ID" \
  --data-urlencode 'search_text=news' "$GOWA_URL/newsletter/directory"
```

| الاستعلام | السلوك |
| - | - |
| `view` | القيمة الافتراضية هي `RECOMMENDED`. تُقبل أيضًا القيم `TRENDING` و`POPULAR` و`NEW` و`FEATURED`. تتجاهل عمليات البحث بالاسم هذا الاختيار. |
| `country_codes` | رموز ISO ذات حرفين، متكررة أو مفصولة بفواصل. مطلوب للتصفح. البحث في الاسم لا يدعم تصفية البلد. |
| `categories` | قيم متكررة أو مفصولة بفواصل من `BUSINESS` و`ENTERTAINMENT` و`LIFESTYLE` و`NEWS` و`ORGANIZATIONS` و`PEOPLE` و`SPORTS`. |
| `limit` | Default `20`, range `1`–`50`. |
| `cursor` | استخدم الرد السابق `results.next_cursor` بينما `results.has_more` هو `true`. |

الاستجابات الدليلية تضع القنوات في `results.data`. يستخدم الدليل استفسارات WhatsApp غير موثقة ويمكن أن يتغير بشكل مستقل عن GOWA.

## المتابعة أو إلغاء المتابعة

```bash theme={null}
curl --user "$GOWA_USER:$GOWA_PASSWORD" \
  -H "X-Device-Id: $DEVICE_ID" -H 'Content-Type: application/json' \
  "$GOWA_URL/newsletter/follow" \
  --data '{"newsletter_id":"120363024512399999@newsletter"}'
```

استخدم نفس هيئة JSON مع `POST /newsletter/unfollow` لإلغاء المتابعة. `GET /user/my/newsletters` تسرد الرسائل الإخبارية التي يتبعها الحساب المحدد.

تتبع قناة والاشتراك في تحديثات المشاركة المباشرة هي عمليات منفصلة. إدارة الاشتراكات الحية من خلال `/newsletter/live-updates`.

## قراءة الرسائل والعدادات

```bash theme={null}
curl --user "$GOWA_USER:$GOWA_PASSWORD" --get \
  -H "X-Device-Id: $DEVICE_ID" \
  --data-urlencode 'newsletter_id=120363024512399999@newsletter' \
  --data-urlencode 'count=50' "$GOWA_URL/newsletter/messages"
```

يقرأ `GET /newsletter/messages` المنشورات مباشرة من WhatsApp دون اشتراط متابعة القناة. يتحكم WhatsApp في السجل المتاح. لا يضمن GOWA مدة احتفاظ محددة أو أرشيفًا كاملًا. القيمة الافتراضية لـ `count` هي `50`، ويقبل القيم من `1` إلى `100`. لتحميل منشورات أقدم، مرّر قيمة `server_id` لأقدم منشور مُعاد في `before`.

يحتوي `results.data` على مشاركات مع `server_id`، `message_id`، `type`، `timestamp`، `text`، `views_count`، `forwards_count`، اختياري `reaction_counts`. يمكن أن تكون حقول المحتوى غائبة. تقارير WhatsApp المشاهدات لقناة المشرفين؛ حسابات أخرى يمكن أن ترى `views_count: 0`.

استخدم رقمي `server_id`، بدلا من `message_id`، لتنزيل الصفحات والوسائط.

```bash theme={null}
curl --user "$GOWA_USER:$GOWA_PASSWORD" --get \
  -H "X-Device-Id: $DEVICE_ID" \
  --data-urlencode 'newsletter_id=120363024512399999@newsletter' \
  --data-urlencode 'after=123' --data-urlencode 'count=50' \
  "$GOWA_URL/newsletter/message-updates"
```

يحدّث `GET /newsletter/message-updates` العدّادات دون جلب محتوى الرسائل. الحقل `after` مطلوب ويجب أن يكون معرّف خادم موجبًا. القيمة الافتراضية لـ `count` هي `50`، والحد الأقصى هو `100`. الحقل الاختياري `since` هو طابع زمني بنظام Unix بالثواني، ويجب أن يكون غير سالب. تستخدم النتائج بنية القائمة نفسها في `results.data`، مع حذف حقول المحتوى عندما لا يعيدها WhatsApp.

## تلقي تحديثات العداد المباشر

تكوين [webhook](https://gowa-docs.mintlify.site/ar/concepts/webhooks.md)، ثم قم باشتراك كل جهاز في القنوات التي يحتاجها.

```bash theme={null}
curl --user "$GOWA_USER:$GOWA_PASSWORD" \
  -H "X-Device-Id: $DEVICE_ID" -H 'Content-Type: application/json' \
  "$GOWA_URL/newsletter/live-updates" \
  --data '{"newsletter_id":"120363024512399999@newsletter"}'
```

يحتوي الرد على `results` `newsletter_id`، `duration_seconds`، `expires_at`، `renewed_at`، واختياري `last_error`. يمنح WhatsApp اشتراكاً قصيرًا، تم ملاحظته في حوالي 90 ثانية. تقوم GOWA بتجديده قبل انتهاء الصلاحية وبعد إعادة الاتصال. تصل أحداث العداد كـ `newsletter.message` webhooks.

قائمة اشتراكات مع `GET /newsletter/live-updates`. يتضمن `results.data` نفس الحقول في الحالة. افحص `last_error` عند فشل التجديد.

```bash theme={null}
curl --user "$GOWA_USER:$GOWA_PASSWORD" -X DELETE --get \
  -H "X-Device-Id: $DEVICE_ID" \
  --data-urlencode 'newsletter_id=120363024512399999@newsletter' \
  "$GOWA_URL/newsletter/live-updates"
```

حذف الاشتراك يتوقف عن التجديد. WhatsApp يمكنه الاستمرار في تسليم التحديثات حتى تنتهي صلاحية المنحة الحالية. لم يتم إحياء الإلغاء عن طريق إعادة الاتصال أو التجديد داخل الطيران. حذف قناة بدون إشتراكات خطأ في التحقق.

> [!NOTE]
>
> الإشتراكات موجودة في الذاكرة ولا تنجو من إعادة تشغيل الخادم. أعد إنشاءها بعد إعادة تشغيل GOWA. حالة الاشتراك تنتمي إلى الجهاز المحدد.

## تحميل قناة الوسائط

```bash theme={null}
curl --user "$GOWA_USER:$GOWA_PASSWORD" --get \
  -H "X-Device-Id: $DEVICE_ID" \
  --data-urlencode 'newsletter_id=120363024512399999@newsletter' \
  "$GOWA_URL/newsletter/messages/123/download"
```

تجلب نقطة النهاية ذلك المنشور مباشرة من WhatsApp وتحفظ الوسائط المدعومة في مجلد الوسائط على الخادم. يحتوي الحقل `results` في استجابة JSON على `server_id` و`message_id` و`status` و`media_type` و`mime_type` و`filename` و`file_path` و`file_url` و`file_size`. يوفّر معالج REST قيمة `file_url` كعنوان URL عام وثابت للملف المحفوظ. لا تتضمن هذه الاستجابة ملفًا ثنائيًا. يُعاد خطأ إذا كان المنشور غير موجود أو لا يحتوي على وسائط قابلة للتنزيل.


## Related topics

- [المصادقة](https://gowa-docs.mintlify.site/ar/authentication.md)
- [إرسال حدود](https://gowa-docs.mintlify.site/ar/advanced/rate-limiting.md)
- [أحداث WebSocket](https://gowa-docs.mintlify.site/ar/api-reference/websocket.md)
- [أفضل الممارسات الإنتاجية](https://gowa-docs.mintlify.site/ar/advanced/best-practices.md)
- [GOWA: واجهة WhatsApp REST API](https://gowa-docs.mintlify.site/ar/index.md)


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