# Receber eventos via SSE

`GET /sse`

Pasta: **Webhooks e SSE**

## Autenticação

```http
token: {{token}}
```

## Descrição

# Receber eventos via SSE

Abre um stream **Server-Sent Events** com eventos em tempo real da instância autenticada. Use em painéis, CRMs e monitores que precisam de push contínuo sem polling. Alternativa aos webhooks quando o consumidor é o próprio cliente (não um servidor HTTP).

## Endpoint

`GET {{baseUrl}}/sse`

## Autenticação

Envie o token da instância no header `token: {{token}}` (também aceito como query `?token=`).

## Parâmetros

Não há parâmetros de filtro neste endpoint: o stream entrega os eventos da instância autenticada. Comentários SSE de keep-alive (`: ping`) são enviados periodicamente.

## Exemplo de Requisição

```bash
curl -N '{{baseUrl}}/sse' \
  --header 'token: {{token}}' \
  --header 'Accept: text/event-stream'
```

## Resposta de Sucesso

Conexão persistente (`Content-Type: text/event-stream`). Exemplo de frames:

```text
: connected

event: messages
data: {"event":"messages","instance_id":"uuid-instancia","data":{},"timestamp":1710000000}

: ping
```

## Erros comuns

- `401 Unauthorized`: token ausente ou inválido.
- Conexão fecha logo após abrir: proxy/load balancer sem suporte a streaming (desative buffering; a API envia `X-Accel-Buffering: no`).
- Timeout em proxies: aumente idle timeout ou mantenha o `-N` (sem buffer) no curl.

## Observações

- Use `curl -N` para não bufferizar a saída.
- O hub filtra por `instance_id` da instância autenticada.
- Não há filtros `events` / `excludeMessages` neste endpoint (esses campos existem nos webhooks).

## cURL

```bash
curl -X GET "{{baseUrl}}/sse" \
  -H "token: {{token}}"
```

---

[Índice da pasta](./index.md) · [Índice geral](../index.md) · [UI](https://gozap.dev/docs?op=webhooks-e-sse/receber-eventos-via-sse)