Webhooks
Eventos em tempo real para cada entrega e verificação
Receba recibos de entrega, resultados de verificação e mudanças de estado diretamente na sua aplicação — com entrega garantida e processamento idempotente.
Porquê Katembe Webhooks
Visibilidade operacional em todos os produtos
Payloads assinados
Cada webhook é assinado com HMAC para que possa verificar a autenticidade antes de processar.
Retry automático
Entregas falhadas são retentadas com exponential backoff — sem mensagens perdidas, sem reconciliação manual.
Eventos idempotentes
IDs de eventos únicos permitem desduplicar e reproduzir eventos em segurança sem efeitos colaterais.
Catálogo completo de eventos
Subscreva eventos de entrega, falha, verificação e sistema em todos os produtos Katembe.
Eventos de Entrega
Saiba o estado exato de cada mensagem enviada
Receba recibos de entrega granulares para SMS, WhatsApp, voice e email — incluindo códigos de estado de operadora e timestamps. Atualize o estado interno de pedidos, acione fluxos de seguimento ou alerte sobre falhas em tempo real.
Ver schema de eventos de entregaAutomação Operacional
Construa workflows fiáveis sobre streams de eventos
Use eventos de webhook para acionar máquinas de estado internas, reconciliar entregas falhadas e escalar falhas de alta prioridade. A Katembe trata retry e desduplicação para que a sua lógica de handler seja simples.
Melhores práticas de webhooksConfiguração rápida
Registe um endpoint e comece a receber eventos
Aponte a Katembe para qualquer endpoint HTTPS — a sua API existente, um URL de ingestão em fila ou uma função serverless. Os eventos chegam em segundos após a ação subjacente.
curl -X POST https://api.katembe.io/v1/webhook-endpoints \
-H "Authorization: Bearer <api_key>" \
-d "url=https://app.example.com/hooks/katembe" \
-d "events[]=message.delivered" \
-d "events[]=verification.completed"
"Usamos os webhooks da Katembe para alimentar o nosso sistema de notificações de pedidos em tempo real. Os payloads assinados e o retry automático tornaram a integração surpreendentemente simples."