> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://ajuda.bilion.com.br/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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](https://bucket-bilion-producao.s3.us-east-2.amazonaws.com/uploads/central-ajuda/integracoes-webhooks.png)

## 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

- [Configurar um webhook](https://ajuda.bilion.com.br/pt-br/article/configurar-um-webhook-cknypz/)
- [Eventos de webhook](https://ajuda.bilion.com.br/pt-br/article/eventos-de-webhook-132amkq/)