# Guia de WebSocket

Receba eventos em tempo real.

## Conectar

Abra `wss://app.vibecash.com.br/v1/websocket` no ambiente publicado ou `ws://127.0.0.1:4175/v1/websocket` no ambiente local. Passe a chave da conta no header `X-API-Key` com a permissão `websocket/connect`. A chave fica no seu servidor.

## Exemplo em Node.js

```
import WebSocket from 'ws';

const socket = new WebSocket('wss://app.vibecash.com.br/v1/websocket', {
  headers: { 'X-API-Key': process.env.VIBECASH_API_KEY }
});
socket.on('message', raw => {
  const event = JSON.parse(raw.toString());
  if (event.type === 'ready') return;
  console.log(event.event, event.id);
  socket.send(JSON.stringify({ type: 'ack', id: event.id }));
});
socket.on('error', error => console.error(error.message));
```

## Eventos e reconexão

Após `ready`, a conexão recebe novos eventos PIX da sua conta. O ACK é opcional. Use Integrações → WebSocket → Testar evento para emitir `webhook.test`. Após reconectar, consulte os pagamentos e saques pendentes pela API para recuperar eventos que aconteceram durante a desconexão.
