Voltar ao blog

ngrok vs HookScope: qual a melhor ferramenta para testar webhooks?

Se você trabalha com webhooks, já deve ter enfrentado o problema clássico: seu servidor roda no localhost, mas o serviço externo (Stripe, GitHub, Mercado Pago) precisa de uma URL pública para enviar notificações.

Existem várias ferramentas que resolvem isso. Neste artigo, fazemos um comparativo completo entre as principais: ngrok, RequestBin, webhook.site e HookScope.

O problema: testar webhooks em desenvolvimento

Durante o desenvolvimento, você precisa de uma forma de receber webhooks no seu ambiente local. Os desafios são:

  1. Localhost não é acessível pela internet
  2. URLs temporárias precisam ser reconfiguradas a cada sessão
  3. Sem replay — se o webhook chegou e seu código tinha bug, precisa re-disparar o evento
  4. Sem histórico — difícil debugar problemas de dias atrás

Cada ferramenta aborda esses problemas de forma diferente.

ngrok

O ngrok é a ferramenta mais conhecida para criar tunnels HTTP. Ele expõe seu localhost na internet via URL pública temporária.

Como funciona

ngrok http 3000
# Gera algo como: https://abc123.ngrok-free.app

Prós

  • Setup rápido — instala e roda em segundos
  • Funciona com qualquer stack (Node, Python, .NET, etc.)
  • Dashboard web para inspecionar requests
  • Suporte a TCP e TLS tunnels
  • Muito popular, grande comunidade

Contras

  • URLs temporárias no plano free — muda a cada reinício
  • Sem replay de webhooks — se perdeu, perdeu
  • Limite de rate no plano gratuito (20 conexões/minuto)
  • Requer instalação de CLI no sistema
  • Precisa reconfigurar o endpoint no serviço externo toda sessão
  • Planos pagos são caros (a partir de US$ 8/mês)

Ideal para

Testes rápidos e pontuais, quando você precisa expor o localhost para um teste isolado.


RequestBin

O RequestBin (agora parte do Pipedream) captura e exibe webhooks recebidos em uma interface web.

Como funciona

  1. Crie um “bin” no site
  2. Receba uma URL temporária
  3. Aponte o webhook para a URL
  4. Veja os requests no navegador

Prós

  • Sem instalação — funciona no navegador
  • Interface simples e visual
  • Mostra headers, body e metadata
  • Gratuito para uso básico

Contras

  • Sem forward para localhost — só captura, não encaminha
  • URLs expiram rapidamente
  • Sem replay de webhooks
  • Integração com Pipedream pode ser confusa
  • Não é ideal para desenvolvimento contínuo

Ideal para

Inspeção rápida de payloads — quando você só quer ver o que o serviço está enviando.


webhook.site

O webhook.site é similar ao RequestBin, com interface mais rica.

Como funciona

Acesse o site e receba uma URL automática. Webhooks enviados para essa URL são exibidos em tempo real.

Prós

  • Zero setup — abre o site e já funciona
  • Interface bonita com JSON formatado
  • Suporte a Custom Actions (respostas customizadas)
  • Mostra headers e body detalhados

Contras

  • Sem forward para localhost no plano free
  • URLs temporárias — expiram após tempo
  • Sem replay automático
  • Limites rígidos no plano gratuito
  • Plano Pro caro para funcionalidades básicas

Ideal para

Debug pontual e inspeção de payloads, similar ao RequestBin mas com interface mais completa.


HookScope

O HookScope foi projetado especificamente para o workflow de desenvolvimento com webhooks — não apenas captura, mas gerenciamento completo.

Como funciona

  1. Crie um endpoint com URL permanente
  2. Aponte o webhook do serviço externo
  3. Visualize em tempo real no dashboard
  4. Forward automático para seu localhost (via dashboard ou CLI)
  5. Replay qualquer webhook com 1 clique

HookScope CLI

Além do dashboard web, o HookScope oferece um CLI para debug local:

# Instale o CLI
dotnet tool install -g HookScope.Cli

# Autentique
hookscope login --api-key SUA_CHAVE

# Escute webhooks e encaminhe para localhost
hookscope listen meu-endpoint --to http://localhost:3000

O CLI conecta via SignalR ao HookScope e encaminha cada webhook capturado na nuvem para o seu servidor local em tempo real — preservando método, headers e body. Diferente do ngrok, a URL pública do endpoint nunca muda.

Prós

  • URL permanente — configure uma vez, nunca mais mude
  • Real-time via WebSocket — veja webhooks chegando instantaneamente
  • Replay com 1 clique — re-envie qualquer webhook capturado
  • Forward automático — encaminha para localhost ou produção
  • CLI para debug local — receba webhooks no localhost via hookscope listen, sem tunnels
  • Sem instalação obrigatória — dashboard funciona 100% no navegador, CLI é opcional
  • Histórico completo — acesse webhooks de dias/semanas atrás
  • Schema Discovery — gera types TypeScript/C# automaticamente
  • Workflows — automações e filtros condicionais
  • Plano Free gratuito para sempre (sem trial)
  • Preço acessível — a partir de R$ 19/mês

Contras

  • Não cria tunnels TCP/TLS (apenas HTTP)
  • Produto mais novo no mercado

Ideal para

Desenvolvimento contínuo com webhooks, equipes que integram com múltiplos serviços, e quem precisa de replay e histórico.


Comparativo completo

FuncionalidadengrokRequestBinwebhook.siteHookScope
URL permanentePagoNãoNãoSim (todos os planos)
Forward para localhostSimNãoPagoSim (dashboard + CLI)
Replay de webhooksNãoNãoNãoSim
Visualização real-timeDashboard básicoSimSimWebSocket real-time
HistóricoSessão atualTemporárioTemporário24h a 90 dias
Instalação necessáriaCLI obrigatóriaNãoNãoNão (CLI opcional)
CLI para debug localSim (tunnel)NãoNãoSim (via SignalR)
Schema DiscoveryNãoNãoNãoSim
Workflows/automaçõesNãoPipedreamActions básicasSim
Team/colaboraçãoNãoNãoNãoSim (Pro+)
Preço (entrada)US$ 8/mêsGrátis (limitado)US$ 9/mêsR$ 0 (Free)
Tunnel TCP/TLSSimNãoNãoNão

Quando usar cada um?

Use ngrok quando:

  • Precisa de tunnel TCP/TLS (não só HTTP)
  • Quer expor qualquer porta do localhost rapidamente
  • Já tem setup configurado e não quer mudar

Use RequestBin quando:

  • Quer ver rapidamente o payload de um webhook
  • Não precisa de forward para localhost
  • É um teste único e pontual

Use webhook.site quando:

  • Precisa inspecionar webhooks com interface rica
  • Quer configurar respostas customizadas
  • Não precisa de forward ou replay

Use HookScope quando:

  • Trabalha com webhooks diariamente
  • Precisa de replay para debugar integrações
  • Quer uma URL permanente sem reconfigurar
  • Precisa de forward automático para localhost (via dashboard ou CLI)
  • Quer debug local via CLI sem tunnels (hookscope listen)
  • Trabalha em equipe e precisa de colaboração
  • Quer gerar types/DTOs a partir dos payloads recebidos
  • Procura uma ferramenta brasileira com preço em R$

Migrar de ngrok para HookScope

Se você já usa ngrok e quer testar o HookScope:

  1. Crie uma conta gratuita (sem cartão de crédito)
  2. Crie um endpoint e copie a URL
  3. Substitua a URL do ngrok no serviço externo (Stripe, GitHub, etc.)
  4. Configure o forward via dashboard ou use o CLI:
dotnet tool install -g HookScope.Cli
hookscope login
hookscope listen meu-endpoint --to http://localhost:3000

A URL nunca muda, então você não precisa reconfigurar quando reiniciar o ambiente de desenvolvimento.

Conclusão

Cada ferramenta tem seu nicho. Para testes pontuais e rápidos, ngrok e webhook.site funcionam bem. Para desenvolvimento contínuo com webhooks, onde você precisa de replay, histórico e forward automático, o HookScope foi projetado exatamente para isso.

Teste o HookScope gratuitamente e veja a diferença no seu workflow de desenvolvimento.