¿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 cómo se trata el mensaje — por clave (sk_test_) o por destino de prueba del workspace.
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
- Previsualizar mensajes en la bandeja sandbox (burbuja, HTML, push, RCS, voz)
- Validar HTML de email con el verificador de Compatibilidad
- Simular el estado de entrega (entregado, leído, fallido) en la bandeja sandbox
- Validar cargas útiles y errores sin debitar créditos
Dos formas de entrar al sandbox
Destinos de prueba por workspace
Cada workspace tiene identidades fijas, derivadas del slug al crearlo:
En el panel: Developer → Bandeja sandbox → Tus destinos de prueba (copiar email, teléfono y device). Los compositores de envío (Nuevo email, SMS, etc.) muestran el mismo atajo.
Ejemplo con clave de producción — solo se intercepta si el destino coincide:
sk_test_, cualquier to funciona; el dominio de origen no necesita estar verificado.
¿Cuándo usarlo?
Cómo usarlo
1. Crea una clave de prueba (opcional)
Abre Developer → API Keys, crea una clave Sandbox y copiask_test_... de inmediato. ¿Necesitas ayuda? Consulta Claves de API.
Con los destinos de prueba del workspace, también puedes usar sk_live_ sin enviar nada al cliente.
2. Llama a la API con normalidad
Misma URL, mismos endpoints. Cambia la clave o el destinatario:3. Sigue el progreso en la bandeja sandbox
Abre Developer → Bandeja sandbox. Allí puedes:- Previsualizar cada mensaje en la pestaña Vista previa (como en el detalle de producción)
- Para email, usar la pestaña Compatibilidad (verificador HTML: CSS, imágenes, enlaces, deliverability)
- Revisar payload bruto y metadatos (Detalles, Payload)
- Liberar mensajes programados con Liberar ahora
- Simular estado: entregado, leído, clic, fallido (según el canal)
- Consultar ejemplos de webhook por canal en la pestaña Webhooks
4. Probar webhooks
Los eventos usan los mismos nombres que en producción. El payload incluyesandbox: true en data para filtrar en el mismo endpoint. Los envíos interceptados por destino incluyen intercepted: true en los metadatos de la bandeja. Más en Webhooks.
5. Plantillas y email en sandbox
- Editor de plantillas: Prueba de vista previa de la plantilla → destino Sandbox → mensaje en la bandeja, sin proveedor real ni cobro.
- API:
POST /templates/:id/send-testcon"sandbox": true(panel) oPOST /v1/templates/sendcon destinos de prueba /sk_test_. - Email:
POST /v1/email/messageso Email → Nuevo email en el panel; vista previa HTML y verificador de compatibilidad en el compositor.
6. Ir a producción
Cuando estés listo, usa destinatarios reales consk_live_.... Es cambiar el simulador por el vuelo real.
Qué funciona y qué no
WhatsApp oficial (Cloud API) en sandbox
Consk_test_, los endpoints POST /v1/whatsapp/messages y POST /v1/templates/send no llaman a Graph ni al gate de pago Meta:
- Sin ping de token → no marca la instancia real como
DISCONNECTED - Sin
META_PAYMENT_METHOD_REQUIRED/META_TEMPLATE_REQUIREDreales - El payload aparece en la bandeja sandbox como en otros canales
sk_live_) para validar plantilla aprobada, ventana de 24h y tarjeta en WhatsApp Manager. Detalles: Plantillas oficiales Meta.
Las operaciones que dependen de un proveedor real (QR WhatsApp, conexión Instagram) pueden devolver 403 o 501 en sandbox.
Límites
Sandbox vs producción
Próximos pasos
- Empieza aquí: envía tu primer mensaje de prueba
- Claves de API: crear y usar
sk_test_ysk_live_ - Webhooks: recibir eventos simulados en tu servidor
- Plantillas: probar multicanal en sandbox