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

# Çoklu Cihaz ve Cihaz Seçimi

> Tek bir GOWA sunucusunda birden fazla WhatsApp hesabı çalıştırın ve her isteğin hangi hesabı kullanacağını X-Device-Id ile seçin.

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

GOWA’da "çoklu cihaz" iki anlama gelir:

* **WhatsApp’ın çoklu cihaz protokolü.** GOWA, WhatsApp Web gibi bir yardımcı cihaz olarak hesaba bağlanır. Telefonun çevrimiçi kalması gerekmez ve her hesap en fazla dört bağlı yardımcı cihaza izin verir.
* **Sunucu başına birden fazla hesap.** Tek bir GOWA süreci birçok **cihaz yuvası** barındırabilir. Her yuva, farklı bir WhatsApp hesabıyla veya ayrı bir yardımcı cihaz olarak aynı numarayla eşleşir.

## Cihaz yuvaları

Bir yuvanın seçtiğiniz bir kimliği (veya oluşturulan bir UUID’si), bir durumu ve eşleştikten sonra hesabın JID’si vardır.

| Durum | Anlamı |
| - | - |
| `disconnected` | WhatsApp’a bağlı değil. Yeni veya oturumu kapatılmış bir yuva bu durumdan başlar. |
| `connecting` | Bağlantı kuruluyor. |
| `connected` | Soket açık, henüz oturum açılmadı (örneğin QR kodunun taranması beklenirken). |
| `logged_in` | Eşleşti; göndermeye ve almaya hazır. |

### Yuvaları yönetin

```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/...` yolları cihazı yoldan alır, bu nedenle hiçbir zaman `X-Device-Id` gerektirmez. Yuvalar ve oturumlar yeniden başlatmalar arasında korunur.

## Cihaz seçimi

Cihaz kapsamındaki diğer tüm yolların (`/send/*`, `/message/*`, `/chat*`, `/group*`, `/user/*`, `/newsletter/*`, `/call/*` ve `/app/info` ile `/app/metrics` dışındaki `/app/*`) hangi hesap adına işlem yapacağını bilmesi gerekir. GOWA bunu şu sırayla belirler:

1. `X-Device-Id` üst bilgisi (URL kodlaması çözülmüş olarak).
2. `device_id` sorgu parametresi.
3. İkisi de belirtilmemişse ve **tam olarak bir** yuva varsa o yuva.

Değer, yuva kimliği veya hesap JID’si (örneğin `628123456789@s.whatsapp.net`) olabilir.

```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]
>
> Tek bir yuva olsa bile her zaman `X-Device-Id` gönderin. Aksi takdirde daha sonra ikinci bir yuva eklendiğinde kapsamı belirtilmeyen tüm çağrılar `DEVICE_ID_REQUIRED` hatasıyla başarısız olur.

### Seçim hataları

| HTTP | `code` | Neden |
| - | - | - |
| 400 | `DEVICE_ID_REQUIRED` | Cihaz belirtilmedi ve hiç yuva yok veya birden fazla yuva var. |
| 404 | `DEVICE_NOT_FOUND` | Verilen kimlik veya JID ile eşleşen yuva yok. |
| 503 | `DEVICE_MANAGER_UNAVAILABLE` | Sunucu başlatma işlemini tamamlamadı. |

Var olan ancak oturum açmamış bir yuva seçim aşamasını geçer; ardından istek, "oturum açmadınız" gibi bir WhatsApp hatasıyla başarısız olur.

## Cihaz başına özellikler

| Özellik | Kapsamı nasıl belirlenir |
| - | - |
| Webhook’lar | Her veri yükü `device_id` (hesap JID’si) ve `session_id` (yuva kimliği) taşır. Bir yuvanın kendi webhook’u olabilir: `PATCH /devices/{device_id}/webhook`. Bkz. [Webhook’lar](https://gowa-docs.mintlify.site/tr/concepts/webhooks.md#cihaz-ba%C5%9F%C4%B1na-webhook%E2%80%99lar). |
| WebSocket | Cihaz bağlamını seçmek için `/ws?device_id=<id>` adresine bağlanın. Mevcut merkez olayları bağlı tüm soketlere yayınlar, bu nedenle istemciler olayın cihaz tanımlayıcılarına göre filtreleme yapmalıdır. Tarayıcı kaynakları güvenilir olmalıdır. |
| Zamanlanmış gönderimler | Onları oluşturan yuvaya aittir; bu yuvanın `X-Device-Id` değeriyle listeleyin. |
| MCP | MCP bağlantısında `X-Device-Id` veya her araç çağrısında bir `device_id` bağımsız değişkeni. Bkz. [MCP sunucusu](https://gowa-docs.mintlify.site/tr/integrations/mcp.md). |
| Chatwoot | Tek bir gelen kutusu için `CHATWOOT_DEVICE_ID` veya her yuvaya bir gelen kutusu için cihaz başına yapılandırmalar. Bkz. [Chatwoot](https://gowa-docs.mintlify.site/tr/integrations/chatwoot.md). |

## Sınırlar ve dikkat edilmesi gerekenler

* WhatsApp, hesap başına en fazla dört bağlı yardımcı cihaza izin verir. Bu hesapla eşleşen her GOWA yuvası bunlardan birini kullanır.
* Telefon yaklaşık 14 gün çevrimdışı kalırsa WhatsApp yardımcı cihazın bağlantısını kaldırır.
* Eşleştirme sonrası geçmiş senkronizasyonu kısmidir ve WhatsApp tarafından kontrol edilir; GOWA aldıklarını sohbet deposunda saklar.
* Kullanıcıya yönelik sohbet ve mesaj okumaları, oturum açmış hesabın depolama kimliğini kullanır. Başka bir yuvanın mesajlarını ararken bir yuvanın cihaz üst bilgisini onun yerine kullanmayın. Yeniden eşleştirilen bir yuva, olayları mevcut istemcisi üzerinden alır.
* Her yuva tam bir WhatsApp bağlantısıdır. Bellek ve CPU kullanımı, yuva sayısı ve trafik hacmiyle birlikte artar.


## Related topics

- [API Referansı](https://gowa-docs.mintlify.site/tr/api-reference/introduction.md)
- [MCP Sunucusu](https://gowa-docs.mintlify.site/tr/integrations/mcp.md)
- [Etkin cihazın oturumunu kapat (cihaz yuvasını korur)](https://gowa-docs.mintlify.site/tr/api-reference/app/etkin-cihazın-oturumunu-kapat-cihaz-yuvasını-korur.md)
- [Yeni cihaz ekle](https://gowa-docs.mintlify.site/tr/api-reference/device/yeni-cihaz-ekle.md)
- [Grup oluştur ve katılımcı ekle](https://gowa-docs.mintlify.site/tr/api-reference/group/grup-oluştur-ve-katılımcı-ekle.md)


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