Como tratar erros e utilizar Webhooks

⌘K
  1. Home
  2. Documentação
  3. Desenvolvedores
  4. Como tratar erros e utilizar Webhooks

Como tratar erros e utilizar Webhooks

Tratamento de falhas

Uma integração externa pode falhar por diferentes motivos, como indisponibilidade do sistema ou erro na requisição.

Para esses casos, o bloco Requisição possui uma saída Fail, que pode ser conectada a outro bloco do fluxo para definir o que deve acontecer quando a chamada não for concluída corretamente.

Exemplo de tratamento

A documentação apresenta o seguinte cenário:

API indisponível → saída Fail → mensagem informando indisponibilidade → transferência para um atendente.

Assim, o cliente não fica preso em uma etapa que depende de um sistema externo.

Como configurar

  1. Adicione o bloco Requisição;
  2. Configure a integração;
  3. Localize a saída Fail;
  4. Conecte essa saída a uma etapa alternativa;
  5. Defina a ação desejada;
  6. Salve;
  7. Teste também o cenário de falha.

Webhooks

O mesmo bloco de Requisição pode ser utilizado para enviar informações a um Webhook.

Um exemplo apresentado na documentação é realizar um POST para um sistema interno ao concluir um cadastro.

O fluxo poderia funcionar assim:

Cliente conclui cadastro → Chatbot faz POST → sistema externo recebe os dados → fluxo continua

Isso pode ser utilizado para conectar o atendimento a outros sistemas que possuam um endpoint preparado para receber a requisição.

Observação Importante

A URL, autenticação, payload e resposta do Webhook dependem do sistema externo.

Sempre valide a estrutura exigida pelo destino antes de configurar a requisição.

Como podemos ajudar?