SMS Status

You use SMS status values to track outbound messages from creation through final delivery. You review the common outbound sequence below. You also review the final statuses returned after delivery processing ends.

Status for outbound messages

When you send outbound messages, you may see the following status sequence:

StatusDescription
QUEUEYou see this status after your request reaches Messangi. You know the message is waiting for processing.
DEQUEUEDYou see this status when the message leaves the queue. You know the message is moving to the mobile operator.
CODE_NOT_ALLOWEDYou see this status when the sender is not activated or cannot message the recipient. You contact support to verify the sender.
INCOMPLETEYou see this status for segmented messages with pending segment statuses. You get segmented messages after exceeding 160 GSM-7 characters or 70 Unicode characters.
BLACKLISTEDYou see this status when the recipient phone number is on a blocklist. You know the message was not sent to that number.
SEGMENTS_EXCEEDEDYou see this status when the message exceeds the permitted segment limit. You keep SMS messages under 1600 characters to avoid this status.
EXHAUSTEDYou see this status when the retry limit is reached. You know delivery attempts have stopped.
SENTYou see this status after Messangi dispatches the message to the mobile operator. This status does not confirm delivery to the recipient device.

:::info

You see transit states after carrier handoff and before a final outcome. You should eventually see a transit state change to a final status.

:::

Status for completed messages

After sending, you receive one of these final statuses:

StatusDescription
ENROUTEYou see this status after the sending system sends the message to the mobile operator.
INVALID_ROUTINGYou see this status when the destination number or route is invalid. You know the network cannot deliver the message.
ACCEPTDYou see this status when the mobile operator accepts the message for delivery. You should not treat this status as delivery confirmation.
DELIVRDYou see this status after delivery confirmation from the mobile operator. You know the message reached the recipient device.
REJECTDYou see this status when the mobile operator rejects the message. You may need to check the number, phone status, or policy restrictions.
UNDELIVYou see this status when the mobile operator cannot deliver the message. You may need to check network issues or recipient number status.
EXPIREDYou see this status when the operator cannot deliver the message within the allowed time. You know delivery attempts stopped after the window expired.
DELETEDYou see this status when the mobile operator removes the message before delivery.
UNKNOWNYou see this status when the mobile operator cannot confirm delivery. You may need to check for network communication issues or system errors.