Sandbox

Modo Sandbox

Prueba los cuatro canales de verificación sin enviar mensajes reales, realizar llamadas reales ni incurrir en cargos. Desde el registro hasta una integración funcional en menos de cinco minutos.

✓Sin mensajes reales enviados

✓Sin conexiones con operadores

✓Sin facturación

✓100 llamadas de prueba / día

1Obtén tus credenciales de prueba

Las claves de API de sandbox comienzan con sk_test_. Crea una desde el panel en Claves de Sandbox. Usa tu clave de sandbox con los endpoints dedicados /sandbox; consulta los ejemplos de código en el Paso 3.

api key

production  BTEL_xxxxxxxxxxxxxxxx
sandbox     sk_test_xxxxxxxxxxxxxxxx

Las solicitudes de sandbox van a endpoints dedicados /sandbox (p. ej. /call/flash/sandbox), no a las rutas de producción. Una clave sk_test_ en un endpoint de producción será rechazada: usa siempre la URL de sandbox.

2Usa un número de teléfono de prueba

Cualquier número en el rango +1 555 000 xxxx es un número de prueba. Cada canal reconoce cuatro números especiales con comportamientos distintos; consulta la tabla por canal en el Paso 3.

3Envía una verificación de prueba

Elige un canal a continuación. Cada solicitud de sandbox a un número de prueba responde con un payload simulado predecible; no se realizan llamadas a la red real.

Reemplaza sk_test_xxxxxxxxxxxxxxxx con tu clave de sandbox real del panel.

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 — Respuesta de Sandbox

json

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

En sandbox la llamada nunca se realiza. El número de llamada de respuesta +15550482951 codifica el OTP en sus últimos 6 dígitos; tu aplicación lee 482951.

Números de prueba para Verify Call:

NúmeroComportamientoEstado

+15550000001Success — el ID de llamada +15550482951 codifica el OTP 482951200

+15550000002Success — no existe equivalente de fallo síncrono para verify-call200

+15550000003Gateway SIP no conectado503

+15550000004Error interno del servidor500

Reporta el resultado de la verificación usando el mismo webhook que en producción. Consulta el inicio rápido del canal para el paso de webhook.

Límites y facturación

Límite diario100 verificaciones de prueba entre todos los canales

FacturaciónSin cargos: el sandbox es siempre gratuito

CanalesVerify Call, SMS, WhatsApp, OTP de Telegram

Números de pruebaRango +1 555 000 xxxx — el comportamiento varía según el canal

Retención de CDR7 días (igual que en producción)

Cuando superas el límite diario, la API devuelve 429 Too Many Requests con el mensaje Sandbox daily limit of N verifications reached. Resets at midnight UTC. Espera hasta las 00:00 UTC o usa una cuenta diferente.

¿Listo para pasar a producción? Consulta los precios: cambia sk_test_ por tu clave BTEL_ y actualiza las rutas de los endpoints eliminando /sandbox.