La integración de una [API de SMS en Marruecos](/fr/api-sms-maroc/) suele ser muy rápida. Pero una vez en producción, frente a números reales marroquíes (IAM, Orange, inwi) y bajo la carga de envíos masivos, se producen errores.
A diferencia de los protocolos SMPP, donde las PDU complejas se descifran en hexadecimal, las API REST modernas utilizan códigos de estado HTTP estándar. Sin embargo, la documentación oficial a veces carece de contexto empresarial. ¿Qué significa realmente un error 400 en el contexto del envío de SMS a Marruecos?
Aquí está la "cheat sheet" de los desarrolladores marroquíes: la lista de los códigos de error de API SMS más comunes, su significado real para el negocio, y cómo solucionarlos sin perder tiempo.
Tabla rápida de errores HTTP de la API SMS
HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP HTTP
Errores Fatal: 400 y 403
Error 400: Bad Request (Error del desarrollador) Esta es la causa del 80% de los errores de integración inicial. - La causa local: Los usuarios marroquíes a menudo ingresan su número como 0661123456. Si pasas este número como sea a la API, te devolverá un error 400. - La solución: Siempre limpia la entrada. Elimine los espacios y el 0 inicial, y prefijate con 212.
Error 403: Forbidden (Error de conformidad) Su clave de API es buena (no tiene 401), pero la solicitud se rechaza. - La causa local: En Marruecos, no puede usar un Sender ID alfanumérico (ej.: MA MARCA) si no ha sido explícitamente aprobado por el operador. Si envía una solicitud con sender: "MON APP" mientras no está blanquecino en su cuenta, recibirá un 403. - La solución: Utilice el Sender ID predeterminado proporcionado durante sus pruebas, o póngase en contacto con el soporte para enviar el formulario de autorización de su marca con su RC.
Los errores de límite: El famoso 429
Si ejecuta un simple loop 'for' en PHP o Node.js para enviar 50.000 SMS promocionales para el Black Friday, usted va a golpear un muro muy rápido.
Error 429: Too Many Requests Las API REST imponen un límite de velocidad (Rate Limiting), a menudo expresado en Requests per Second (RPS). - El problema: Enviar un SMS por solicitud HTTP en un bucle asíncrono saturará la conexión y desencadenará rechazos 429. Los mensajes rechazados se perderán. - La solución: No utilice el punto final unitario para envíos masivos. Utilice el punto final Bulk de la API (que acepta una tabla de números en una sola carga de pago JSON) para eludir el límite de velocidad HTTP.
No confundir "Succeso HTTP" y "Mensaje recibido"
Un código HTTP 200/202 no significa que el SMS haya sido recibido por el cliente. Esto sólo significa que la pasarela SMS ha aceptado su solicitud. El mensaje todavía puede fallar más tarde si el teléfono está apagado o si el número ya no se asigna. Para conocer el verdadero estado de entrega (DLR), necesitas implementar un Webhook de recepción en tu arquitectura.
Preguntas frecuentes
¿Cuál es la latencia de enrutamiento en las redes IAM, Inwi y Orange?
En nuestras rutas locales hacia Maroc Telecom (IAM), Orange e inwi, el plazo mediano hasta la confirmación del operador es de 11 a 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 cualquier fallo en la entrega.