Overview
Un mensaje que permanece en cola (sin llegar nunca a DELIVRD ni UNDELIV) suele significar que la pasarela lo aceptó, pero que el operador de destino aún no lo ha entregado. Esto suele deberse a que está programado para entregarse más tarde, se ha limitado a su límite de TPS, está esperando a que expire su período de validez en un terminal apagado o sin cobertura, o se encuentra en una ruta congestionada. Compruebe la hora de programación, su límite de rendimiento y el DLR: un mensaje solo sale de la cola cuando el operador devuelve una confirmación final.
Está programado para más tarde.
Si configura schtime (con GMT), la pasarela retiene el mensaje hasta ese momento, por lo que permanece en cola hasta que llega la hora programada. Verifique la hora/GMT que envió: una diferencia horaria GMT incorrecta o una fecha futura es la razón más común por la que un lote "no se envía". Omita schtime para enviar inmediatamente; la API REST devuelve un ScheduleId cuando se programa un envío.
- schtime (aaaaMMddhhmm) + gmt retiene el mensaje hasta ese momento.
- Un desfase horario GMT incorrecto puede retrasar el envío varias horas.
- Omita schtime para enviar ahora.
- Un lote programado devuelve un ScheduleId, no una entrega inmediata.
Está limitado a tu límite de TPS
Un lote grande se procesa al ritmo permitido por su cuenta (mensajes por segundo), por lo que los mensajes posteriores permanecen en cola mientras que los anteriores se envían; esto es normal, no un fallo. Si el volumen sostenido es importante, solicite un TPS más alto. Los envíos muy grandes es mejor enviarlos como archivo de destinatarios al endpoint masivo /sms/sendbulk que como una única solicitud enorme.
- Los lotes grandes se vacían en la tapa del TPS; las piezas posteriores esperan.
- Este ritmo es el esperado, no un error.
- Solicitar un mayor rendimiento para un volumen sostenido.
- Use /sms/sendbulk para listas muy grandes.
El teléfono no está disponible dentro del período de validez.
Si el teléfono del destinatario está apagado o fuera de cobertura, el centro de mensajes SMS del operador almacena el mensaje y lo intenta de nuevo hasta que el dispositivo vuelva a estar disponible o expire el período de validez. Durante ese tiempo, el mensaje se pone en cola legítimamente. Cuando la validez expira sin que el mensaje se haya entregado, el registro de entrega pasa a estado UNDELIV/expired; por lo tanto, un mensaje que lleva mucho tiempo en cola suele resolverse una vez que el dispositivo vuelve a estar en línea.
- El sistema de almacenamiento y reenvío de SMSC reintenta la comunicación con un teléfono inaccesible.
- El mensaje permanece en cola hasta su entrega o hasta que expire su validez.
- Al expirar, el DLR pasa a estar UNDELIV/expirado.
- A menudo se soluciona cuando el teléfono vuelve a tener cobertura.
Verificar créditos, ruta y estado real
Si no hay ningún movimiento, confirme el saldo (un envío puede fallar con HTTP18, créditos insuficientes) y verifique que el ID del remitente y la ruta estén aprobados para el destino. No infiera el estado a partir de la ausencia de un webhook: consulte directamente el estado de cada mensaje (en la API HTTP heredada: /websmpp/websmsstatus con el ID de respuesta).
- ¿No hay ningún movimiento? Compruebe los créditos: HTTP18 no tiene saldo suficiente.
- Confirme que el ID del remitente y la ruta estén aprobados para el país.
- Lea el estado real consultándolo directamente (API HTTP heredada: /websmpp/websmsstatus).
- No saques conclusiones precipitadas de un webhook que no aparece; consulta el estado.