A etapa Wait for Webhook pausa um workflow até receber uma requisição webhook, sendo ideal para processos que exigem entrada externa antes de continuar.
Imagine que seu workflow precisa integrar-se com um sistema externo — como um aplicativo de terceiros para verificação de identidade. Com Wait for Webhook, o workflow para nesta etapa até o sistema externo enviar uma resposta webhook. Após receber, a tarefa retoma e age com base nos dados fornecidos.
Exemplos
Verificação de Identidade: Pause o workflow até que um serviço de terceiros confirme a identidade do usuário.
Confirmação de Pagamento: Aguarde um webhook do seu provedor de pagamento para confirmar uma transação antes de prosseguir.
Processamento de Pedido: Pause até que seu sistema de inventário envie uma atualização sobre a disponibilidade de estoque.
Processos de Aprovação: Segure o workflow até que uma ferramenta de terceiros envie um status de aprovação ou rejeição.
Este recurso garante que seus workflows sejam contínuos e sincronizados com sistemas externos, reduzindo intervenção manual e mantendo a eficiência!
Adicione Wait for Webhook a um workflow
Para adicionar uma etapa Wait for Webhook ao seu workflow:
Vá para Fin AI Agent > Workflows e adicione um novo workflow ou abra um existente.
Então clique em Add step e selecione Wait for Webhook.
Selecione o bloco Wait for Webhook para configurá-lo.
Coloque o workflow em funcionamento.
Melhores práticas para Wait for Webhook
Adicione um nome claro à etapa para facilitar a identificação das variáveis temporárias criadas para a etapa.
Configure corretamente o Example request incluindo todos os campos que você espera receber no callback do webhook dentro do objeto data.
Garanta que o webhook retorne um corpo JSON que corresponda à estrutura da etapa. Se a estrutura JSON for atualizada, nenhum dado será recebido. Campos ausentes na configuração também tornarão esses campos inacessíveis na tarefa.
Clique no botão "Copy" para copiar a URL do webhook para sua área de transferência. No site do terceiro onde o webhook é disparado, certifique-se de que o
conversationIdseja passado conforme esperado.
Nota:
O endpoint do webhook suporta idempotência para tentar requisições com segurança e evitar que a mesma operação seja realizada mais de uma vez. Ao enviar uma requisição, inclua um cabeçalho "Idempotency-Key" com um valor único. Recomendamos usar UUIDs. As chaves de idempotência expiram após 24 horas.
A etapa Wait for Webhook não aguardará indefinidamente e tem um limite interno de 7 dias. Se um webhook não for recebido dentro de 7 dias após alcançar a etapa, ela expirará. Não é possível alterar esse limite.