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

# Multi-Perangkat & Pemilihan Perangkat

> Jalankan beberapa akun WhatsApp pada satu server GOWA dan pilih akun untuk setiap permintaan dengan X-Device-Id.

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

"Multi-device" memiliki dua arti dalam GOWA:

* **Protokol multi-device WhatsApp.** GOWA ditautkan ke akun sebagai perangkat pendamping, seperti WhatsApp Web. Ponsel tidak harus terus online, dan setiap akun mengizinkan hingga empat perangkat pendamping tertaut.
* **Beberapa akun per server.** Satu proses GOWA dapat menampung banyak **slot perangkat**. Setiap slot dipasangkan dengan akun WhatsApp yang berbeda, atau dengan nomor yang sama sebagai perangkat pendamping terpisah.

## Slot perangkat

Slot memiliki ID yang Anda tentukan (atau UUID yang dibuat otomatis), status, dan JID akun setelah dipasangkan.

| Status | Arti |
| - | - |
| `disconnected` | Tidak terhubung ke WhatsApp. Slot baru atau slot yang sudah logout dimulai dari status ini. |
| `connecting` | Proses koneksi sedang berlangsung. |
| `connected` | Socket terbuka, tetapi belum login (misalnya saat menunggu pemindaian QR). |
| `logged_in` | Sudah dipasangkan dan siap mengirim serta menerima. |

### Mengelola slot

```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
```

Rute `/devices/...` mengambil perangkat dari path, sehingga tidak memerlukan `X-Device-Id`. Slot dan sesi tetap tersimpan setelah restart.

## Memilih perangkat

Semua rute lain yang memiliki cakupan perangkat (`/send/*`, `/message/*`, `/chat*`, `/group*`, `/user/*`, `/newsletter/*`, `/call/*`, dan `/app/*` kecuali `/app/info` dan `/app/metrics`) harus mengetahui akun yang digunakan. GOWA menentukannya dengan urutan berikut:

1. Header `X-Device-Id` (setelah decoding URL).
2. Parameter kueri `device_id`.
3. Jika keduanya tidak diberikan dan hanya ada **tepat satu** slot, gunakan slot tersebut.

Nilainya dapat berupa ID slot atau JID akun (misalnya `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]
>
> Selalu kirim `X-Device-Id`, meskipun hanya ada satu slot. Jika tidak, penambahan slot kedua di kemudian hari akan membuat semua panggilan tanpa cakupan perangkat gagal dengan `DEVICE_ID_REQUIRED`.

### Error pemilihan perangkat

| HTTP | `code` | Penyebab |
| - | - | - |
| 400 | `DEVICE_ID_REQUIRED` | Perangkat tidak diberikan dan tidak ada slot atau terdapat beberapa slot. |
| 404 | `DEVICE_NOT_FOUND` | Tidak ada slot yang cocok dengan ID atau JID yang diberikan. |
| 503 | `DEVICE_MANAGER_UNAVAILABLE` | Server belum selesai melakukan inisialisasi. |

Slot yang ada tetapi belum login lolos tahap pemilihan; permintaan kemudian gagal dengan error WhatsApp seperti "you are not logged in".

## Fitur per perangkat

| Fitur | Cara menentukan cakupannya |
| - | - |
| Webhook | Setiap payload menyertakan `device_id` (JID akun) dan `session_id` (ID slot). Slot dapat memiliki webhook sendiri: `PATCH /devices/{device_id}/webhook`. Lihat [Webhook](https://gowa-docs.mintlify.site/id/concepts/webhooks.md#webhook-per-perangkat). |
| WebSocket | Hubungkan ke `/ws?device_id=<id>` untuk memilih konteks perangkat. Hub saat ini menyiarkan event ke setiap socket yang terhubung, sehingga klien harus memfilter berdasarkan identitas perangkat pada event. Origin browser harus tepercaya. |
| Pengiriman terjadwal | Dimiliki oleh slot yang membuatnya; tampilkan daftarnya dengan `X-Device-Id` slot tersebut. |
| MCP | `X-Device-Id` pada koneksi MCP, atau argumen `device_id` pada setiap panggilan tool. Lihat [Server MCP](https://gowa-docs.mintlify.site/id/integrations/mcp.md). |
| Chatwoot | `CHATWOOT_DEVICE_ID` untuk satu inbox, atau konfigurasi per perangkat untuk satu inbox per slot. Lihat [Chatwoot](https://gowa-docs.mintlify.site/id/integrations/chatwoot.md). |

## Batasan dan hal yang perlu diperhatikan

* WhatsApp mengizinkan hingga empat perangkat pendamping tertaut per akun. Setiap slot GOWA yang dipasangkan ke akun tersebut menggunakan satu jatah.
* WhatsApp melepas tautan perangkat pendamping jika ponsel terus offline selama sekitar 14 hari.
* Sinkronisasi riwayat setelah pemasangan bersifat parsial dan dikendalikan oleh WhatsApp; GOWA menyimpan data yang diterimanya di penyimpanan chat.
* Pembacaan chat dan pesan untuk pengguna menggunakan identitas penyimpanan akun yang sedang login. Jangan menggunakan header perangkat milik slot lain saat mencari pesan suatu slot. Slot yang dipasangkan ulang menerima event melalui kliennya saat ini.
* Setiap slot merupakan koneksi WhatsApp penuh. Penggunaan memori dan CPU meningkat seiring jumlah slot dan volume trafik.


## Related topics

- [Server MCP](https://gowa-docs.mintlify.site/id/integrations/mcp.md)
- [Referensi API](https://gowa-docs.mintlify.site/id/api-reference/introduction.md)
- [Tambah perangkat baru](https://gowa-docs.mintlify.site/id/api-reference/device/tambah-perangkat-baru.md)
- [Logout perangkat aktif (mempertahankan slot perangkat)](https://gowa-docs.mintlify.site/id/api-reference/app/logout-perangkat-aktif-mempertahankan-slot-perangkat.md)
- [Instalasi](https://gowa-docs.mintlify.site/id/installation.md)


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