> ## 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: واجهة WhatsApp REST API

> واجهة WhatsApp Web متعددة الأجهزة، مكتوبة بلغة Go وتعمل على خادم تستضيفه بنفسك. يضم الملف التنفيذي واجهة REST، وخطافات الويب، وخادم MCP، وتكاملاً مع Chatwoot.

![مخطط أجهزة GOWA وعمليات التكامل](https://mintcdn.com/gowa-docs/fmg2izHnKArFAB0e/images/GOWA-WhatsApp-Multi-Device-Integration-Overview.png?fit=max\&auto=format\&n=fmg2izHnKArFAB0e\&q=85\&s=18fadf6c0eeed1a7303404955fc903b4)

GOWA ([go-whatsapp-web-multidevice](https://github.com/aldinokemal/go-whatsapp-web-multidevice)) خادم تستضيفه بنفسك ويتصل بـ WhatsApp كجهاز مرافق، بالطريقة نفسها التي يعمل بها WhatsApp Web، ويتيح الوصول إليه عبر HTTP. وهو ملف تنفيذي واحد بلغة Go (`whatsapp rest`) مبني على [whatsmeow](https://github.com/tulir/whatsmeow).

يستخدم دليل البدء السريع الإصدار المستقر. ويتتبع مرجع API فرع `main` في GOWA، بما في ذلك التغييرات المدمجة بعد صدور الإصدار. استخدم `GET /app/info` للتحقق من الإصدار الذي تشغّله، وراجع [ملاحظات الإصدار](https://github.com/aldinokemal/go-whatsapp-web-multidevice/releases) لمعرفة الميزات المتاحة.

> [!WARNING]
>
> GOWA عميل غير رسمي ولا يتبع WhatsApp أو Meta. قد يؤدي استخدامه إلى تقييد رقمك أو حظره. لا تستخدمه لإرسال رسائل مزعجة أو رسائل جماعية غير مرغوب فيها.

## ما الذي يمكنك فعله بخادم واحد؟

> [card] [حسابات متعددة](https://gowa-docs.mintlify.site/ar/concepts/multidevice.md)
>
> شغّل عدة أرقام WhatsApp على خادم واحد. لكل رقم خانة جهاز، ويحدد ترويس الطلب `X-Device-Id` الخانة المستخدمة.

> [card] [REST API](https://gowa-docs.mintlify.site/ar/api-reference/introduction.md)
>
> أرسل النصوص والوسائط والاستطلاعات والمواقع وجهات الاتصال. أدِر المحادثات والمجموعات والقنوات وملفك الشخصي.

> [card] [الوب](https://gowa-docs.mintlify.site/ar/concepts/webhooks.md)
>
> استقبل إشعارات HTTP موقعة للرسائل وإيصالات الاستلام والتفاعلات وأحداث المجموعات والمكالمات والقنوات.

> [card] [إرسال مجدول](https://gowa-docs.mintlify.site/ar/examples/scheduled-sends.md)
>
> جدول إرسال رسالة من نوع مدعوم مرة واحدة، أو كرر الإرسال يوميًا أو أسبوعيًا أو شهريًا.

> [card] [خادم MCP](https://gowa-docs.mintlify.site/ar/integrations/mcp.md)
>
> Tamable-HTTP MCP نقطة النهاية عند `/mcp` حتى يتمكن وكلاء AI من إرسال وقراءة الرسائل.

> [card] [Chatwoot](https://gowa-docs.mintlify.site/ar/integrations/chatwoot.md)
>
> مرآة محادثات WhatsApp في صندوق الوارد لChatwoot والرد من Chatwot.

لوحة معلومات الويب ([gowa-ui](https://github.com/aldinokemal/gowa-ui) تقدم في `/` لإقران الأجهزة وتجربة API باليد.

اطّلع على [الرسائل التفاعلية](https://gowa-docs.mintlify.site/ar/examples/interactive-messages.md) للأزرار والبطاقات الدوارة التجريبية، وعلى [قنوات WhatsApp](https://gowa-docs.mintlify.site/ar/examples/newsletters.md) لاشتراكات القنوات، وعلى [مقاييس الخادم](https://gowa-docs.mintlify.site/ar/api-reference/metrics.md) للمراقبة.

## بدء التشغيل

**1. تشغيل GOWA**

ابدأ مع Docker أو ثنائي الإصدار. انظر [Quickstart](https://gowa-docs.mintlify.site/ar/quickstart.md).

**2. إنشاء جهاز وإقرانه**

`POST /devices`، ثم قم بمسح رمز QR أو استخدم رمز الاقتران. انظر [Authentication](https://gowa-docs.mintlify.site/ar/authentication.md).

**3. إرسال رسالة**

`POST /send/message` مع المصادقة الأساسية و `X-Device-Id`.

**4. تلقي الأحداث**

النقطة `WHATSAPP_WEBHOOK` في نقطة النهاية. انظر [Webhooks](https://gowa-docs.mintlify.site/ar/concepts/webhooks.md).

## غير مضمن

* **SDK.** لا يوجد أي شيء. اتصل بAPI HTTP مباشرة (انظر [أمثلة العميل](https://gowa-docs.mintlify.site/ar/api-reference/sdks/go.md) أو إنشاء عميل من [منظر OpenAPI النظرية](https://github.com/aldinokemal/go-whatsapp-web-multidevice/blob/main/docs/openapi.yaml). توجد عقدة مجتمعية رقم 8n [`@aldinokemal2104/n8n-nodes-gowa`](https://www.npmjs.com/package/@aldinokemal2104/n8n-nodes-gowa).
* **تحديد المعدلات.** لا تقوم GOWA بطلبات الخانقة. انظر [حدود الإرسال](https://gowa-docs.mintlify.site/ar/advanced/rate-limiting.md).

## الدعم

* [مشكلات GitHub ](https://github.com/aldinokemal/go-whatsapp-web-multidevice/issues)
* [الإصدارات وسجل التغييرات](https://github.com/aldinokemal/go-whatsapp-web-multidevice/releases)


## Related topics

- [تحقق مما إذا كان المستخدم على WhatsApp](https://gowa-docs.mintlify.site/ar/api-reference/user/تحقق-مما-إذا-كان-المستخدم-على-whatsapp.md)
- [البداية السريعة](https://gowa-docs.mintlify.site/ar/quickstart.md)
- [تسجيل الدخول إلى خادم Whatsapp](https://gowa-docs.mintlify.site/ar/api-reference/app/تسجيل-الدخول-إلى-خادم-whatsapp.md)
- [الحصول على بيانات تعريف الخادم](https://gowa-docs.mintlify.site/ar/api-reference/app/الحصول-على-بيانات-تعريف-الخادم.md)
- [الاشتراك في التحديثات المباشرة للنشرة الإخبارية](https://gowa-docs.mintlify.site/ar/api-reference/newsletter/الاشتراك-في-التحديثات-المباشرة-للنشرة-الإخبارية.md)


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