Webhook

Webhooks em tempo real para cada evento

Receba recibos de entrega, mensagens recebidas e mudancas de status instantaneamente. Um unico endpoint para WhatsApp, SMS e Email.

Comecar gratuitamente Documentacao da API

Webhook Manager: receba cada evento em tempo real

O Webhook Manager da Chat API permite-lhe registar um endpoint HTTPS no seu servidor e receber notificações instantâneas para cada evento gerado pelos seus canais de mensagens: mensagens WhatsApp recebidas, confirmações de entrega, leituras, atualizações de estado de SMS, aberturas de email e muito mais.

Ao contrário do polling tradicional, com webhooks não precisa de consultar continuamente as APIs para saber se algo aconteceu. O evento chega diretamente ao seu servidor em milissegundos, com um payload JSON estruturado e uma assinatura HMAC SHA-256 para verificar a autenticidade de cada pedido.

O sistema é concebido para máxima fiabilidade: se o seu endpoint não estiver disponível, o Webhook Manager retenta automaticamente a entrega com backoff exponencial, garantindo que nenhum evento se perca. Cada tentativa é registada no log com o payload, código de estado e tempo de resposta, tornando a depuração simples e rápida.

Funcionalidades

Tudo que voce precisa para gerenciar webhooks

Um sistema robusto e confiavel para receber eventos em tempo real de todos os seus canais.

Entrega em tempo real

Eventos entregues instantaneamente ao seu endpoint assim que ocorrem. Sem polling, sem atraso.

Logica de nova tentativa

Novas tentativas automaticas com backoff exponencial em caso de falha. Nenhum evento perdido, nunca.

Filtragem de eventos

Inscreva-se apenas nos eventos que precisa. Reduza o ruido e otimize seu servidor.

Assinatura HMAC

Cada webhook e assinado com HMAC SHA-256. Verifique a autenticidade de cada solicitacao recebida.

Logs e depuracao

Logs detalhados para cada evento enviado. Veja payload, codigo de status e tempos de resposta.

Multicanal

Eventos unificados de WhatsApp, SMS e Email em um unico endpoint. Um formato, tres canais.

Como funciona

Configuracao em 3 passos

Do endpoint a recepcao de eventos em minutos.

1

Configuracao

Configure o endpoint

Registre a URL do seu servidor que recebera eventos. Suporta HTTPS com verificacao de certificado.

2

Filtro

Selecione os tipos de eventos

Escolha quais tipos de eventos receber: mensagens recebidas, confirmacoes de entrega, mudancas de status e mais.

3

Ativo

Receba em tempo real

Eventos chegam ao seu endpoint em milissegundos com payload JSON completo e assinatura HMAC.

Exemplo de payload

Payload JSON estruturado

Cada evento de webhook e entregue com um payload JSON claro e consistente. Facil de analisar, facil de integrar.

message.receivedmessage.deliveredmessage.readmessage.failedtemplate.approved
POST → your-server.com/webhook 
{
  "event": "message.received",
  "channel": "whatsapp",
  "timestamp": "2026-03-14T10:30:00Z",
  "data": {
    "from": "+39123456789",
    "message": "Hello!",
    "type": "text"
  }
}

99.99%

Uptime

<200ms

Entrega

50M+

Eventos / mes

3

Canais

Perguntas frequentes sobre o Webhook Manager

O que é um webhook e como funciona?
Um webhook é uma notificação HTTP que o servidor da Chat API envia ao seu endpoint sempre que ocorre um evento (ex. mensagem recebida, entrega confirmada). O seu servidor não precisa fazer nada de especial: basta expor um URL HTTPS que aceite pedidos POST em formato JSON.
Como posso verificar que os pedidos webhook são autênticos?
Cada pedido webhook inclui um cabeçalho de assinatura calculado com HMAC SHA-256 usando a chave secreta da sua conta. Compare a assinatura recebida com a que calcula do seu lado: se coincidirem, o pedido é autêntico e não foi alterado em trânsito.
O que acontece se o meu endpoint estiver indisponível?
O Webhook Manager retenta automaticamente a entrega até 5 vezes com backoff exponencial (5s, 25s, 125s, 625s, 3125s). Se todas as tentativas falharem, o evento é registado como não entregue no log do sistema, onde pode analisá-lo e acionar uma reentrega manual.
Posso filtrar eventos para receber apenas os que preciso?
Sim. Ao configurar o seu webhook pode selecionar exatamente quais os tipos de eventos que deseja receber: message.received, message.delivered, message.read, message.failed, template.approved e outros. Isto reduz o tráfego para o seu servidor e simplifica a sua lógica de processamento.
O Webhook Manager funciona com todos os canais?
Sim. Um único endpoint recebe eventos dos três canais: WhatsApp, SMS e email. O payload JSON inclui sempre um campo 'channel' que identifica a fonte do evento, permitindo-lhe gerir todos os canais com uma única lógica de aplicação.
Gerenciador de Webhooks

Pronto para receber eventos em tempo real?

Configure seu primeiro webhook em minutos. Sem cartão de crédito necessário.

Comecar gratuitamente Falar com vendas