# Depurador e relay de webhook

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

> Página canônica: https://elysiatools.com/pt/tools/webhook-debugger-relay

- **Categoria:** Network

- **Palavras-chave:** webhook, debugger, relay, request bin, hmac, replay

## 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.

## Entradas

- **URL de destino do replay** (text): https://api.example.com/webhooks/real-endpoint
- **Segredo de assinatura** (text): whsec_test_123
- **Cabecalho de assinatura** (text)
- **Reenviar automaticamente requisicoes compativeis** (checkbox)
- **Filtro de metodo** (select)
- **O body deve conter** (text): "event":"invoice.paid"
- **Limite de requisicoes armazenadas** (number)

## 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.

## Perguntas frequentes

### 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.

## Ferramentas relacionadas

- [Sincronizador de paleta Tailwind](https://elysiatools.com/pt/tools/tailwind-color-palette-sync): Insira HEX, escolha o esquema de nomes (escala 50–950 / nome único / aninhamento) e gere o fragmento theme.extend.colors do tailwind.config.ts com níveis WCAG AA/AAA. Dark mode opcional.
- [Gerador de ideias de domínio com IA](https://elysiatools.com/pt/tools/ai-domain-name-idea-generator): Insira palavras-chave da marca e a IA gera até 10 ideias de domínio, filtrando as já registradas via DNS + RDAP. Para empreendedores e desenvolvedores.
- [Gerador e Analisador de JWK](https://elysiatools.com/pt/tools/jwk-generator): Gera JSON Web Keys (JWK) para RSA, EC (P-256/P-384/P-521/secp256k1) e OKP (Ed25519/Ed448/X25519/X448), ou analisa um JWK existente para inspecionar parâmetros, impressão e metadados
- [Gerador de PKCE Code Verifier e Challenge](https://elysiatools.com/pt/tools/pkce-code-verifier-generator): Gera, valida e verifica pares code_verifier / code_challenge PKCE (RFC 7636) de OAuth2 / OIDC. Três modos: (1) gerar um par novo a partir de bytes aleatórios criptográficos (256/384/512/768 bits), (2) auditar um verifier existente frente ao RFC — comprimento (43–128), charset \[A-Za-z0-9-._~\] e ≥256 bits de entropia, e (3) verificar um par recalculando BASE64URL(SHA256(verifier)). Opcionalmente constrói a URL completa de autorização e o corpo de troca de token. Complementa o nonce-generator genérico (que só emite o par) com auditoria de conformidade RFC e verificação de pares.
- [Gerador de frases mnemônicas BIP39](https://elysiatools.com/pt/tools/mnemonic-bip39-generator): Gera ou valida frases BIP39 de 12 a 24 palavras com saída de entropia e seed PBKDF2-HMAC-SHA512
- [Verificador de Pangrama](https://elysiatools.com/pt/tools/pangram-checker): Verifica se o texto é um pangrama (contém cada letra do alfabeto). Relata letras faltantes, usadas e a contagem de letras únicas.
- [Tutor de Análise Dimensional e Cancelamento de Unidades](https://elysiatools.com/pt/tools/dimensional-analysis-unit-cancellation-tutor): Decompõe conversões em cancelamento factor-label passo a passo: mostra numerador/denominador, detecta fatores invertidos e dá feedback didático para inconsistências dimensionais e respostas numéricas erradas.
- [Gerador de Diagrama de Euler](https://elysiatools.com/pt/tools/euler-diagram-generator): Gerar diagramas de Euler personalizáveis para visualizar relacionamentos de conjuntos, inclusões e estruturas hierárquicas

## Exemplos

- [Exemplos de Processamento de Imagem Web Python](https://elysiatools.com/pt/samples/web-image-processing-python): Exemplos de processamento de imagem Web Python usando PIL/Pillow incluindo leitura, salvamento, redimensionamento e conversão de formato
- [Exemplos de Processamento de Imagem Android Java](https://elysiatools.com/pt/samples/android-image-processing-java): Exemplos de processamento de imagem Android Java incluindo leitura/escrita, dimensionamento e conversão de formato
- [Exemplos de Processamento de Imagem Android Kotlin](https://elysiatools.com/pt/samples/android-image-processing-kotlin): Exemplos de processamento de imagem Android Kotlin incluindo leitura/escrita, dimensionamento e conversão de formato
- [Exemplos de Processamento de Imagem Web Rust](https://elysiatools.com/pt/samples/web-image-processing-rust): Exemplos de processamento de imagem Web Rust incluindo leitura/gravação, redimensionamento e conversão de formato

## Conteúdo relacionado

- [Ferramentas de conversao de enderecos de rede e inspecao de trafego](https://elysiatools.com/pt/hubs/network-convert): Ferramentas reunidas para conversao de enderecos de rede, inspecao de pacotes e depuracao de requisicoes em um unico hub.
- [Ferramentas de Triage de Rede, Inspecao de Pacotes e Depuracao de Endpoints](https://elysiatools.com/pt/hubs/network-triage-debugging): Inspecione capturas de rede, depure webhooks, verifique endpoints DNS e SSL, valide enderecos e analise user agents em um unico hub.
- [Ferramentas de observabilidade, analise de logs e depuracao de traces](https://elysiatools.com/pt/hubs/observability-debugging): Analise logs, inspecione traces, compare deriva de payloads de API e transforme dados brutos de observabilidade em linhas do tempo, diagramas e evidencias estruturadas para depurar mais rapido.
- [Ferramentas de geracao de chaves, assinaturas e verificacao de confianca](https://elysiatools.com/pt/hubs/key-generation-signature-verification): Este hub reune geracao de chaves, analise de assinaturas JWT e AGEX, verificacao de certificados PDF e TLS e comparacao de hashes em um fluxo focado em confianca.
