Webhooks Integrados - Erro ao enviar webhook - possíveis causas

Como verificar se seu webhook não está funcionando?

A cada chamada é feito um relatório do sistema que é transformado em gráfico. segue os prints a seguir.

Se esses gráficos não estiverem com nenhuma atividade, significa que o webhook nunca foi chamado e assim faltando alguma informação.

Possíveis Erros Relacionados ao Webhook:

Durante a configuração e uso de webhooks, podem surgir vários erros associados ao alias e à chave secreta:

Alias Incorreto: Se você modificou o alias configurado e não alterou na plataforma que você quer conectar, então está causando um erro de comunicação. É necessário verificar se o Alias ou o link está correta na plataforma (formulário, landing page, etc) externo.

Chave Secreta Inválida: Uma chave secreta incorreta ou não atualizada pode resultar na rejeição dos eventos pelo sistema de destino. Isso pode causar falhas na entrega de eventos importantes e na sincronização entre sistemas.

Exposição da Chave Secreta: Se a chave secreta for exposta, seja por compartilhamento acidental ou por um vazamento de dados, terceiros não autorizados podem enviar eventos falsificados ou maliciosos, comprometendo a integridade do sistema.

Campos configurados de forma incorreta: se estiver requisitando campos que não existem dentro do seu webhook integrado, ele vai voltar erro porque não há campos para preencher.

3. Resolvendo os Erros:

Aqui estão algumas medidas para resolver esses erros e garantir o bom funcionamento dos webhooks:

• Verificação Regular do Alias: Verifique regularmente se o alias configurado corresponde ao esperado pelo sistema de destino. Isso pode ser feito através da tela de configuração da integração, onde é possível visualizar e modificar o alias conforme necessário.

• Atualização da Chave Secreta: Certifique-se de que a chave secreta esteja atualizada e corresponda à configurada no sistema de destino. Caso necessário, atualize a chave secreta na tela de configuração da integração para garantir a autenticação correta dos eventos.

• Segurança da Chave Secreta: Mantenha a chave secreta segura e evite expô-la desnecessariamente. Limite o acesso à chave e siga as práticas recomendadas de segurança para proteger a integridade do sistema.

• Revisão do Mapeamento de Campos: Verifique o mapeamento dos campos no webhook e no sistema de destino. Certifique-se de que os campos solicitados correspondam aos dados disponíveis na origem e que o mapeamento esteja configurado corretamente.