webhooks.cc

Teste de webhooks para agentes de codificação: crie endpoints, envie webhooks de teste assinados, inspecione requisições capturadas, compare tentativas e verifique assinaturas.

GitHub
2
Experimente este MCPPatrocinado

Documentação

webhooks.cc

Inspecione e depure webhooks sem precisar fazer deploy em produção.

Obtenha uma URL exclusiva, aponte seu webhook para ela e veja cada requisição em tempo real. Sem necessidade de cadastro.

Experimente agora →

Começando

  1. Visite webhooks.cc
  2. Copie sua URL de webhook exclusiva
  3. Envie uma requisição de teste: curl -X POST https://go.webhooks.cc/w/<slug> -d '{"test": true}'
  4. Veja-a aparecer no painel

Recursos

  • Capturar requisições — Armazene webhooks recebidos com cabeçalhos, corpo, parâmetros de consulta e metadados
  • Inspecionar em tempo real — Veja as requisições no momento em que chegam via WebSocket
  • Configurar respostas — Retorne códigos de status, cabeçalhos e corpo personalizados para testar caminhos de erro
  • Encaminhar para localhost — Faça túnel de webhooks para seu servidor local durante o desenvolvimento
  • CLI com TUI interativo — Gerencie endpoints, túneis e transmita requisições a partir do seu terminal
  • SDK TypeScript — Acesse dados de webhook programaticamente para automação e testes
  • Servidor MCP — Conecte agentes de codificação de IA (Claude Code, Cursor, VS Code, Codex) aos seus webhooks

Casos de Uso

Testando integrações de pagamento — Aponte os webhooks de teste do Stripe para seu endpoint. Inspecione a estrutura do payload antes de escrever handlers.

Depurando hooks de CI/CD — Veja exatamente o que o GitHub envia quando ocorre um push, PR ou deploy.

Desenvolvendo localmente — Encaminhe webhooks semelhantes aos de produção para localhost sem expor sua máquina à internet.

Simulando cenários de falha — Configure seu endpoint para retornar erros 500 e teste sua lógica de nova tentativa.

Preços

Grátis — 50 requisições/dia, retenção de dados por 7 dias. Suficiente para desenvolvimento e testes.

Pro ($8/mês) — 100.000 requisições/mês, retenção por 30 dias. Para monitoramento em produção e testes de alto volume.

Consulte webhooks.cc para detalhes.

Instalação

CLI

curl -fsSL https://webhooks.cc/install.sh | sh

Em seguida, inicie o terminal interativo:

whk

SDK

npm install @webhooks-cc/sdk

Servidor MCP

# Claude Code
claude mcp add -s user webhooks-cc -e WHK_API_KEY=whcc_... -- npx -y @webhooks-cc/mcp

# Cursor, VS Code, Windsurf, Claude Desktop
npx @webhooks-cc/mcp setup cursor --api-key whcc_...

Consulte webhooks.cc/installation para todos os métodos de instalação, botões de um clique e guias de configuração.

CLI

Execute whk para iniciar o TUI interativo:

$ whk

  webhooks.cc

  ● Logged in as you@example.com

  ▸ Tunnel    Forward webhooks to localhost
    Listen    Stream incoming requests
    Create    Create a new endpoint
    Endpoints Manage your endpoints
    Auth      Login / logout
    Update    Check for updates

Todos os comandos também funcionam diretamente pela linha de comando:

whk tunnel 8080                       # Forward webhooks to localhost:8080
whk listen <slug>                     # Stream incoming requests
whk create my-endpoint                # Create a new endpoint
whk list                              # List your endpoints
whk replay <request-id> --to :3000    # Replay a captured request

Passe --nogui ou defina WHK_NOGUI=1 para pular o TUI e imprimir a ajuda.

SDK

import { WebhooksCC, matchMethod, matchHeader, matchAll } from "@webhooks-cc/sdk";

const client = new WebhooksCC({ apiKey: "whcc_..." });

const endpoint = await client.endpoints.create({ name: "my-webhook" });
console.log(endpoint.url);

// Wait for a matching request with human-readable timeout
const req = await client.requests.waitFor(endpoint.slug, {
  timeout: "30s",
  match: matchAll(matchMethod("POST"), matchHeader("stripe-signature")),
});

// Replay captured requests to your local server
await client.requests.replay(req.id, "http://localhost:3000/webhooks");

Servidor MCP

O pacote @webhooks-cc/mcp expõe 11 ferramentas que permitem que agentes de IA gerenciem endpoints, inspecionem webhooks, enviem payloads de teste e reproduzam requisições por meio de linguagem natural.

You: "Create a webhook endpoint for testing Stripe"
Agent: Created endpoint "stripe-test" at https://go.webhooks.cc/w/abc123

You: "Send a test checkout.session.completed event"
Agent: Sent POST to stripe-test

You: "Replay that to my local server"
Agent: Replayed to http://localhost:3000/webhooks — 200 OK

Consulte packages/mcp/README.md para referência completa de configuração e ferramentas.

Código Aberto

O código-fonte está disponível para transparência e contribuições da comunidade, não como um guia de implantação. Para contribuir, consulte CONTRIBUTING.md.

Para ambientes de conformidade ou isolados, o código está aqui. Para a maioria dos casos de uso, o serviço hospedado em webhooks.cc é o caminho mais fácil.

Licença

Este projeto usa uma licença dividida:

  • AGPL-3.0: o aplicativo web, receptor, host SMTP de captura de e-mail e backend Supabase (apps/web/, apps/receiver-rs/, apps/mx-rs/, supabase/). Consulte LICENSE.
  • MIT: o CLI, SDK e servidor MCP (apps/cli-rs/, packages/sdk/, packages/mcp/). Consulte seus respectivos arquivos LICENSE.

Se você usar o CLI, SDK ou servidor MCP em seus próprios projetos, a licença MIT se aplica. Se você fizer um fork e hospedar o serviço, a AGPL-3.0 se aplica.