EN Entrar Começar Grátis
Voltar ao blog
releaseclinovidadesprodutividade

HookScope v1.2: CLI turbinado, pausa de atualizações, replay para CLI e grupos de endpoints

HookScope ·

O HookScope acabou de receber uma das maiores atualizações desde o lançamento. A versão 1.2 traz funcionalidades que impactam diretamente o dia a dia de quem trabalha com webhooks: CLI com novos comandos de gestão, pausa de live updates, replay para o CLI e grupos de endpoints.

Vamos ao que importa!

CLI com superpoderes

O hookscope CLI ganhou novos comandos que permitem gerenciar seus endpoints, workflows e plano direto do terminal — sem abrir o navegador.

Instalação e atualização

# Primeira instalação
dotnet tool install -g HookScope.Cli

# Atualizar para a versão mais recente
dotnet tool update -g HookScope.Cli

Visão geral dos novos comandos

Ao rodar hookscope sem argumentos, o CLI agora exibe um painel estilizado com todos os comandos disponíveis:

 _   _                   _      ____
| | | |   ___     ___   | | __ / ___|    ___    ___    _ __     ___
| |_| |  / _ \   / _ \  | |/ / \___ \   / __|  / _ \  | '_ \   / _ \
|  _  | | (_) | | (_) | |   <   ___) | | (__  | (_) | | |_) | |  __/
|_| |_|  \___/   \___/  |_|\_\ |____/   \___|  \___/  | .__/   \___|
                                                       |_|

╭─Commands──────────────────────────────────────────────╮
│  login      Authenticate with your HookScope API key  │
│  logout     Remove saved credentials                  │
│  listen     Listen for webhooks and forward to a URL  │
│  endpoints  List all endpoints                        │
│  endpoint   View and manage a specific endpoint       │
│  workflows  List all workflows                        │
│  plan       View plan info and usage                  │
│  config     Show current configuration                │
╰───────────────────────────────────────────────────────╯

hookscope endpoints — visão geral em uma tabela

Liste todos os seus endpoints com status, modo de forward, contagem de requests e grupo:

hookscope endpoints
╭─Endpoints──────────────────────────────────────────────────────────────╮
│  Slug          Name            Status     Forward   Requests   Group  │
│  stripe-prod   Stripe Prod     ● Active   on        1,234      —     │
│  mp-sandbox    Mercado Pago    ● Active   proxy     342        pagto  │
│  github-ci     GitHub Actions  ● Paused   off       0          devs   │
╰────────────────────────────────────────────────────────────────────────╯

hookscope endpoint <slug> — gestão interativa

Acesse o menu interativo de um endpoint para alternar configurações sem sair do terminal:

hookscope endpoint stripe-prod

O CLI exibe os detalhes do endpoint e oferece um menu de ações:

  • Toggle forward — liga/desliga o encaminhamento automático
  • Change forward URL — altera a URL de destino
  • Toggle proxy mode — ativa/desativa o modo proxy (retorna resposta do upstream)
  • Pause / Resume — pausa ou retoma o endpoint
  • Toggle mock response — ativa/desativa a resposta mock customizada

Todas as alterações são aplicadas imediatamente via API — sem necessidade de acessar o dashboard.

hookscope workflows — listagem de workflows

hookscope workflows

Exibe seus workflows com nome, endpoint vinculado, status, contagem de execuções e última execução.

hookscope plan — seu plano e consumo

Visualize seu plano atual com barras de uso intuitivas:

hookscope plan
╭─Current Plan────╮
│  DEV             │
╰─────────────────╯

 Endpoints          2   5   ■■■■□□□□□□
 Workflows          1   2   ■■■■■□□□□□
 Daily Executions  45  1000 ■□□□□□□□□□

 Retention:           7 days
 Max Steps/Workflow:  3
 Member since:        2025-03-15

As barras mudam de cor conforme o uso: verde (ok), amarelo (atenção) e vermelho (próximo do limite).

Pausa de live updates

Até agora, a tela de detalhes do endpoint recebia webhooks em tempo real sem pausa. Em cenários de alto volume isso dificulta a análise — a lista muda antes de você conseguir clicar em um request.

Agora o dashboard tem um botão de pausa que congela a lista de requests em tela. Enquanto pausado:

  • Novos webhooks continuam sendo capturados e armazenados normalmente
  • O contador de requests pendentes aparece no botão
  • A lista visível permanece estática para você inspecionar com calma
  • Ao retomar, os requests acumulados são inseridos na lista de uma vez

A pausa é persistente durante a navegação — se você abrir o detalhe de um request e voltar, o estado de pausa e a fila acumulada são preservados. Nada se perde.

Quando usar

  • Debug de integrações com alto volume — pause, analise o request com problema, e retome
  • Demonstrações — congele a tela enquanto explica o payload para o time
  • Testes de carga — pause antes de disparar os requests e observe-os chegando ao retomar

Replay para o CLI

O replay de webhooks já existia no dashboard — clicar em “Replay” re-envia o request para a URL de forward configurada. Mas e se você quer re-enviar o request para o seu localhost via CLI?

Agora o painel de detalhes do request tem um botão CLI Replay que envia o webhook diretamente para a sessão do CLI que estiver ouvindo aquele endpoint.

Como funciona

  1. No terminal, inicie o listener:
hookscope listen meu-endpoint --to http://localhost:3000/webhook
  1. No dashboard, abra qualquer request do histórico
  2. Clique em CLI Replay
  3. O request é enviado via WebSocket para o seu CLI, que o encaminha para o localhost

O fluxo completo acontece em milissegundos. É como se o webhook tivesse acabado de chegar — mesmo que tenha sido recebido horas ou dias atrás.

Cenários práticos

  • Você corrigiu um bug e quer re-testar com o mesmo payload que causou o erro
  • Precisa reproduzir um cenário específico sem pedir para o serviço externo re-enviar
  • Está desenvolvendo offline e quer testar com payloads reais capturados anteriormente

Grupos de endpoints

Conforme o número de endpoints cresce, encontrar o que você precisa fica cada vez mais difícil. Grupos resolvem isso.

Agora você pode organizar endpoints em grupos nomeados para separar por projeto, equipe, ambiente ou qualquer critério que faça sentido.

Na prática

No dashboard, os endpoints agrupados aparecem sob headers colapsáveis. Endpoints sem grupo continuam listados normalmente. No CLI, a coluna Group aparece na listagem:

hookscope endpoints
╭─Endpoints────────────────────────────────────────────────────────╮
│  Slug          Name           Status     Forward   Requests  Group  │
│  stripe-prod   Stripe Live    ● Active   on        1,234     pagto  │
│  mp-sandbox    Mercado Pago   ● Active   proxy     342       pagto  │
│  github-ci     CI Hooks       ● Active   off       89        devs   │
│  test-local    Testes         ● Active   off       12        —      │
╰──────────────────────────────────────────────────────────────────╯

Exemplos de organização

GrupoEndpoints
pagamentosStripe, Mercado Pago, PagSeguro
ci-cdGitHub Actions, GitLab CI
comunicaçãoTwilio, SendGrid
devEndpoints de teste e sandbox

Tudo junto

Essas funcionalidades foram pensadas para se complementar. Um fluxo típico agora pode ser:

# Veja seus endpoints organizados por grupo
hookscope endpoints

# Comece a ouvir o endpoint de pagamentos
hookscope listen stripe-prod --to http://localhost:5000/api/billing/webhook

# No dashboard: pause os live updates, analise um webhook problemático,
# clique em CLI Replay para re-enviar direto para o seu localhost

# Gerencie o endpoint sem sair do terminal
hookscope endpoint stripe-prod

# Confira seu plano e limites
hookscope plan

Atualize agora

# CLI
dotnet tool update -g HookScope.Cli

# Dashboard — sem ação necessária, já está atualizado

As novas funcionalidades do dashboard (pausa, replay para CLI e grupos) estão disponíveis para todos os planos, incluindo o Free. Os novos comandos do CLI também funcionam em todos os planos.

Crie sua conta gratuita em hookscope.app e comece a capturar webhooks em minutos.

Pronto para testar seus webhooks?

Crie sua conta gratuita e comece a capturar webhooks em segundos.

Começar Grátis