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

# Event WebSocket

> Hubungkan dasbor ke WebSocket GOWA, tangani event perangkat dan penautan, lalu perbarui status perangkat setelah tersambung ulang atau menyelesaikan login.

GOWA mengirim event penautan dan perangkat melalui `/ws`. Setiap frame berisi objek JSON dengan `code` yang dapat dibaca mesin, `message` yang dapat dibaca manusia, serta `result` yang strukturnya bergantung pada event.

## Menghubungkan

Gunakan `/ws` di bawah `APP_BASE_PATH` Anda, misalnya `wss://gowa.example.com/gowa/ws`. Pilih perangkat dengan `?device_id=<id>`. Saat Basic Auth diaktifkan, klien browser mengirim nilai base64 dari `user:password` yang telah dikodekan untuk URL sebagai `authorization`. Klien yang dapat mengatur header `Authorization` dapat menggunakan Basic Auth melalui header tersebut. Gunakan `wss://` dan samarkan string kueri dalam log proxy. Tambahkan origin dasbor ke [origin browser tepercaya](https://gowa-docs.mintlify.site/id/authentication.md#cors) GOWA jika dasbor dihosting secara terpisah.

Setiap socket yang terhubung menerima semua siaran, meskipun koneksinya menentukan perangkat tertentu. Gunakan `result.device_id` untuk mengidentifikasi slot yang terkait jika field tersebut tersedia. Berikan akses WebSocket hanya kepada pemanggil yang dipercaya untuk mengakses semua perangkat.

## Payload event

| `code` | Kapan diterima | `result` |
| - | - | - |
| `LIST_DEVICES` | Klien mengirim `FETCH_DEVICES`. | Daftar perangkat dengan entri `name`, `device`, dan `jid`. |
| `LOGIN_SUCCESS` | WhatsApp menautkan perangkat. | `null`. Perbarui status perangkat melalui REST. |
| `PASSKEY_REQUEST` | WhatsApp meminta assertion passkey. | `device_id`, `challenge` (opsi WebAuthn). |
| `PASSKEY_CONFIRMATION` | WhatsApp melaporkan hasil penyerahan proses passkey. | `device_id`, `code`, `skip_handoff_ux`. Jika `skip_handoff_ux` bernilai true, alur QR yang aktif mengirim konfirmasi secara otomatis. Jika tidak, cocokkan kode dengan yang ada di ponsel lalu panggil `POST /app/passkey/confirm`. |
| `PASSKEY_ERROR` | Penautan passkey gagal. | `device_id`, `continuation`. Baca teks error dari `message`. |
| `DEVICE_LOGGED_OUT` | Perangkat logout dan slotnya tetap disimpan. | `device_id` serta `reason` untuk logout jarak jauh atau `devices` untuk logout melalui API. Struktur daftar bergantung pada endpoint logout. |
| `DEVICE_REMOVED` | Slot perangkat dihapus. | `device_id`, `devices` (slot yang tersisa). |
| `DEVICE_STREAM_REPLACED` | Klien lain terhubung menggunakan sesi WhatsApp yang sama. | `device_id`. |
| `DEVICE_TEMPORARY_BAN` | WhatsApp melaporkan pemblokiran sementara. | `device_id`, `code`, `reason`, `expires_in_seconds`, dan `expires_at` jika WhatsApp menyertakan waktu berakhir. |
| `DEVICE_REACHOUT_TIMELOCK` | WhatsApp melaporkan atau mencabut pembatasan untuk memulai chat baru. | `device_id`, `is_active`, serta `enforcement_type` dan `ends_at` yang bersifat opsional. |
| `DEVICE_WEBHOOK_UPDATED` | URL webhook perangkat berubah. | `device_id`, `webhook_url`. |
| `DEVICE_WEBHOOK_CONFIG_UPDATED` | Pengaturan webhook perangkat berubah. | `device_id`. |

## Memperbarui status perangkat

Untuk meminta daftar melalui socket, kirim `{"code":"FETCH_DEVICES"}` sebagai frame teks. GOWA menyiarkan event `LIST_DEVICES` yang dihasilkan ke semua socket. Untuk mendapatkan status terkini setelah tersambung ulang atau penautan, panggil `GET /devices` atau `GET /devices/{device_id}/status`. Event WebSocket bersifat sementara.

```javascript theme={null}
const url = new URL("wss://gowa.example.com/ws");
url.searchParams.set("device_id", "my-device");
url.searchParams.set("authorization", btoa("admin:changeme"));

const socket = new WebSocket(url);
socket.addEventListener("open", () => {
  socket.send(JSON.stringify({ code: "FETCH_DEVICES" }));
});
socket.addEventListener("message", ({ data }) => {
  const { code, result } = JSON.parse(data);
  if (code === "LIST_DEVICES") {
    console.log("Device list", result);
  }
  if (code === "DEVICE_LOGGED_OUT" && result?.device_id === "my-device") {
    console.log("Device logged out", result.device_id);
  }
});
```

Lihat [Penautan passkey](https://gowa-docs.mintlify.site/id/authentication.md#passkey) untuk panggilan REST yang menyelesaikan permintaan passkey. Gunakan [webhook](https://gowa-docs.mintlify.site/id/concepts/webhooks.md) untuk memproses pesan WhatsApp dan tanda terima.


## Related topics

- [Autentikasi](https://gowa-docs.mintlify.site/id/authentication.md)
- [Autentikasi API](https://gowa-docs.mintlify.site/id/api-reference/authentication.md)
- [Multi-Perangkat & Pemilihan Perangkat](https://gowa-docs.mintlify.site/id/concepts/multidevice.md)
- [Webhook](https://gowa-docs.mintlify.site/id/concepts/webhooks.md)
- [Referensi API](https://gowa-docs.mintlify.site/id/api-reference/introduction.md)


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