Categorias

Depurador e relay de webhook

Gera uma URL unica de captura de webhook, inspeciona requisicoes, valida assinaturas e reenvia payloads para um endpoint alvo

Exemplos de resultados

2 Exemplos

Capturar webhooks do Stripe antes do relay

Cria uma URL unica, valida a assinatura e permite reenviar eventos selecionados

Webhook dashboard with a unique capture URL, signature validation, and replay controls.
Ver parâmetros de entrada
{ "relayTargetUrl": "https://api.example.com/webhooks/stripe", "signatureSecret": "whsec_test_123", "signatureHeader": "stripe-signature", "autoReplay": false, "methodFilter": "POST", "bodyMustContain": "\"type\":\"invoice.paid\"", "storedRequestLimit": 50 }

Depurar payloads do GitHub com relay condicional

Reencaminha apenas eventos push compativeis e mantem um log completo

Webhook dashboard configured for conditional relay, replay, and export.
Ver parâmetros de entrada
{ "relayTargetUrl": "https://api.example.com/webhooks/github", "signatureSecret": "github_secret_value", "signatureHeader": "x-hub-signature-256", "autoReplay": true, "methodFilter": "POST", "bodyMustContain": "\"ref\":\"refs/heads/main\"", "storedRequestLimit": 100 }

Fatos principais

Categoria
Network
Tipos de entrada
text, checkbox, select, number
Tipo de saída
html
Cobertura de amostras
4
API disponível
Yes

Visão geral

O Depurador e Relay de Webhook é uma ferramenta essencial para desenvolvedores que precisam inspecionar, validar e reencaminhar requisições HTTP em tempo real. Ao gerar uma URL única de captura, você pode receber payloads de serviços externos, verificar assinaturas de segurança (HMAC) e configurar o reenvio automático ou manual para o seu ambiente de desenvolvimento local ou servidor de produção.

Quando usar

  • Quando você precisa testar integrações de APIs de terceiros (como Stripe ou GitHub) antes de enviar os dados para o servidor de produção.
  • Para depurar payloads de webhooks que estão falhando devido a assinaturas inválidas ou formatos de corpo de requisição incorretos.
  • Quando é necessário criar um túnel temporário para inspecionar requisições e reencaminhar apenas os eventos que atendem a critérios específicos.

Como funciona

  • A ferramenta gera uma URL de captura exclusiva para você configurar no painel do serviço de terceiros.
  • As requisições recebidas são inspecionadas em tempo real, validando cabeçalhos de assinatura e filtrando métodos HTTP ou conteúdos específicos do corpo.
  • Os payloads capturados são armazenados temporariamente no painel, permitindo a visualização detalhada de cabeçalhos e dados.
  • Você pode configurar uma URL de destino para reenviar (relay) as requisições manualmente ou ativar o reenvio automático para eventos compatíveis.

Casos de uso

Desenvolvimento local de integrações de pagamento, capturando eventos do Stripe e reencaminhando para o localhost via túnel.
Monitoramento e auditoria de eventos de CI/CD, inspecionando payloads do GitHub Actions antes de acionar deploys em servidores internos.
Resolução de problemas em APIs de terceiros, isolando requisições malformadas e testando correções sem afetar o banco de dados principal.

Exemplos

1. Capturar e depurar webhooks do Stripe

Desenvolvedor Backend
Contexto
A equipe está implementando um novo sistema de faturamento e precisa garantir que os eventos de pagamento do Stripe estão sendo processados corretamente.
Problema
É difícil testar webhooks localmente e verificar se a assinatura do Stripe está sendo validada da forma certa antes de ir para produção.
Como usar
Gere a URL de captura, defina o cabeçalho como 'stripe-signature', insira o segredo de teste e configure o filtro para conter '"type":"invoice.paid"'.
Configuração de exemplo
{
  "relayTargetUrl": "https://api.empresa.com/webhooks/stripe",
  "signatureSecret": "whsec_test_123",
  "signatureHeader": "stripe-signature",
  "methodFilter": "POST",
  "bodyMustContain": "\"type\":\"invoice.paid\""
}
Resultado
Apenas os eventos de faturas pagas são validados e reencaminhados para a API de destino, permitindo uma depuração segura e focada.

2. Relay condicional de payloads do GitHub

Engenheiro de DevOps
Contexto
O servidor de integração contínua precisa receber notificações do GitHub apenas quando há um push na branch principal (main).
Problema
O GitHub envia webhooks para várias ações, sobrecarregando o servidor de CI com eventos irrelevantes.
Como usar
Configure a URL de destino do servidor CI, ative o reenvio automático e defina a regra para que o corpo contenha a referência da branch main.
Configuração de exemplo
{
  "relayTargetUrl": "https://ci.empresa.com/github-webhook",
  "signatureSecret": "github_secret_value",
  "signatureHeader": "x-hub-signature-256",
  "autoReplay": true,
  "bodyMustContain": "\"ref\":\"refs/heads/main\""
}
Resultado
O painel captura todos os eventos para auditoria, mas apenas os pushes na branch 'main' são reencaminhados automaticamente para o servidor de CI.

Testar com amostras

network

Hubs relacionados

FAQ

Posso validar assinaturas de webhooks com esta ferramenta?

Sim, você pode fornecer o segredo de assinatura e o nome do cabeçalho (como 'stripe-signature') para que a ferramenta valide automaticamente a autenticidade do payload.

Quantas requisições posso armazenar no histórico?

Você pode configurar o limite de armazenamento entre 10 e 200 requisições simultâneas no painel.

É possível filtrar quais eventos serão reencaminhados?

Sim, você pode usar o filtro de método HTTP (como apenas POST) e definir uma string específica que o corpo da requisição deve conter para acionar o relay.

O reenvio (relay) acontece automaticamente?

Depende da sua configuração. Você pode ativar a opção de reenvio automático para requisições compatíveis ou fazer o replay manualmente a partir do histórico.

Quais métodos HTTP são suportados para captura?

A ferramenta pode capturar qualquer método, ou você pode restringir a captura apenas para requisições POST, PUT ou PATCH através do filtro de método.

Documentação da API

Ponto final da solicitação

POST /pt/api/tools/webhook-debugger-relay

Parâmetros da solicitação

Nome do parâmetro Tipo Requerido Descrição
relayTargetUrl text Não -
signatureSecret text Não -
signatureHeader text Não -
autoReplay checkbox Não -
methodFilter select Não -
bodyMustContain text Não -
storedRequestLimit number Não -

Formato de resposta

{
  "result": "
Processed HTML content
", "error": "Error message (optional)", "message": "Notification message (optional)", "metadata": { "key": "value" } }
HTML: HTML

Documentação de MCP

Adicione este ferramenta à sua configuração de servidor MCP:

{
  "mcpServers": {
    "elysiatools-webhook-debugger-relay": {
      "name": "webhook-debugger-relay",
      "description": "Gera uma URL unica de captura de webhook, inspeciona requisicoes, valida assinaturas e reenvia payloads para um endpoint alvo",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=webhook-debugger-relay",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

Você pode encadear várias ferramentas, ex: `https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`, máx 20 ferramentas.

Se você encontrar algum problema, por favor, entre em contato conosco em [email protected]