> ## 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 وإرسال رسالتك الأولى في بضع دقائق.

## 1. ابدأ الخادم

> [tab] دوكر
>
> ```bash theme={null}
> docker run -d --name gowa \
>   -p 3000:3000 \
>   -v gowa_storages:/app/storages \
>   -v gowa_statics:/app/statics \
>   -e APP_BASIC_AUTH=admin:changeme \
>   aldinokemal2104/go-whatsapp-web-multidevice:latest
> ```
>
> الأمر الافتراضي للصورة هو `rest`، لذلك لا حاجة إلى حجج. وتنشر نفس الصورة باسم `ghcr.io/aldinokemal/go-whatsapp-web-multidevice`.

> [tab] ثنائي
>
> تحميل الأرشيف الخاص بالمنصة الخاصة بك من [أحدث إصدار مستقر](https://github.com/aldinokemal/go-whatsapp-web-multidevice/releases/latest). يستخدم هذا المثال أرشيف الـ v9.0 Linux amd64 . استبدل اسم الملف الذي قمت بتحميله.
>
> ```bash theme={null}
> unzip whatsapp_9.9.0_linux_amd64.zip
> chmod +x whatsapp
> ./whatsapp rest --basic-auth=admin:changeme
> ```
>
> قم بتثبيت FFmpeg و libwebp (`cwebp`) أولا؛ وتستخدمهما GOWA لتحويل الوسائط.

> [tab] من المصدر
>
> يتطلب الذهاب 1.26+, FFmpeg و libwebp.
>
> ```bash theme={null}
> git clone https://github.com/aldinokemal/go-whatsapp-web-multidevice.git
> cd go-whatsapp-web-multidevice/src
> go run . rest --basic-auth=admin:changeme
> ```

تحقق من ذلك:

```bash theme={null}
curl http://localhost:3000/health
# OK
```

> [!NOTE]
>
> يتطلب مستمع الشبكة الافتراضي الذي يستمع على عنوان غير محلي بيانات اعتماد كاملة في `APP_BASIC_AUTH`. للتطوير المحلي دون مصادقة، اضبط عنوان الاستماع على `APP_HOST=127.0.0.1`. ويمكن لوكيل عكسي يتولى المصادقة استخدام التجاوز الصريح `APP_ALLOW_UNAUTHENTICATED=true`. راجع [المصادقة](https://gowa-docs.mintlify.site/ar/authentication.md).

## 2. إنشاء جهاز

كل حساب في WhatsApp يعيش في فتحة الجهاز. قم بإنشاء واحد وإعطائه معرف سوف تستخدمه:

```bash theme={null}
curl -u admin:changeme -X POST http://localhost:3000/devices \
  -H "Content-Type: application/json" \
  -d '{"device_id": "my-device"}'
```

اسحب `device_id` للحصول على UUID.

## 3. إقران الحساب

> [tab] QR code
>
> ```bash theme={null}
> curl -u admin:changeme http://localhost:3000/devices/my-device/login
> ```
>
> افتح `results.qr_link` في متصفح وفحصه من WhatsApp → **الأجهزة المرتبطة** → **رابط جهاز**. تنتهي صلاحية الرمز بعد الثواني `results.qr_duration`؛ طلب واحدة جديدة إذا انقطعت.

> [tab] Pairing code
>
> ```bash theme={null}
> curl -u admin:changeme -X POST \
>   "http://localhost:3000/devices/my-device/login/code?phone=628123456789"
> ```
>
> أدخل `results.pair_code` على الهاتف تحت **الأجهزة المرتبطة** → **رابط برقم الهاتف بدلاً من ذلك**.

> [tab] لوحة التحكم
>
> افتح `http://localhost:3000/`، أدخل بيانات اعتماد المصادقة الأساسية الخاصة بك عندما يطلب المتصفح، وزن الجهاز من واجهة المستخدم.

تأكد من تسجيل دخول الجهاز (`results.is_logged_in` ينبغي أن يكون `true`):

```bash theme={null}
curl -u admin:changeme http://localhost:3000/devices/my-device/status
```

## 4. إرسال رسالة

```bash theme={null}
curl -u admin:changeme -X POST http://localhost:3000/send/message \
  -H "Content-Type: application/json" \
  -H "X-Device-Id: my-device" \
  -d '{"phone": "628123456789", "message": "Hello from GOWA"}'
```

```json theme={null}
{
  "code": "SUCCESS",
  "message": "Success",
  "results": {
    "message_id": "3EB0B430B6F8F1D0E053AC120E0A9E5C",
    "status": "Message sent to 628123456789 (server timestamp: ...)"
  }
}
```

يقبل `phone` رقمًا يتضمن رمز البلد دون `+` أو مسافات، أو معرّف JID كاملًا مثل `628123456789@s.whatsapp.net` أو `120363025246125486@g.us` للمجموعات. عند تسجيل جهاز واحد فقط، تكون الترويسة `X-Device-Id` اختيارية.

## 5. تلقي الرسائل

إعادة التشغيل مع رابط webhook وستقوم GOWA بتشغيل كل حدث في:

```bash theme={null}
export WHATSAPP_WEBHOOK_SECRET="$(openssl rand -hex 32)"
./whatsapp rest --basic-auth=admin:changeme --webhook=https://example.com/wa-hook
```

حفظ سر الويبهوك الذي تم إنشاؤه وتكوين نفس القيمة على جهاز الاستقبال الخاص بك. إعادة استخدامه بعد إعادة التشغيل. انظر [Webhooks](https://gowa-docs.mintlify.site/ar/concepts/webhooks.md) للحمولات والتحقق من التوقيع.

## الخطوات التالية

> [card] [تثبيت](https://gowa-docs.mintlify.site/ar/installation.md)
>
> تكوين، Docker Proxy, PostgreSQL.

> [card] [مرجع التكوين](https://gowa-docs.mintlify.site/ar/configuration.md)
>
> كل علم ومتغير بيئي.

> [card] [أجهزة متعددة](https://gowa-docs.mintlify.site/ar/concepts/multidevice.md)
>
> تشغيل عدة حسابات على خادم واحد.

> [card] [مرجع API](https://gowa-docs.mintlify.site/ar/api-reference/introduction.md)
>
> جميع نقاط النهاية.


## Related topics

- [إرسال الرسائل](https://gowa-docs.mintlify.site/ar/examples/sending-messages.md)
- [تكامل Chatwoot](https://gowa-docs.mintlify.site/ar/integrations/chatwoot.md)


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