Skip to main content
GOWA pushes pairing and device events over /ws. Each frame contains a JSON object with a machine-readable code, a human-readable message, and a result whose shape depends on the event.

Connect

Use /ws under your APP_BASE_PATH, such as wss://gowa.example.com/gowa/ws. Select a device with ?device_id=<id>. When Basic Auth is enabled, browser clients pass the URL-encoded base64 value of user:password as authorization. Clients that can set the Authorization header can use Basic Auth through that header. Use wss:// and redact the query string in proxy logs. Add the dashboard origin to GOWA’s trusted browser origins if you host it separately. Every connected socket receives each broadcast, even when the connection specifies a device. Use result.device_id to identify the affected slot when present. Grant WebSocket access only to callers trusted with all devices.

Event payloads

Refresh device state

To request a list over the socket, send {"code":"FETCH_DEVICES"} as a text frame. GOWA broadcasts the resulting LIST_DEVICES event to all sockets. To get current state after reconnecting or pairing, call GET /devices or GET /devices/{device_id}/status. WebSocket events are transient.
See Passkey pairing for the REST calls that complete a passkey request. Use webhooks to process WhatsApp messages and receipts.