Voltar ao início

Guias de webhooks

Guias sobre túnel para localhost, depuração local de webhooks, alternativas ao ngrok e túneis HTTPS seguros para times de desenvolvimento modernos.

Uma requisição webhook bloqueada por uma porta trancada com 401 e 403, com uma chave para abri-la.

Por que seu webhook devolve 401 ou 403 (e como corrigir)

Erros 401 e 403 de webhook quase sempre são uma de cinco coisas. Um passo a passo de diagnóstico que aponta qual antes de você perder uma tarde.

2026-06-15T13:41:56.000ZPortPreview Team
webhook debuggingHTTP errorsauthenticationtroubleshooting
Uma requisição de webhook armazenada sendo reproduzida em um handler local a partir de uma linha do tempo de requisições.

Replay de webhook: depurar sem disparar de novo

O replay de webhook reenvia callbacks capturados ao seu handler local sem disparar eventos upstream de novo. Depure mais rápido com histórico e replay em um clique.

2026-06-15T13:41:56.000ZPortPreview Team
webhook debuggingreplaytestingcallbacks
Requisições de webhook duplicadas sendo deduplicadas por um filtro de chave de idempotência em um único evento.

Retries e idempotência de webhooks sem lágrimas

Provedores de webhook entregam o mesmo evento duas vezes. Trate isso como feature, não bug. Padrões práticos para handlers idempotentes, chaves de dedup e código seguro a replay.

2026-06-15T13:41:56.000ZPortPreview Team
webhook designidempotencyretriesdistributed systems
Uma requisição de webhook assinada sendo verificada contra uma chave em um portão de verificação de assinatura.

Verificação de assinatura de webhook, sem mistério

A maioria das falhas de assinatura não são bugs de cripto, são bugs de parse. Correções reais para HMAC, comparação timing-safe, ataques de replay e corpo cru.

2026-06-15T13:41:56.000ZPortPreview Team
webhook securityHMACsignature verificationbest practices
Uma requisição de webhook fluindo de serviços na nuvem para um notebook que mostra um painel inspetor de requisições.

Depurar webhooks em local: guia completo

Aprenda a depurar webhooks em local com uma URL de túnel segura. Teste callbacks do Stripe, GitHub e Twilio, inspecione payloads e reenvie requisições em segundos.

2026-06-04T11:42:00.000ZPortPreview Team
webhook debuggingStripeGitHublocal testing