Webhooks
Registre um endpoint, receba eventos
Em Configurações, a aba Webhooks permite adicionar um endpoint que recebe callbacks HTTP quando eventos ocorrem nos seus flows. O Cadenio faz POST de um payload para sua URL conforme as coisas acontecem, e o Histórico de entrega mostra cada tentativa para você depurar falhas.
Passo a passo
Configure um webhook
Adicione um webhook
Clique em Adicionar webhook e cole a URL do endpoint que deve receber os eventos, geralmente uma rota no seu próprio serviço.
Escolha os eventos
Selecione quais eventos disparam um callback, por exemplo run iniciado ou tarefa concluída, para receber só o que importa.
Verifique a entrega
O Cadenio faz POST de um payload assinado para sua URL conforme os eventos acontecem. O Histórico de entrega registra cada tentativa, seu status e permite reenviar.
Saída vs. entrada
- Webhook de saída
- O Cadenio te chama: faz POST no seu endpoint quando um evento acontece, para seus sistemas reagirem em tempo real.
- Webhook de entrada
- Você chama o Cadenio: um sistema externo aciona uma URL do Cadenio para iniciar um run ou atualizar dados, útil para disparar flows de fora.
- Histórico de entrega
- Um log de cada tentativa de callback com status e payload, para entregas falhas serem fáceis de identificar e reenviar.
Perguntas frequentes
Como sei que um webhook veio do Cadenio?
Os payloads são assinados. Verifique a assinatura no seu endpoint antes de confiar na requisição, para ninguém forjar eventos.
E se meu endpoint estiver fora do ar?
O histórico de entrega registra a falha. Você pode inspecionar a tentativa e reenviar quando o endpoint voltar, então eventos não se perdem em silêncio.