DLR pending, delivered, failed, unknown: lo que realmente significan estos estados SMS

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.

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 septiembre de 2026, la mediana hasta esa confirmación en nuestras rutas marroquíes se situaba entre 46 y 58 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.

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.

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"
}

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.