Vas a lograr entender qué es una sandbox, cómo pedir una y qué puede (y no
puede) hacer una clave moz_test_.
Qué es
Una sandbox es una organización de prueba aislada: tiene una cartera con
deudores ficticios y ninguna otra organización puede ver sus datos. Sirve
para probar tu integración contra la API pública antes de tener una cuenta de
producción.
Cómo pedirla
Pedí la sandbox desde el formulario de demo del sitio de Mozart, marcando
“Quiero probar la API en un entorno de prueba (sandbox)”:
mozarth.com/es?sandbox=1.
Un miembro del equipo de Mozart revisa y aprueba cada pedido. Al aprobarlo:
- se crea tu organización de prueba con una cartera sandbox de deudores
ficticios,
- te llega un email de invitación para entrar a la plataforma,
- el equipo de Mozart te entrega una clave
moz_test_ (nunca por email),
igual que una clave moz_live_ (ver Autenticación).
Qué puede hacer una clave moz_test_
Una clave moz_test_ sólo ve las carteras sandbox de su propia organización.
Dentro de ese alcance puede leer y escribir: deudores, pagos, cargas de
cartera y webhooks, igual que una clave de producción con scope write.
Ninguna llamada, mensaje de WhatsApp ni otro contacto sale nunca hacia una
persona real desde una sandbox: la organización de prueba no puede discar
llamadas reales.
Usá sólo datos ficticios en tu integración de prueba. No cargues deudores
reales en una sandbox: la cartera sandbox está pensada para eso y una carga
real ahí no cumple ningún propósito.
Vencimiento
Una sandbox vence a los 30 días de aprobada. Pasado ese plazo, la clave deja
de funcionar: una clave moz_test_ vencida responde 401 unauthorized, lo
mismo que una clave revocada o expirada (ver
Paginación, errores y límites).
Claves de producción
Una clave moz_live_ (o de cualquier otro stage productivo) no cambia de
comportamiento por la existencia de las sandboxes: sigue viendo las carteras
activas de su organización, igual que hoy.
Siguiente paso
Con tu clave de prueba lista, seguí la
Guía de inicio rápido para hacer tus primeras llamadas.