> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zapmeow.com/llms.txt
> Use this file to discover all available pages before exploring further.

# WebSocket

> Os mesmos eventos do webhook, ao vivo, em /ws.

```text theme={null}
wss://<host>/ws?key=<chave>&session=suporte&events=message.any,session.status
```

| Parâmetro | Efeito |
| - | - |
| `key` | a chave de API (ou envie `X-Api-Key` fora do navegador) |
| `session` | uma sessão; vazio ou `*` = todas |
| `events` | lista separada por vírgula; vazio = todos |

A primeira mensagem é `{"event":"hello","version":"..."}`. Depois chega um JSON por evento: `{"event","session","payload"}`, igual ao corpo do webhook. O servidor manda ping a cada 25 s.

Cliente lento perde eventos em vez de travar o WhatsApp: se precisa de garantia de entrega, use o webhook.

```js theme={null}
const ws = new WebSocket(`wss://${host}/ws?key=${key}&events=message.any`);
ws.onmessage = (e) => console.log(JSON.parse(e.data));
```


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