Este endpoint permite consultar la información completa de un mensaje SMS a partir de su identificador único. Al realizar la solicitud, el sistema devuelve los datos asociados al mensaje, incluyendo su contenido, codificación, estado actual, fechas relevantes del proceso de envío (como fecha de envío al operador y, si aplica, fecha de entrega al dispositivo móvil), detalles de enrutamiento, metadatos técnicos y cualquier información adicional registrada durante su procesamiento. Es una herramienta diseñada para que integradores, plataformas y clientes puedan obtener en tiempo real el estado y los atributos exactos de un mensaje específico dentro de la operación de Hablame.
Códigos de estado del mensaje (messageStatus)
messageStatus)| Código | Descripción |
|---|---|
| 0 | Fallido — El mensaje no pudo ser procesado o enviado. |
| 1 | En proceso — El mensaje está siendo gestionado. |
| 2 | Entregado al operador — El operador móvil recibió el SMS. |
| 3 | Entregado al dispositivo móvil — El SMS llegó al celular. |
El campo deviceDeliveryAt únicamente retornará una fecha y hora cuando el mensaje de texto haya sido solicitado en modalidad certificada. En los mensajes no certificados, este campo aparecerá en null. Para efectos de validación, debe entenderse que un mensaje certificado solo se considera válidamente entregado si este campo viene definido, ya que indica el momento exacto en que el mensaje fue recibido por el dispositivo móvil del usuario. Si deviceDeliveryAt no está seteado en un mensaje certificado, significa que dicho mensaje no pudo ser entregado al dispositivo móvil del destinatario.
Debido a la naturaleza asincrónica del envío de mensajes de texto, el estado del mensaje puede cambiar a lo largo del tiempo. Los operadores móviles, conforme a la regulación vigente, pueden realizar reintentos de entrega hasta por 48 horas, por lo que un mensaje inicialmente marcado como entregado al operador o en proceso podría actualizar su estado posteriormente. La consulta del mensaje refleja siempre el estado más reciente disponible.
Limites: 300 solicitudes por segundo.