Sandbox

Modo sandbox

Teste os quatro canais de verificação sem enviar mensagens reais, fazer chamadas reais ou gerar custos. Do registo a uma integração funcional em menos de cinco minutos.

✓Nenhuma mensagem real enviada

✓Sem ligações a operadoras

✓Sem faturação

✓100 chamadas de teste / dia

1Obtenha as suas credenciais de teste

As chaves de API de sandbox começam por sk_test_. Crie uma no painel, em Sandbox Keys. Use a sua chave de sandbox com os endpoints /sandbox dedicados — veja os exemplos de código no Passo 3.

api key

production  BTEL_xxxxxxxxxxxxxxxx
sandbox     sk_test_xxxxxxxxxxxxxxxx

Os pedidos de sandbox vão para endpoints /sandbox dedicados (p. ex. /call/flash/sandbox), não para as rotas de produção. Uma chave sk_test_ num endpoint de produção será rejeitada — use sempre o URL de sandbox.

2Use um número de telefone de teste

Qualquer número no intervalo +1 555 000 xxxx é um número de teste. Cada canal reconhece quatro números especiais com comportamentos distintos — consulte a tabela por canal no Passo 3.

3Envie uma verificação de teste

Escolha um canal abaixo. Cada pedido de sandbox para um número de teste responde com um payload simulado previsível — não é feita nenhuma chamada de rede real.

Substitua sk_test_xxxxxxxxxxxxxxxx pela sua chave de sandbox real, disponível no painel.

POST/api/v1/connect-hub/call/flash/sandbox

bash

curl -X POST https://api.novauth.com/api/v1/connect-hub/call/flash/sandbox \
  -H "x-api-key: sk_test_xxxxxxxxxxxxxxxx" \
  -H "x-account-id: YOUR_ACCOUNT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "callee":        "+15550000001",
    "max_ring_time": 20
  }'

200 OK — Resposta de sandbox

json

{
  "uuid":    "test_fc_01JQHM7P3K2NX4Y8",
  "caller":  "+15550482951",
  "callee":  "+15550000001",
  "sandbox": true
}

No sandbox, a chamada nunca é efetuada. O caller +15550482951 da resposta codifica o OTP nos últimos 6 dígitos — a sua aplicação lê 482951.

Números de teste para Verify Call:

NúmeroComportamentoEstado

+15550000001Sucesso — o ID de chamada +15550482951 codifica o OTP 482951200

+15550000002Sucesso — não existe equivalente de falha de sincronização para o verify-call200

+15550000003Gateway SIP não ligado503

+15550000004Erro interno do servidor500

Comunique o resultado da verificação usando o mesmo webhook da produção. Consulte o início rápido do canal para o passo do webhook.

Limites e faturação

Limite diário100 verificações de teste em todos os canais

FaturaçãoNunca cobrado — o sandbox é sempre gratuito

CanaisVerify Call, SMS, WhatsApp, OTP do Telegram

Números de testeIntervalo +1 555 000 xxxx — o comportamento varia por canal

Retenção de CDR7 dias (igual à produção)

Quando excede o limite diário, a API devolve 429 Too Many Requests com a mensagem Sandbox daily limit of N verifications reached. Resets at midnight UTC. Aguarde até às 00:00 UTC ou use outra conta.

Pronto para passar a produção? Veja os preços — troque sk_test_ pela sua chave BTEL_ e atualize as rotas dos endpoints para remover /sandbox.