Especialidad technical

Pruebe su integración SMS en sandbox en Marruecos antes de pasar a la producción

Testar SMS sandbox antes de la producción: guía técnica con ejemplos de código para desarrolladores en Marruecos.

Pruebe su integración SMS en sandbox en Marruecos antes de pasar a la producción
En este artículo
  1. 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:
  2. ¿Por qué las pruebas en sandbox cambian las cosas?
  3. Lo que un buen entorno de prueba debe simular
  4. Checklist (Go / No-Go) antes de cambiar a la producción
  5. Errores frecuentes que se cometen en el transcurso de la prueba

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:

  1. Puede drenar completamente su saldo de créditos debido a un loop infinito en su código.
  2. 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á un HTTP 200 y desencadenará inmediatamente una llamada Webhook con el estado Delivered.
  • 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á un Rejected con 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 webhook Failed. 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:

  1. [ ] 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?
  2. [ ] 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?
  3. [ ] 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?
  4. [ ] 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).

¿Por qué elegir EnvoiSMS para su negocio?

Entrega a Operadores

Rutas locales hacia IAM, Orange e Inwi, con conmutación automática entre rutas y estado de entrega enviado por webhook.

Optimización de Costes

WhatsApp Business API desde 0,65 MAD por mensaje. El mejor retorno de inversión.

Conformidad CNDP

Alojamiento que cumple con las regulaciones de protección de datos personales locales.

¿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: 46–58 s (medido en septiembre 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.

Artículos sugeridos

Formateo de SMS en Marruecos: saltos de línea, codificación GSM-7 frente a UCS-2 y optimización de costes
technical

Formateo de SMS en Marruecos: saltos de línea, codificación GSM-7 frente a UCS-2 y optimización de costes

Formato empresarial de WhatsApp en Marruecos: texto enriquecido, emojis y botones interactivos
technical

Formato empresarial de WhatsApp en Marruecos: texto enriquecido, emojis y botones interactivos

Autenticación WhatsApp en 1-Clic y One-Tap Autofill OTP en Marruecos
technical

Autenticación WhatsApp en 1-Clic y One-Tap Autofill OTP en Marruecos