Cuando envías miles de SMS a Marruecos, la respuesta de la API (`HTTP 202 Accepted`) solo confirma una cosa: la pasarela ha recibido bien tu solicitud. Para saber si el cliente realmente recibió el mensaje en su teléfono, debes interpretar los **Delivery Reports (DLR)**.
Estos avisos de recepción asimétricos son enviados por el operador (IAM, Orange, inwi) a la pasarela, que los envía a usted a través de un Webhook.
La comprensión precisa de estos 4 estatutos es vital para monitorear la salud de sus envíos, identificar una base de datos corrupta, o responder a una falla de red de operadores.
Los 4 estatutos DLR explicados de forma sencilla
1. DELIVERED (Distribuido con éxito) Este es el estado final ideal. Este confirma formalmente que el SMS ha llegado al teléfono del destinatario. Plazo técnico: Este estado llega cuando el operador confirma la entrega; el plazo varía según el operador y el estado de la red (en octubre de 2026, la mediana hasta esa confirmación en nuestras rutas marroquíes se situaba entre 11 y 17 segundos).
2. PENDING (En espera de entrega) El mensaje ha sido enviado al operador local, pero este aún no ha podido entregarlo al combinado. ¿Por qué? El teléfono está apagado, en modo avión, fuera de la zona de cobertura, o la caja de recepción SMS del cliente está llena. Duración: El operador mantendrá el mensaje en 'Pending' durante un período definido (Período de validez, a menudo 24 horas o 48 horas).
3. FAILED El mensaje no pudo ser entregado, y el operador abandonó los intentos. ¿Por qué? El número ya no existe, no se asigna (No-Existent Number), el plazo de validez ha pasado, o el teléfono ha bloqueado específicamente la recepción. Una alta tasa de 'Failed' indica que su base de datos no está limpiada y contiene muchos "números muertos".
4. UNKNOWN / REJECTED El operador ha recibido la solicitud pero se niega categoricamente a reenviarla. ¿Por qué? El Sender ID no está permitido en esta red, el contenido ha sido marcado como SPAM por los filtros de la red, o la ruta a este prefijo está temporalmente cerrada.
Por qué un SMS permanece pendiente durante mucho tiempo
Una pequeña parte de 'Pending' al final de la campaña es normal (teléfonos apagados o fuera de la red).
Sin embargo, si observa un bloque masivo de mensajes bloqueados en 'Pending' (por ejemplo: 40% de la campaña) en un operador específico (por ejemplo, sólo los números en '0661'), esto indica un incidente de congestión de red (Throttling) o un fallo SMSC en el operador en cuestión.
Cuando un estado desconocido debe alertar a su equipo técnico
El estado de 'Unknown' o 'Rejected' es el más crítico. Si aparece de forma aislada, a menudo es un filtro anti-spam menor. Si afecta a una campaña entera desde el lanzamiento, alerta inmediatamente a tus desarrolladores: es probable que tu Sender ID esté en la lista negra o que tu cuenta haya sido bloqueada por no conformidad.
Ejemplo de carga real de JSON de webhook:```json
{
"event": "message.failed",
"data": {
"id": "msg_8f2da1b2c3d4e5f6a7b8c9d0",
"to": "+212612345678",
"channel": "sms",
"status": "failed",
"error_code": "DLR_REJECTD",
"error_message": "The destination network did not deliver this message and gave no reason."
},
"timestamp": "2026-06-27T10:05:22Z"
}
Cómo automatizar reinicios de estado fallido
El análisis de los DLR sólo tiene sentido si desencadena una acción comercial.
- Higiene básica: Configure un script que detecte los estados
Failed(con error tipo "número no asignado") y elimine o marque estos números como inactivos en su CRM. - Relanzamiento inteligente: Si un SMS crítico (OTP, confirmación de pedido) cae en 'Failed', configure su sistema para desencadenar un fallback automático: envíe la alerta por correo electrónico, WhatsApp, o inicie una llamada de voz.
El dominio de los DLR es la diferencia entre una aplicación que "envia SMS" y un [sistema de notificación robusto] (/fr/api-sms-maroc/) de nivel empresarial.
Preguntas frecuentes
¿Cómo seguir el enrutamiento en las redes IAM, Inwi y Orange?
Nuestras rutas locales hacia Maroc Telecom (IAM), Orange e inwi, con conmutación automática entre rutas, devuelven un estado de entrega del operador para cada mensaje, por webhook. El plazo de entrega depende del operador y de la red del destinatario.
¿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.