Passar para o conteúdo principal

Aguardar webhook em workflows Fin

Como pausar um workflow e aguardar um evento no seu sistema externo para disparar uma solicitação webhook.

A etapa Aguardar webhook pausa um workflow até receber uma solicitação webhook, sendo ideal para processos que exigem entrada externa antes de continuar.

Imagine que seu workflow precisa integrar-se a um sistema externo — como um aplicativo de terceiros para verificação de identidade. Com Aguardar webhook, o workflow para nesta etapa até o sistema externo enviar uma resposta webhook. Uma vez recebida, a tarefa retoma e age com base nos dados fornecidos. No contexto da integração Zendesk, o workflow pode pausar interações com clientes até que uma resposta webhook forneça uma atualização de status ou resolução. Para garantir uma experiência suave, é útil adicionar uma mensagem de aviso antes desta etapa, incentivando os clientes a iniciar uma nova conversa se tiverem mais perguntas durante a pausa.

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.

  • Atualizações de Clientes Zendesk: Pause o workflow em um sistema de ticket Zendesk enquanto aguarda uma resposta webhook para fornecer atualizações de status ou resolução do ticket.

Este recurso garante que seus workflows sejam contínuos e sincronizados com sistemas externos, reduzindo a intervenção manual e mantendo a eficiência!


Adicione "Aguardar webhook" a um workflow

Para adicionar uma etapa "Aguardar webhook" ao seu workflow:

  1. Vá para a etapa de implantação relevante e abra seu workflow.

  2. Então clique em Adicionar etapa e selecione Aguardar webhook.

  3. Selecione o bloco Aguardar webhook para configurá-lo.

  4. Coloque o workflow em execução.


Melhores práticas para Aguardar webhook

  • Adicione um nome claro à etapa para facilitar a identificação das variáveis temporárias criadas para a etapa.

  • Configure corretamente a Exemplo de solicitação incluindo todos os campos que você espera receber no callback webhook dentro do objeto de dados.

  • 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 "Copiar" para copiar a URL do webhook para sua área de transferência. No site de terceiros onde o webhook é acionado, certifique-se de que o conversationId seja passado conforme esperado.

  • Notifique os clientes proativamente se a interação deles for pausada devido a uma configuração webhook. Use mensagens de aviso para evitar confusão durante os períodos de espera.

Nota: O endpoint webhook suporta idempotência para tentar solicitações com segurança e evitar que a mesma operação seja realizada mais de uma vez. Ao enviar uma solicitação, inclua um cabeçalho "Idempotency-Key" com um valor único. Recomendamos usar UUIDs. As chaves de idempotência expiram após 24 horas.

Para conversas do Zendesk Sunshine Messenger, certifique-se de que o endpoint webhook Sunshine apropriado esteja configurado no Fin. Esta etapa é crítica para processar mensagens em tempo real.

Respondeu à sua pergunta?