API/SSE (Eventos)

SSE (Server-Sent Events)

Receba eventos em tempo real através de Server-Sent Events

Visão geral

Server-Sent Events (SSE) permite receber eventos do WhatsApp em tempo real sem precisar fazer polling.

Stream de instância: Receba eventos de uma instância específica
Stream global: Receba eventos de todas as instâncias
Tempo real: Eventos são enviados assim que ocorrem
Reconexão automática: A conexão é mantida e reconecta automaticamente

💡 Dica: SSE é ideal para aplicações que precisam de atualizações em tempo real, como dashboards ou aplicações de monitoramento.

Endpoints

GET/sse/:instanceStream SSE para uma instância

GET/sse/Stream SSE global (todas as instâncias)

Exemplo de uso

JavaScript

// Conectar ao stream SSE
const eventSource = new EventSource('http://localhost:8080/sse/minha-instancia', {
  headers: {
    'X-API-Key': 'sua-api-key'
  }
});

// Escutar eventos
eventSource.onmessage = (event) => {
  const data = JSON.parse(event.data);
  console.log('Evento recebido:', data);
};

// Escutar eventos específicos
eventSource.addEventListener('message.received', (event) => {
  const message = JSON.parse(event.data);
  console.log('Nova mensagem:', message);
});

// Fechar conexão
eventSource.close();