SMS Status
Status for Outbound Messages
When sending outbound messages, the following represents a common sequence of status values:
| Status | Description |
|---|---|
| QUEUE | Messangi has received your request to create the message. indicates that the message has been scheduled for sending but has not yet been sent out. This status means the message is waiting in line to be processed and delivered to the recipient. It's essentially in a holding pattern, queued up in our system until it can be dispatched. |
| DEQUEUED | Messangi Indicates that the message has been removed from the queue and is now being processed for sending. This transition occurs after the message was previously in a waiting state (queued) and is now actively being sent to the mobile operator. |
| CODE_NOT_ALLOWED | Messangi suggests that the sender used is either not activated on the platform or lacks the capability to message the recipient. Additionally, it could be because the owner does not have a sender (short code or long code) assigned , which is required to send the message. Contact our support team to verify the Sender. |
| INCOMPLETE | When a message exceeds the maximum character limit (160 characters for 7-bit encoding and 70 characters for Unicode), it is segmented. This status applies to messages that have been segmented and for which we do not yet have the status of each segment. |
| BLACKLISTED | Messangi indicates that the intended recipient's phone number is on a blacklist, preventing any messages from being sent to that number. When a number is blacklisted, it is essentially blocked from receiving any further communications from the sender's number or campaign, ensuring that no messages are delivered to that recipient. |
| SEGMENTS_EXCEEDED | This status indicates that the number of permissible segments has been surpassed. This occurs when the message exceeds the 160-character limit per segment, therefore the the message cannot be sent. To resolve this issue, ensure that your SMS messages do not exceed 1600 characters to avoid reaching the segment limit. |
| EXHAUSTED | The maximum number of retry attempts has been reached, and the message will no longer be sent. |
| SENT | Indicates that the message has been successfully dispatched from our system and is en route to the mobile operator. This status means that the message is on its way to the recipient but does not confirm that the message has been delivered to the recipient's device. It signifies a successful handoff to the next stage in the message delivery process. |
ON TRANSIT STATES
The platform considers Transit states those after the message has been sent to the carrier but it has had no response as to the message's outcome. It is a temporary state that should eventually result on a final outcome.
Status for Completed Messages
Once the message is sent, nine potential final statuses can be achieved:
| Status | Description |
|---|---|
| ENROUTE | Messangi indicates that the message has been successfully sent from the sending system and is currently being enroute to the mobile operator. |
| INVALID_ROUTING | Indicates that the message cannot be delivered because the destination number is not recognized by the network. That is, the recipient’ phone number or route is invalid, preventing successful transmission. |
| ACCEPTD | Indicates that the mobile operator has acknowledged the message and has accepted it for delivery to the recipient's device. This does not guarantee that the message has been delivered to the end user yet, but it signifies that the mobile operator has taken responsibility for delivering the message to the recipient's device. |
| DELIVRD | Messangi has received confirmation of message delivery from the mobile operator. The message has successfully reached the recipient's device. This status confirms that the message not only was sent and processed by the mobile operator but also was received by the intended recipient's phone, ensuring that the communication was successfully completed. |
| REJECTD | Indicates that the message was not accepted by the mobile operator and therefore was not delivered. This rejection can occur for several reasons, such as the recipient's number being invalid, the phone being out of service, the message content violating network policies, or other technical issues preventing delivery. Essentially, it means the attempt to deliver the message was unsuccessful, and the message did not reach the intended recipient. |
| UNDELIV | Indicates that the mobile operator could not deliver the message to the recipient's device. This status can result from various issues such as the recipient's phone being switched off, network problems, or the recipient's phone number being incorrect or no longer in service. |
| EXPIRED | Indicates that the message was not delivered to the recipient within a certain timeframe set by the mobile operator. After this period, the message is no longer attempted to be delivered. Possible reasons for a message expiring can include prolonged network issues, the recipient's phone being off or out of service area for an extended time, or other delivery failures. |
| DELETED | Indicates that the message was removed by the mobile operator before it could be delivered to the recipient. |
| UNKNOWN | Indicates that the delivery status of the message cannot be confirmed or determined by the mobile operator. This status can occur for various reasons, such as communication issues between the sending and receiving networks or system errors. Essentially, it means that the system is unable to verify whether the message was successfully delivered, failed to deliver, or is still in the process of being sent. |
Updated 6 days ago