Messaging Statuses

SMS Lifecycle##

Every SMS and each campaign (also called bulk messaging) has its own lifecycle. Routee is limiting that lifecycle into steps that are most important to you. These steps are called Statuses. SMS and SMS Campaigns have different statuses.

SMS Statuses##

Title	Description
Queued	It's the initial status of an SMS. It means that Routee has received your request and the SMS is about to be sent.
Sent	The SMS was sent to its recipient but Routee doesn't know yet if it has been delivered or not.
Delivered (final)	The SMS was sent and it was delivered to its recipient.
Undelivered (final)	Routee has received a delivery receipt indicating that the message was not delivered. This can happen for a number of reasons including carrier content filtering, availability of the destination handset, etc.
Failed (final)	The SMS was not sent because Routee was unable to process it.
Unsent (final)	The SMS was not sent due to insufficient balance. This status will appear only when using the Bulk SMS Resource

Detailed Status#

Routee provides a response parameter for detailed status, so that you know the reason of Undelivered message.

Detailed Status	Description
Undelivered on Handset	The destination handset you are trying to reach is switched off or otherwise unavailable.
Unknown Number	The destination number you are trying to reach is unknown and may no longer exist.
Roaming	The destination number you are trying to reach is in roaming and can not accept the message.
Call Barred	The destination number you are trying to reach is blocked from receiving this message.
Unknown Status	Undelivered for unknown reason.
Carrier Violation	Your message was flagged as objectionable by the carrier. In order to protect their subscribers, many carriers have implemented content or spam filtering.
Expired	TTL validity period expired. The message is not delivered to the recipient after multiple re-tries.

* Extra Detailed Statuses specifically for India

Detailed Status	Description
DND Error Code	Active Do Not Disturb Service.
Sender ID Error Code / Template Error Code	Sender ID or Content is not registered.
Memory Capacity Exceeded	Handsets memory is full.
Quiet Hours	Promotional messages blocked after 9 PM.

Campaign Statuses##

Title	Description
Scheduled	The campaign was scheduled to run in the future. This status only applies when you schedule a campaign.
Queued	The campaign was queued and its individual messages (SMS) are about to be sent.
Running	The campaign has started and it's running. Routee sends all individual SMS. Depending on the number of the recipients this step will last some seconds to some minutes.
Sent	All individual SMS were successfully sent and Routee is waiting to be informed of each message status (whether they were delivered or not).
Finished (final)	Routee has been informed about the final status of all individual SMS (if they were delivered or not).
Failed (final)	Routee was unable to process the campaign (or a part of it).

Final status is a status that ends the lifecycle of an SMS or a bulk messaging campaign.

Campaign Status vs SMS Status##

Although a bulk messaging campaign has its own set of statuses, each SMS generated has its own set too. Every SMS that was created as a result of a bulk messaging campaign has its own lifecycle, hence its own SMS set of statuses as described above.