Conectar la API de mensajería de EnviarSMS a su backend tarda menos de 10 minutos.Pero si conectas esta integración directamente a tu base de datos de producción y ejecutas los scripts, te expones a dos desastres:
- Puede drenar completamente su saldo de créditos debido a un loop infinito en su código.
- Puede enviar SMS de prueba ("Hello test 123") a cientos de clientes reales marroquíes a las 3 de la mañana.
Es por eso que todas las integraciones profesionales requieren el paso a través de un entorno Sandbox (Sandbox). Aquí está cómo configurar y simular condiciones reales redes de telecomunicaciones marroquíes sin enviar SMS reales.
¿Por qué las pruebas en sandbox cambian las cosas?
El objetivo es asegurarse de que su aplicación (CRM, Laravel, Node.js) responda correctamente a eventos asíncronos complejos (los Delivery Reports o Webhooks DLR).
En el modo Sandbox en EnviarSMS: - Sus llamadas de API son gratuitas (el saldo de crédito no se cobra). - Los SMS nunca se redireccionan a las redes reales (IAM, Orange, inwi), evitando cualquier comunicación accidental a suscriptores reales. - Puede simular diferentes estados DLR (/fr/blog/dlr-pending-delivered-failed-unknown-que-significa-verdaderamente-esto/) (Delivered, Rejected, Failed) utilizando números de prueba específicos (Magic Numbers).
Lo que un buen entorno de prueba debe simular
Para calificar su código antes de su implementación en los servidores marroquíes, utilice "Números mágicos" en su API de carga útil para forzar la pasarela a generar escenarios de error:
- Prueba el éxito (Caso nominal): Utilice el número
+212600000001. La API le enviará unHTTP 200y desencadenará inmediatamente una llamada Webhook con el estadoDelivered. - Prueba de rechazo de red (Firewall): Utilice el número
+212600000002. La Sandbox simulará un bloqueo de operador (por ejemplo, ID de remitente prohibido) y su Webhook recibirá unRejectedcon un código de error de negocio. - Prueba el error fatal (número falso): Utilice el número
+212600000003. La Sandbox simulará un número que ya no existe en Maroc Telecom, devolviéndole un webhookFailed. Su script de gestión de base de datos debe detectar este estado y desactivar este contacto automáticamente.
Checklist (Go / No-Go) antes de cambiar a la producción
No sustituya la 'TEST_API_KEY' por su 'LIVE_API_KEY' hasta que haya marcado estos 4 puntos:
- [ ] Limpieza de números (E.164): ¿Tu backend obliga a todos los formatos locales introducidos por tus usuarios (
0661123456,07 14 56...) al estándar internacional+212661123456? - [ ] Verificación de la longitud (Código): ¿Has verificado si tus SMS en árabe (UCS-2) no superan el límite de 70 caracteres, a pesar de ser supercargados en múltiples segmentos?
- [ ] Seguridad de Webhooks: Su servidor verifica la firma HMAC-SHA256 (
X-EnviarSMS-Signature) para asegurarse de que los eventos DLR recibidos provienen de nuestros servidores y no de un hacker? - [ ] Sender ID conforme: ¿Has iniciado el procedimiento de whitelisting manual de tu Sender ID con el equipo de soporte? En la producción, un Sender ID no validado por los operadores marroquíes será simplemente rechazado.
Errores frecuentes que se cometen en el transcurso de la prueba
La transición de la Sandbox a la producción a menudo revela un olvido crítico: el Rate-Limiting. En la prueba, usted envía 3 SMS a mano. En la producción, su tarea CRON intentará enviar 10 000 SMS en un segundo. Su script golpeará el limite de débito de red y caerá con errores HTTP 429.
Asegúrese de que su arquitectura de producción incluya una fila de espera (Redis / Queue) (/fr/blog/gerer-les-retries-et-la-file-d-attente-sms-en-cas-d-echec-d/) que permita suavizar el envío masivo a un ritmo constante (por debajo del límite por minuto de su clave API: de 60 a 1 200 solicitudes/minuto según el plan).
Preguntas frecuentes
¿Cuál es la latencia de enrutamiento en las redes IAM, Inwi y Orange?
Utilizamos rutas locales hacia Maroc Telecom (IAM), Orange e inwi, con conmutación automática entre rutas. Mediana del tiempo hasta la confirmación del operador: 11–17 s (medido en octubre de 2026).
¿Cómo gestiona la plataforma el formato de los números marroquíes?
EnvoiSMS normaliza automáticamente los números introducidos (06..., 07..., 00212...) al estándar E.164 (+212) para evitar fallos de entrega debidos al formato.