Como podemos te ajudar?
Documentação da API
Guia de transição Novo Inbox
Soluções de IA

Como utilizar o Painel de Webhooks

Foto do autor
Alexandre Melo

O Painel de Webhooks foi criado para facilitar a sua rotina de monitoramento e troubleshooting das integrações entre a Huggy e os seus sistemas.

Por meio dele, você pode:

  • Acompanhar a saúde da integração: Monitore indicadores gerais em tempo real, como o volume de envios, picos de utilização, percentual de sucesso e a latência (tempo de resposta) do seu servidor.
  • Inspecionar eventos no detalhe: Acesse os logs individuais de cada requisição para debugar falhas, consultando o código de status HTTP, o payload exato enviado pela Huggy e o corpo da resposta recebida.
  • Acompanhar e contornar falhas de entrega: Caso o seu servidor passe por instabilidades, acompanhe as retentativas automáticas da Huggy e faça o reenvio manual de eventos que não foram entregues.

Acessando o Painel de Webhooks

Para acessar o painel, clique na sua foto de perfil e vá para Configurações > Painel de Webhooks.

Desempenho do Webhook

Acompanhe o funcionamento das suas integrações por meio de indicadores gerais e individuais.

Total de requisições

Exibe o volume total de requisições realizadas pelos Webhooks no período selecionado.

Percentual de sucesso

Apresenta o percentual de eventos que foram entregues com sucesso.

💡 Identifique rapidamente se existe um volume relevante de falhas na integração.

Volume de notificações

Acompanhe o gráfico ao longo do tempo para identificar rapidamente picos de requisições ou variações no comportamento dos eventos.

Tempo de resposta

Monitore o tempo que o seu servidor leva para responder às requisições da Huggy.

💡 Valores elevados costumam indicar lentidão ou sobrecarga no seu sistema e podem ser investigados com a inspeção individual dos eventos.

Eventos

Visualize individualmente os detalhes e situação das requisições feitas pela Huggy.

💡 Acompanhe a coluna Tentativas para identificar quantas tentativas de envio foram realizadas para o evento.

Inspecionando um evento

Para investigar um evento específico, utilize a opção Inspecionar evento, clicando no ícone de três pontos (⋮).

Assim, você obtém informações detalhadas sobre uma determinada execução do Webhook:

💡 Utilize essas informações para identificar em qual etapa ocorreu uma falha ou validar os dados enviados para uma integração.

Retentativas automáticas

A Huggy possui um mecanismo de retentativas que eleva as chances de entrega, mesmo quando o seu sistema de destino apresenta instabilidades temporárias.

Caso o envio inicial falhe, realizamos até 5 tentativas automáticas em intervalos progressivos.

Tentativa

Intervalo

30 segundos

2 minutos

5 minutos

10 minutos

15 minutos

Reenviando eventos manualmente

Se todas as tentativas de envio falharem, você ainda pode tentar enviar o evento manualmente.

Para isso, acesse Inspecionar evento e clique no botão Reenviar, no canto superior direito (ele só aparecerá se o evento permitir um novo envio).

É preciso aguardar um intervalo mínimo de 5 minutos entre as tentativas, e você poderá acompanhar o resultado dessa nova execução direto pelo painel.

Lidando com falhas recorrentes

O Painel de Webhooks é o seu principal aliado para diagnosticar instabilidades antes que elas afetem a sua operação.

Porém, é fundamental manter a saúde da sua integração em dia: se o seu servidor de destino apresentar erros consecutivos ou exceder o tempo limite de resposta com muita frequência, a Huggy poderá desativar o webhook automaticamente como medida de proteção.

Entenda os detalhes sobre essas regras de desativação por falhas persistentes.

Esse artigo tirou suas dúvidas?

🚀 Primeira vez por aqui? Fale conosco e saiba como a Huggy pode gerar resultados reais para você usando conversas.
Powered by HelpDocs (opens in a new tab)