Logs de entrega e reenvio

3 min de leitura5

Toda vez que um webhook é enviado, fica registrado um log — um histórico de cada entrega. É nele que você acompanha se os avisos estão chegando ao seu sistema, investiga o que deu errado quando algo falha e reenvia entregas que não foram concluídas. Você encontra tudo na aba Logs, dentro da página de Webhooks.

Filtrando os envios

No topo da lista há dois filtros que ajudam a achar o que você precisa:

  • Webhook — veja os envios de um webhook específico ou de todos.

  • Status — filtre por Pendente, Sucesso ou Falha (ou todos).

Lendo a lista

Cada linha representa um envio e mostra:

  • Disparado em — data e hora do envio.

  • Webhook — o nome do webhook e a URL de destino.

  • StatusPendente (em andamento), Sucesso ou Falha. Em caso de falha, passe o mouse para ver a mensagem de erro.

  • HTTP — o código de resposta que o seu servidor devolveu (por exemplo, 200 para sucesso).

  • Tentativas — quantas vezes o envio foi tentado.

  • Duração — quanto tempo levou, em milissegundos.

Vendo o detalhe de um envio

Clique no ícone de ver detalhes (o olho) para abrir a ficha completa daquele envio. Ali você encontra o status, o código HTTP, o número de tentativas, a duração, a URL de destino, o CNPJ do lead, a mensagem de erro (quando houver) e — o mais útil para depurar — o payload enviado, a resposta recebida do seu servidor e os headers da resposta. É a forma de entender exatamente o que foi mandado e o que voltou.

Reenviar uma entrega que falhou

Se um envio aparece como Falha, você pode reprocessá-lo: clique no ícone de reenvio (a seta circular) na linha, ou use o botão "Reprocessar agora" dentro do detalhe. Isso coloca o envio de novo na fila e gera um novo registro de log.

Importante: o reenvio está disponível somente para envios com status Falha. Envios que já tiveram sucesso ou que ainda estão pendentes não podem ser reprocessados — o botão fica indisponível nesses casos.

Quando usar os logs

  • Confirmar a integração: logo após configurar um webhook, importe um lead e veja se o envio aparece como Sucesso.

  • Investigar falhas: se o seu sistema não recebeu algo, confira o status, o código HTTP e a resposta no detalhe para entender o motivo.

  • Recuperar entregas: depois de corrigir um problema no seu servidor, reprocesse os envios que falharam para não perder nenhum lead.


Resumindo: a aba Logs registra cada envio de webhook com status, código HTTP, tentativas e duração. Use o detalhe para ver payload e resposta e, quando um envio falhar, reprocesse-o com um clique — lembrando que o reenvio vale só para os que falharam.

Este artigo foi útil?