Sandbox

​

¿Qué es la zona de pruebas?

Es el entorno de prueba de Notifique. La API es la misma (https://api.notifique.dev/v1/...); lo que cambia es la clave: usa sk_test_... en lugar de sk_live_.... Piense en un simulador de vuelo: la misma cabina, las mismas maniobras, nadie despega.

​

¿Para qué sirve?

Con sandbox puedes:

• Integrar tu aplicación sin enviar SMS, correos electrónicos o WhatsApp reales
• Probar webhooks, plantillas y flujos antes de la puesta en marcha
• Simular el estado de entrega (entregado, leído, fallido) en la bandeja de entrada de Sandbox
• Validar cargas útiles y errores sin debitar créditos

Nada en Sandbox afecta los datos de producción o los envíos.

​

¿Cuándo usarlo?

​

Cómo utilizar

​

1. Cree una clave de prueba

Abra Desarrollador → Claves API, cree una clave Sandbox y copie sk_test_... inmediatamente. ¿Necesita ayuda? Consulte Claves API.

​

2. Llame a la API como de costumbre

Misma URL, mismos endpoints. Solo cambia la clave en el encabezado: No hay encabezado de entorno extra. La clave lo define todo.

​

3. Seguimiento en la bandeja de entrada Sandbox

Abra Desarrollador → Bandeja de entrada Sandbox. Allí puede:

• Revisar cada carga útil de envío
• Liberar mensajes programados con Liberar ahora
• Simular estado: entregado, leído, clic, fallido (por canal)

​

4. Probar webhooks

Los eventos usan los mismos nombres que en producción. La carga útil incluye sandbox: true en data para filtrar en el mismo endpoint. Más en Webhooks.

​

5. Pasar a producción

Cuando esté listo, cambie sk_test_... por sk_live_... en las mismas rutas. Como pasar del simulador al vuelo real.

​

Qué funciona y qué no

​

WhatsApp oficial (Cloud API) en sandbox

Con sk_test_, POST /v1/whatsapp/messages y POST /v1/templates/send no llaman a Graph ni a la puerta de pago de Meta:

• Sin ping de token → no marca la instancia real como DISCONNECTED
• Sin META_PAYMENT_METHOD_REQUIRED / META_TEMPLATE_REQUIRED reales
• La carga útil aparece en la bandeja Sandbox como en otros canales

Use producción (sk_live_) para validar una plantilla aprobada, la ventana de 24 h y una tarjeta en WhatsApp Manager. Detalles: Plantillas oficiales Meta.

​

Límites

​

Sandbox vs producción

---

​

Próximos pasos

• Empiece aquí: envíe su primer mensaje de prueba
• Claves API: crear y usar sk_test_ y sk_live_
• Webhooks: recibir eventos simulados en su servidor