Início › Glossário › SSE (Server-Sent Events)
Glossário

O que é SSE (Server-Sent Events)?

SSE (Server-Sent Events) é uma forma simples de receber atualizações em tempo real do servidor para o navegador ou um cliente via HTTP, mantendo uma conexão aberta. Em automações, ele serve para “streamar” eventos (status, logs, notificações) sem precisar ficar consultando (polling). Não substitui webhooks; costuma complementar quando você quer uma linha do tempo ao vivo.

SSE, em português claro

Pense no SSE como um “canal de notícias” unidirecional: o cliente abre uma conexão HTTP e o servidor vai enviando mensagens conforme surgem eventos.

O ponto prático: você reduz a necessidade de ficar perguntando “tem novidade?” a cada X segundos (polling) e passa a receber “empurrado” (push) — mas só do servidor para o cliente.

SSE vs Webhook vs WebSocket (diferença que evita arquitetura torta)

Na automação, esses três termos aparecem como se fossem a mesma coisa. Não são. A escolha errada vira gambiarra: polling demais, timeout, ou dependência desnecessária de estado.

TecnologiaMelhor paraComo funcionaPegadinhas comuns
SSEAtualizações ao vivo (status/logs/progresso) para um cliente conectadoCliente abre conexão HTTP e recebe eventos contínuosNem toda infra gosta de conexões longas; precisa reconexão/retomada
WebhookNotificar um evento pontual para um endpoint seu (ex.: pagamento aprovado)Sistema A chama seu endpoint quando algo aconteceRequer endpoint público, assinatura/HMAC, idempotência e retry bem feitos
WebSocketInteração bidirecional em tempo real (chat, colaboração, controle)Conexão persistente 2 vias (cliente ↔ servidor)Mais complexo de operar; autenticação e escalabilidade pedem cuidado
PollingQuando não existe push (nem webhook, nem SSE)Seu sistema consulta periodicamente o outroCusto e latência variáveis; risco de rate limit

Quando SSE faz sentido em automações (casos bem pé no chão)

SSE brilha quando você precisa de “telemetria humana”: alguém olhando uma tela e querendo entender o que está acontecendo agora, sem ficar recarregando página ou apertando F5.

Quando NÃO usar SSE (e o que usar no lugar)

SSE não é a melhor escolha para “entrega garantida” entre sistemas. Para integrações críticas (pedido, pagamento, nota), normalmente webhook + idempotência + fila/retry é o caminho mais seguro.

Também não é o ideal para conversa bidirecional (o cliente mandar mensagens contínuas pro servidor). Aí WebSocket costuma ser mais apropriado.

Checklist rápido para operar SSE sem dor

SSE parece simples — e é — mas costuma quebrar por detalhes de operação. Se você acertar os pontos abaixo, a chance de susto cai bastante.

Perguntas frequentes

SSE substitui webhook em automação?
Não. Webhook é para um sistema avisar outro sistema de um evento (integração). SSE é para um cliente conectado acompanhar eventos ao vivo (observabilidade/UX). Em prática: webhook dispara a automação; SSE ajuda a “ver” a automação acontecendo.
SSE funciona bem atrás de proxy e CDN?
Depende da configuração. Conexões longas podem sofrer com timeouts, buffers e regras de idle. Na dúvida, teste no caminho real (CDN/WAF/reverse proxy) e use heartbeat e reconexão do lado do cliente.
SSE é melhor que polling?
Para atualizações frequentes e experiência em tempo real, geralmente sim: reduz consultas repetitivas e melhora a latência percebida. Mas polling ainda serve quando o sistema não oferece push e você precisa de algo simples e controlável.
Dá para usar SSE com n8n?
Dá para integrar SSE como conceito (por exemplo, consumindo um stream de eventos de um serviço ou expondo um endpoint no seu stack), mas o n8n é mais naturalmente “orientado a jobs” (webhooks, filas, execuções). SSE costuma entrar mais na camada de painel/observabilidade do que como gatilho principal.

Termos relacionados

← Ver glossário completo