Testando URLs de Callback do Cams Localmente com ngrok
Antes de colocar sua integração em produção, você pode testar os callbacks da Cams API diretamente na sua máquina de desenvolvimento usando uma ferramenta de túnel. Este guia apresenta a configuração passo a passo.
Por que você precisa de um túnel
As requisições de callback e webhook são originadas da plataforma Cams pela internet. Uma aplicação local em execução na sua máquina não consegue receber essas requisições diretamente, pois ela está atrás de um firewall ou de uma rede NAT.
Um serviço de túnel cria um endpoint público seguro que encaminha as requisições recebidas para a sua aplicação local.
Benefícios
- Testar callbacks antes da implantação
- Depurar payloads de webhook em tempo real
- Validar o tratamento de requisições localmente
- Reduzir o tempo de desenvolvimento e implantação
Ferramentas de túnel recomendadas

Configurando o ngrok (recomendado)
Instalação
- Acesse https://ngrok.com
- Baixe a versão adequada para o seu sistema operacional.
- Extraia e instale o executável.
- Crie uma conta gratuita (opcional, mas recomendado).
- Gere o AuthToken.
- Configure seu AuthToken.
ngrok config add-authtoken YOUR_AUTHTOKEN
Iniciando um túnel
Se o ngrok já estiver configurado:
ngrok http 3000
Substitua 3000 pela porta da sua aplicação.
Exemplo de saída
Forwarding https://abc123.ngrok-free.app -> http://localhost:3000
Sua aplicação agora está acessível através da URL HTTPS pública.
Alternativa: use a ferramenta de teste de callback do Cams
Você também pode usar o utilitário de teste de callback fornecido pela Cams.
- Instale e descompacte a ferramenta usando o link a seguir.
https://developer.camsbiometrics.com/setup/ngrok-helper-kit.rar - Edite o arquivo
app.properties. - Configure:
ngrok.auth.token=
ngrok.tunnel.url= - Execute:
check_ngrok.bat
O utilitário estabelecerá o túnel automaticamente e simplificará o teste local de callbacks.
Configuração da integração de callback
Passo 1: Inicie sua aplicação local
Passo 2: Inicie o túnel
Passo 3: Teste o callback
Dispare um evento de teste de exemplo e verifique o seguinte:
- Sua aplicação recebe a requisição de callback.
- Os payloads das requisições são processados com sucesso.
- Nenhum erro aparece nos logs da aplicação.
- As requisições são visíveis no painel do túnel.
Melhores práticas
- Use URLs de callback HTTPS sempre que possível.
- Mantenha o túnel ativo durante os testes.
- Revise os logs da aplicação para validação das requisições.
- Verifique se o seu endpoint retorna os códigos de resposta HTTP esperados.
- Teste cenários de tratamento de erros antes de passar para produção.
Observações importantes
- As URLs gratuitas do ngrok mudam sempre que o túnel é reiniciado.
- Os planos pagos do ngrok oferecem suporte a domínios reservados e subdomínios personalizados.
- Túneis temporários devem ser usados apenas para fins de desenvolvimento e teste.
Conclusão
Expor seu servidor local por meio de um serviço de túnel é a forma mais rápida de testar sua URL de callback antes de implantar sua aplicação. Seja com ngrok, Cloudflare Tunnel ou localhost.run, o processo permite receber requisições de callback em tempo real e validar sua integração em um ambiente de desenvolvimento local.
Seguir os passos acima ajudará a garantir uma transição tranquila do desenvolvimento para a implantação em produção.