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.
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:
- 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.
- Pelo editor: entre em Editar e vá até o cartão Entrega de teste. Clique em Enviar teste: o Omnifox envia um payload
test.pingpara 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
- Em Webhooks, clique no nome do webhook para abrir os detalhes.
- 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.
- 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.
- Use os filtros de Evento, Status e intervalo de datas (De / Até) para refinar; Limpar os redefine.
- 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:
- Na lista de Webhooks, clique no ícone Excluir (lixeira) da linha, ou entre em Editar e clique em Excluir webhook.
- 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
Artigos relacionados
-
Como conectar integrações e apps externos
Conecte o Omnifox às suas ferramentas favoritas a partir do catálogo de integrações em poucos passos.
-
Integrar o Omnifox com Azur, Siigo, Alegra, QuickBooks ou outro sistema contábil ou ERP
O Omnifox não tem hoje um conector nativo com sistemas contábeis ou ERP. Veja como fazer essa conexão mesmo assim com fluxos de trabalho, o nó HTTP, n8n, Make, Zapier ou a API, com exemplos.
-
Guia completo de integrações e API
Integrações e API a fundo, em 30 capítulos: chaves de API, chamadas reais, webhooks assinados, n8n, MCP e SDKs, tudo funcionando de verdade.
-
Gerar e usar API keys e webhooks
Crie chaves de API para acessar o Omnifox por código e configure webhooks para receber eventos em tempo real.
-
Introdução às integrações (webhook / OAuth / chave de API)
Conecte o Omnifox às suas outras ferramentas: o que está disponível hoje, o que chega em breve e quando usar um webhook, uma conexão OAuth ou uma chave de API.