Um webhook envia um callback HTTP em tempo real sempre que algo acontece nos seus flows, um run inicia, uma tarefa conclui, para seus outros sistemas reagirem na hora em vez de ficar consultando.
4 min de leitura · Admins e desenvolvedores
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.
A aba Webhooks. Adicione um endpoint e acompanhe cada callback no histórico de entrega.
Passo a passo
Configure um webhook
1
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.
2
Escolha os eventos
Selecione quais eventos disparam um callback, por exemplo run iniciado ou tarefa concluída, para receber só o que importa.
3
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.
Conecte o Cadenio a tudo
Veja webhooks disparando num endpoint ao vivo numa demo guiada.