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

# اختيار الأجهزة المتعددة و الأجهزة

> شغّل عدة حسابات WhatsApp على خادم GOWA واحد، واختر الحساب الذي يستخدمه كل طلب عبر X-Device-Id.

![GWA Multi Device Whats App Architecture](https://mintcdn.com/gowa-docs/ccA2Yz4DVI9xOiS8/images/GOWA-Multi-Device-WhatsApp-Architecture.png?fit=max\&auto=format\&n=ccA2Yz4DVI9xOiS8\&q=85\&s=116b948218cb46aa9eca0b959634eaaf)

"الأجهزة المتعددة" تعني شيئين في نظام GOWA:

* **بروتوكول WhatsApp متعدد الأجهزة.** تربط GOWA بحساب كجهاز مرافق، مثل Web. لا يحتاج الهاتف إلى البقاء على الإنترنت، وكل حساب يسمح بما يصل إلى أربع شركات مرتبطة.
* **حسابات متعددة لكل خادم.** يمكن لعملية واحدة من نظام GOWA أن تحمل العديد من **فتحات الأجهزة**. كل مزوج فتحة مع حساب WhatsApp مختلف، أو بنفس الرقم كشريك منفصل.

## فتحات الجهاز

تحتوي الفتحة على معرف تختاره (أو UUID) و حالة و بمجرد اقتران حساب JID.

| الولاية | المعنى |
| - | - |
| `disconnected` | غير متصل بـ WhatsApp. ستبدأ هنا فتحة جديدة أو مسجلة. |
| `connecting` | الاتصال قيد التقدم. |
| `connected` | Socket مفتوح، لم يتم تسجيل الدخول بعد (على سبيل المثال أثناء الانتظار لفحص QR). |
| `logged_in` | مقترنة ومستعدة للإرسال والاستقبال. |

### إدارة الفتحات

```bash theme={null}
# Create (device_id is optional)
curl -u admin:changeme -X POST http://localhost:3000/devices \
  -H "Content-Type: application/json" \
  -d '{"device_id": "sales"}'

# List
curl -u admin:changeme http://localhost:3000/devices

# Inspect / live status
curl -u admin:changeme http://localhost:3000/devices/sales
curl -u admin:changeme http://localhost:3000/devices/sales/status

# Pair, log out, reconnect
curl -u admin:changeme http://localhost:3000/devices/sales/login
curl -u admin:changeme -X POST "http://localhost:3000/devices/sales/login/code?phone=628123456789"
curl -u admin:changeme -X POST http://localhost:3000/devices/sales/logout
curl -u admin:changeme -X POST http://localhost:3000/devices/sales/reconnect

# Remove the slot and its session and chat data
curl -u admin:changeme -X DELETE http://localhost:3000/devices/sales
```

مسارات `/devices/...` تأخذ الجهاز من المسار، لذلك لا تحتاج أبدا إلى `X-Device-Id`. تبقى المسارات والجلسات عبر إعادة التشغيل.

## تحديد جهاز

يحتاج كل مسار آخر خاص بجهاز (`/send/*` و`/message/*` و`/chat*` و`/group*` و`/user/*` و`/newsletter/*` و`/call/*` و`/app/*` باستثناء `/app/info` و`/app/metrics`) إلى معرفة الحساب الذي سينفّذ العملية باسمه. ويحدده GOWA بالترتيب التالي:

1. ترويسة `X-Device-Id` (URL-disoded).
2. معلمة الاستعلام `device_id`.
3. إذا لم يعطى أي منهما وفتحة **واحدة** بالضبط، فإن تلك الفتحة.

يمكن أن تكون القيمة معرف الخانة أو حساب JID (على سبيل المثال `628123456789@s.whatsapp.net`).

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

# Equivalent, using the query parameter
curl -u admin:changeme -X POST "http://localhost:3000/send/message?device_id=sales" \
  -H "Content-Type: application/json" \
  -d '{"phone": "628123456789", "message": "Hi from the sales number"}'
```

> [!TIP]
>
> إرسال `X-Device-Id`، حتى مع فتحة واحدة. إضافة فتحة ثانية لاحقاً من شأنه أن يجعل كل مكالمة غير مقطوعة تفشل مع `DEVICE_ID_REQUIRED`.

### أخطاء التحديد

| HTTP | `code` | السبب |
| - | - | - |
| 400 | `DEVICE_ID_REQUIRED` | لا يوجد جهاز معطى ولا فتحات صفرية أو عدة فتحات. |
| 404 | `DEVICE_NOT_FOUND` | لا توجد فتحة تطابق معرف معين أو JID. |
| 503 | `DEVICE_MANAGER_UNAVAILABLE` | لم ينته الخادم من التهيئة. |

خانة موجودة ولكن لا يتم تسجيل الدخول في اختيار المريحات؛ فشل الطلب بعد ذلك مع خطأ WhatsApp مثل "أنت غير مسجل الدخول".

## ميزات لكل جهاز

| الميزة | كيف يتم تحديد نطاقه |
| - | - |
| الوب | كل حمولة تحمل `device_id` (حساب JID) و `session_id` (معرف الفتحة). يمكن أن يكون هناك فتحة ويب خاصة: `PATCH /devices/{device_id}/webhook`. انظر [Webhooks](https://gowa-docs.mintlify.site/ar/concepts/webhooks.md#%D9%83%D9%84-%D8%AC%D9%87%D8%A7%D8%B2%D9%83). |
| WebSocket | اتصل بـ `/ws?device_id=<id>` لتحديد سياق الجهاز. يبث الموزّع الحالي الأحداث إلى كل مقبس متصل، لذا يجب على العملاء تصفية الأحداث بحسب معرّفات الجهاز الواردة فيها. يجب أن تكون أصول المتصفح موثوقة. |
| إرسال مجدول | على طول الفتحة التي أنشأت هم؛ وقم بإدراجهم في الفتحة `X-Device-Id`. |
| MCP | `X-Device-Id` على اتصال MCP أو حجة `device_id` لكل مكالمة أداة. انظر [MCP server](https://gowa-docs.mintlify.site/ar/integrations/mcp.md). |
| Chatwoot | `CHATWOOT_DEVICE_ID` للحصول على صندوق الوارد واحد أو كل جهاز لتكوين صندوق الوارد واحد لكل فتحة. انظر [Chatwoot](https://gowa-docs.mintlify.site/ar/integrations/chatwoot.md). |

## الحدود والتحذيرات

* يسمح WhatsApp بربط ما يصل إلى أربعة أجهزة مصاحبة بكل حساب. تستهلك كل خانة في GOWA مقترنة بذلك الحساب موضعًا واحدًا منها.
* WhatsApp يلغي الاتصال بأحد المرافقين إذا بقي الهاتف دون اتصال لمدة 14 يوماً تقريباً.
* المزامنة التاريخية بعد الاقتران جزئية ويسيطر عليها WhatsApp؛ وتقوم GOWA بتخزين ما تتلقاه في مخازن المحادثة الخاصة بها.
* المحادثة الموجهة للمستخدم وقراءة الرسالة يستخدمان هوية تخزين حساب تسجيل الدخول. لا تستبدل رأس جهاز فتحة واحدة عند البحث عن رسائل فتحة أخرى. الفتحة المعاد اقترانها تتلقى الأحداث من خلال العميل الحالي.
* كل فتحة هي اتصال كامل بـ WhatsApp. تتنامى الذاكرة ووحدة المعالجة المركزية مع عدد الفتحات وحجم حركة المرور.


## Related topics

- [قائمة جميع الأجهزة](https://gowa-docs.mintlify.site/ar/api-reference/device/قائمة-جميع-الأجهزة.md)
- [الحصول على قائمة الأجهزة المتصلة](https://gowa-docs.mintlify.site/ar/api-reference/app/الحصول-على-قائمة-الأجهزة-المتصلة.md)
- [تثبيت](https://gowa-docs.mintlify.site/ar/installation.md)
- [إعادة الاتصال بخادم ماتسلاب](https://gowa-docs.mintlify.site/ar/api-reference/app/إعادة-الاتصال-بخادم-ماتسلاب.md)
- [الحصول على حالة الاتصال](https://gowa-docs.mintlify.site/ar/api-reference/app/الحصول-على-حالة-الاتصال.md)


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