Quem trabalha com integrações via webhook conhece a dor: você configura o endpoint, aponta o provedor, espera o evento acontecer… e nada aparece. Ou pior — o webhook chega, mas seu código falha silenciosamente e você não tem como saber o que veio no payload. É o famoso debug às cegas.
O HookScope nasceu para resolver exatamente isso. É uma ferramenta desenvolvida pela DevPlus para captura, inspeção, replay e encaminhamento de webhooks — tudo em tempo real, com interface visual e sem depender de tunnels temporários.
O problema que o HookScope resolve
Depurar integrações com webhooks envolve uma série de desafios que ferramentas tradicionais não resolvem bem:
- ngrok cria tunnels temporários que expiram e precisam ser reconfigurados a cada sessão de desenvolvimento
- RequestBin e webhook.site capturam requests, mas não oferecem replay, forward automático ou histórico robusto
- cURL manual exige que você saiba exatamente o formato do payload — e nem sempre a documentação do provedor é completa
O HookScope combina as funcionalidades que estavam espalhadas em várias ferramentas e adiciona recursos que nenhuma delas oferece individualmente.
Como funciona
O fluxo é simples:
- Crie um endpoint no HookScope — você recebe uma URL permanente
- Aponte o webhook do provedor (Stripe, GitHub, Mercado Pago, etc.) para essa URL
- Veja em tempo real cada request chegando, com headers, body e metadados
- Reenvie, encaminhe ou processe conforme necessário
┌──────────────┐ ┌──────────────┐ ┌──────────────────┐
│ Provedor │ POST │ HookScope │ Forward │ Sua Aplicação │
│ (webhook) │ ──────> │ (captura + │ ──────> │ (local ou │
│ │ │ inspeção) │ │ produção) │
└──────────────┘ └──────────────┘ └──────────────────┘A URL do endpoint nunca muda. Você configura uma vez no painel do provedor e não precisa mexer mais — diferente de ngrok, onde cada sessão gera uma URL nova.
Funcionalidades principais
URL permanente por endpoint
Cada endpoint que você cria no HookScope recebe uma URL estável que não expira. Isso significa que a configuração do webhook no provedor é feita uma única vez. Se você reiniciar sua máquina, trocar de rede ou voltar ao projeto depois de semanas, a URL continua funcionando.
Visualização em tempo real
Assim que um webhook chega, ele aparece instantaneamente na interface via WebSocket. Você vê:
- Método HTTP (POST, PUT, etc.)
- Headers completos — Content-Type, User-Agent, assinaturas
- Body formatado — JSON com syntax highlighting
- Query parameters
- IP de origem e timestamp
Sem refresh manual, sem polling — o request aparece na tela no momento em que chega.
Replay com 1 clique
Essa é talvez a funcionalidade mais valiosa. Se um webhook chegou e seu código tinha um bug, você não precisa esperar o provedor reenviar o evento. Basta clicar em “Replay” e o HookScope reenvia exatamente o mesmo request para o destino configurado.
Isso elimina o ciclo frustrante de:
- Alterar o código
- Esperar o provedor enviar outro webhook
- Descobrir que ainda tem bug
- Repetir
Com replay, o ciclo vira:
- Alterar o código
- Clicar em Replay
- Ver o resultado imediatamente
Forward automático com retry
Você pode configurar o HookScope para encaminhar automaticamente cada webhook recebido para um destino — seja seu localhost:5000, um servidor de staging ou produção. Se o destino estiver offline, o sistema faz retry automático com backoff e loga cada tentativa.
Proxy mode
No modo proxy, o HookScope encaminha o webhook para seu servidor e retorna a resposta do seu servidor ao provedor original. Isso é útil para provedores que esperam uma resposta específica (ex: Stripe espera 200 para confirmar recebimento).
Mock response
Se você ainda não tem o backend pronto, pode configurar uma resposta customizada para cada endpoint. O provedor recebe a resposta configurada, e você ganha tempo para implementar a lógica real.
CLI para debug local
A CLI do HookScope permite receber webhooks da nuvem diretamente no seu localhost — sem ngrok, sem expor portas, sem tunnels:
# Instalar a CLI
npm install -g @hookscope/cli
# Conectar e encaminhar para localhost
hookscope forward --endpoint meu-endpoint --to http://localhost:5000/webhookA conexão é feita via WebSocket seguro, então funciona atrás de firewalls e NATs sem configuração adicional.
Schema discovery
Conforme webhooks chegam, o HookScope analisa os payloads e descobre automaticamente o schema dos dados. Ele gera tipos e DTOs que você pode copiar diretamente para seu código — útil quando a documentação do provedor é vaga ou desatualizada.
Workflows de automação
Para cenários mais avançados, você pode criar workflows com steps encadeados:
- Filter — processe apenas webhooks que atendam critérios específicos
- Transform — modifique o payload antes de encaminhar
- HTTP Forward — envie para múltiplos destinos
- Delay — adicione atrasos entre steps
Casos de uso reais
Integrações de pagamento
Gateways como Stripe, PagSeguro, Mercado Pago e Asaas enviam webhooks para notificar sobre mudanças de status de pagamento. Com o HookScope, você vê exatamente o que o gateway envia, testa diferentes cenários (aprovado, recusado, estornado) via replay e garante que seu handler processa corretamente cada caso.
Pipelines de CI/CD
GitHub, GitLab e Bitbucket enviam webhooks em eventos como push, pull request e deploy. O HookScope permite inspecionar o payload completo e testar seu handler de CI/CD sem precisar criar commits falsos.
Notificações de terceiros
Serviços como Twilio (SMS), SendGrid (email), Slack e Discord usam webhooks para notificações. Depurar esses fluxos fica trivial quando você vê o request exato que chega.
Desenvolvimento de APIs
Se você está construindo uma API que envia webhooks, o HookScope funciona como receptor de teste. Aponte seus webhooks para um endpoint do HookScope e valide que o formato, headers e timing estão corretos antes de liberar para clientes.
Planos e preços
O HookScope opera em modelo freemium:
| Plano | Preço | Ideal para |
|---|---|---|
| Free | R$ 0/mês | Experimentação e projetos pessoais |
| Dev | R$ 19/mês | Desenvolvedores individuais |
| Pro | R$ 49/mês | Times e projetos profissionais |
| Business | R$ 99/mês | Empresas e operação em produção |
O plano Free é para sempre — sem trial com expiração, sem cartão de crédito. Você pode começar a usar e escalar conforme a necessidade.
HookScope vs. alternativas
| Recurso | HookScope | ngrok | RequestBin | webhook.site |
|---|---|---|---|---|
| URL permanente | ✅ | ❌ (expira) | ✅ | ✅ |
| Replay nativo | ✅ | ❌ | ❌ | ❌ |
| Forward com retry | ✅ | ✅ (básico) | ❌ | ❌ |
| Mock response | ✅ | ❌ | ❌ | ✅ (limitado) |
| Schema discovery | ✅ | ❌ | ❌ | ❌ |
| Workflows | ✅ | ❌ | ❌ | ❌ |
| CLI para localhost | ✅ | ✅ | ❌ | ❌ |
| Infraestrutura BR | ✅ | ❌ | ❌ | ❌ |
Começando em 30 segundos
- Acesse hookscope.com.br e crie uma conta gratuita
- Crie seu primeiro endpoint
- Copie a URL gerada e configure no provedor de webhook
- Veja os requests chegando em tempo real
Sem instalação, sem configuração de infra, sem complicação.
Conclusão
O HookScope é a ferramenta que gostaríamos de ter quando começamos a trabalhar com integrações de webhook na DevPlus. Ele transforma um processo que era feito com console.log, cURL e muita paciência em um fluxo visual, previsível e produtivo.
Se você trabalha com integrações — seja pagamentos, notificações, CI/CD ou qualquer sistema que use webhooks — vale experimentar. O plano Free é gratuito para sempre e já cobre os casos de uso mais comuns.
Confira também nosso artigo sobre o que são webhooks e como depurar integrações para entender os fundamentos e boas práticas de implementação.