Testar e depurar seu webhook

Webhook que falha em silêncio é pior que webhook nenhum, porque você acha que
está funcionando. A Bilion guarda o registro de cada envio.


Disparar um teste


No cadastro do webhook existe a opção de enviar um evento de teste. Use assim
que configurar, antes de depender dele numa venda real.


Escolha o evento, dispare, e confira do outro lado se chegou.


Ver o histórico de envios


Cada webhook tem um registro dos envios feitos, com o evento, a data e o
resultado. Abra um registro para ver o que foi enviado e o que o seu sistema
respondeu.


É por aqui que se descobre a causa real quando "a automação parou": quase sempre
o envio saiu e o outro lado respondeu erro.


Tela de webhooks, com os webhooks cadastrados


Reenviar um envio que falhou


No detalhe de um registro existe a opção de reenviar. Serve para recuperar
eventos perdidos enquanto o seu sistema estava fora do ar, sem precisar refazer
a venda.


Os erros mais comuns


O que aparece

Causa

O que fazer

Erro de tempo esgotado

Seu sistema demorou demais para responder

Responda rápido e processe depois, em segundo plano

Erro 404

A URL mudou ou expirou

Atualize a URL no cadastro

Erro 401 ou 403

O destino exige autenticação

Confira se a ferramenta de destino espera algum cabeçalho

Erro 500

Falha no seu sistema ao processar

Olhe o log do seu lado, o envio chegou


Artigos relacionados


Atualizado em: 09/09/2026