Webhooks Integrados - Erro ao enviar webhook - possíveis causas
![](https://docs.sprinthub.com/~gitbook/image?url=https%3A%2F%2F3534414179-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F9FzUKkagBNy5uQ7AtGNa%252Fuploads%252F6ZXcb5KmlborLdOPDTPb%252Fundraw_server_down_s4lk.png%3Falt%3Dmedia%26token%3D671ee0aa-11e6-48ac-9f57-2248de071d84&width=768&dpr=4&quality=100&sign=fc49f0b8&sv=1)
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.
![](https://docs.sprinthub.com/~gitbook/image?url=https%3A%2F%2F3534414179-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F9FzUKkagBNy5uQ7AtGNa%252Fuploads%252FMnRoJUL7YgcDQ6IFuCOP%252F2.png%3Falt%3Dmedia%26token%3Df2e2d667-0b6b-4155-b273-c062fd3e29a3&width=768&dpr=4&quality=100&sign=e6c9ea21&sv=1)
![](https://docs.sprinthub.com/~gitbook/image?url=https%3A%2F%2F3534414179-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F9FzUKkagBNy5uQ7AtGNa%252Fuploads%252FCSphRyd4qFk1CEsMcYBe%252F1.png%3Falt%3Dmedia%26token%3D8bce5328-4b7e-476c-a0b7-a3b06d3dd977&width=768&dpr=4&quality=100&sign=d63c3990&sv=1)
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:
![](https://docs.sprinthub.com/~gitbook/image?url=https%3A%2F%2F3534414179-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F9FzUKkagBNy5uQ7AtGNa%252Fuploads%252F2kixSlG2z6zVdu2QYBhp%252F3.png%3Falt%3Dmedia%26token%3D3e92c517-9310-499a-99b0-b60c08992890&width=768&dpr=4&quality=100&sign=456624c1&sv=1)
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.
![](https://docs.sprinthub.com/~gitbook/image?url=https%3A%2F%2F3534414179-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F9FzUKkagBNy5uQ7AtGNa%252Fuploads%252FUkAz2Z8Hcr7JDELRyC9G%252F4.png%3Falt%3Dmedia%26token%3D54b8f587-9fb1-49b8-87c2-f37d5b53b15e&width=768&dpr=4&quality=100&sign=10d843e8&sv=1)
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.
![](https://docs.sprinthub.com/~gitbook/image?url=https%3A%2F%2F3534414179-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F9FzUKkagBNy5uQ7AtGNa%252Fuploads%252Fq4dho4lXxnOKb2g1fc6d%252F5.png%3Falt%3Dmedia%26token%3D25960bc3-d0a0-4dc3-b096-b0a68b7f8d41&width=768&dpr=4&quality=100&sign=9a83de85&sv=1)
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.
Last updated