Testar um webhook, ver histórico de entregas e desativar/excluir

Aprenda a enviar um evento de teste, revisar o histórico de entregas com seus payloads e desativar ou excluir um webhook no Omnifox.

Jun 26, 2026

Veja este passo no vídeo · Histórico de entregas

O que você vai fazer

Depois de criar um webhook, vale a pena testá-lo, acompanhar seu histórico de entregas e saber como desativá-lo ou excluí-lo quando não precisar mais. Tudo acontece na seção Webhooks.

Testar um webhook

Há duas formas de enviar um evento de teste:

  1. Pela lista: em Webhooks, na linha do webhook, clique no ícone Enviar evento de teste (▶). Um resultado rápido (sucesso ou erro) aparece ao lado da linha.
  2. Pelo editor: entre em Editar e vá até o cartão Entrega de teste. Clique em Enviar teste: o Omnifox envia um payload test.ping para a sua URL e mostra o status HTTP, o tempo de resposta e o corpo retornado.

O teste não afeta as métricas nem o circuit breaker, então pode usá-lo à vontade para validar o seu endpoint.

Ver o histórico de entregas

  1. Em Webhooks, clique no nome do webhook para abrir os detalhes.
  2. No topo você verá cartões de Taxa de sucesso 24h, Taxa de sucesso 7d, Tempo médio e Falhas consecutivas, além do estado do Circuit Breaker.
  3. Mais abaixo, em Histórico de entregas, há a tabela com Data, Evento, Status (Entregue / Pendente / Falhou / Abandonado), Tentativas, código HTTP e Próxima retentativa.
  4. Use os filtros de Evento, Status e intervalo de datas (De / Até) para refinar; Limpar os redefine.
  5. Clique em Ver payload em qualquer linha para abrir o modal com o payload enviado e a última resposta do seu servidor.

Desativar um webhook

Para pausar as entregas sem perder a configuração:

  • Na lista de Webhooks, desligue a chave Ativo da linha. O webhook para de enviar eventos imediatamente e você pode reativá-lo quando quiser.

Excluir um webhook

Quando não precisar mais dele:

  1. Na lista de Webhooks, clique no ícone Excluir (lixeira) da linha, ou entre em Editar e clique em Excluir webhook.
  2. Confirme no diálogo. Esta ação não pode ser desfeita: o webhook e sua configuração são removidos.

Se não funcionar

  • O teste falha com erro de conexão: verifique se a URL está correta e acessível via HTTPS pela internet.
  • HTTP 4xx no teste: seu servidor rejeitou o payload; revise autenticação e cabeçalhos.
  • Nenhuma entrega no histórico: confirme que o webhook está Ativo e que o evento ocorreu depois de você criá-lo.

Dica: antes de excluir um webhook com falhas, tente desativá-lo e revisar o Histórico de entregas para diagnosticar; muitas vezes o problema é uma URL alterada ou um token expirado.

Artigos relacionados

Isso foi útil?

Artigos relacionados

Fale conosco no WhatsApp