Desenvolvedores

Como receber webhooks em ambiente local com SSL gratuito

Exponha seu localhost:3000 na internet com HTTPS válido e receba callbacks do Stripe, Mercado Pago ou WhatsApp sem complicações.

Todo desenvolvedor já enfrentou o desafio de testar uma integração de pagamento ou um bot do WhatsApp: o serviço externo exige uma URL pública com HTTPS para disparar as notificações de webhook, mas a sua aplicação está rodando na sua máquina em localhost:3000 ou 127.0.0.1:8000.

Os 3 modos de expor suas APIs com a NatBridge

1. Domínio Personalizado ou Subdomínio com SSL (Recomendado para Webhooks)

A maioria dos gateways de pagamento (Stripe, PagSeguro, Mercado Pago) rejeita conexões HTTP puras. Com a NatBridge, você ganha um subdomínio com certificado SSL automático (ex: webhook-dev.natbridge.io) ou conecta o seu próprio domínio através de integração com Cloudflare.

2. Port Forwarding TCP Bruto (Rápido e Direto)

Se você está testando conexões TCP diretas, microserviços internos ou brokers MQTT/Redis que não utilizam HTTPS, pode simplesmente redirecionar a porta interna para uma porta pública.

3. Rede Mesh Privada (Interligação Local sem Exposição Pública)

Para cenários onde sua API local precisa conversar com um servidor em nuvem ou com outro desenvolvedor da equipe sem abrir nenhum acesso ao público geral da internet.

Passo a Passo: Criando o Túnel Webhook com HTTPS

PASSO 1

Inicie o seu serviço localmente

Certifique-se de que sua API Node, Python, Go ou PHP está rodando na porta desejada (ex: localhost:3000).

PASSO 2

Conecte o seu Peer

Com o cliente ativo no seu computador de desenvolvimento, o túnel criptografado é estabelecido imediatamente.

PASSO 3

Vá em "Domínios & Túneis"

No painel da NatBridge, clique em Adicionar Novo Domínio e informe:

Nome do Domínio: Escolha seu subdomínio na plataforma (ex: meu-webhook.natbridge.io) ou aponte seu próprio domínio.
Porta Local de Destino: A porta interna da sua aplicação (ex: 3000).
Protocolo: HTTP/HTTPS.

PASSO 4

Configure a URL no Painel do Provedor

Copie a URL segura gerada (https://meu-webhook.natbridge.io/api/stripe/webhook) e cole diretamente no painel do Stripe, Mercado Pago ou serviço de terceiros. As requisições cairão no terminal da sua máquina em tempo real!

⚡ Sem quedas de sessão: Diferente de ferramentas gratuitas com túneis temporários que mudam de URL toda vez que você reinicia o terminal, na NatBridge o seu subdomínio permanece fixo.

Quer acesso antecipado para desenvolvedores?

Estamos liberando contas para devs testarem a integração com webhooks e domínios.