Overview Of Message Statuses
ThruText assigns a status to every message you send so you can quickly see whether it was sent, held, or failed. These statuses appear in your message exports and help you understand delivery, avoid sending duplicate messages, and interpret billable volume.
Before we look at each status in detail, the table below gives you a quick reference for what each status means, whether it is billable, and whether any follow-up action is needed.
TABLE OF CONTENTS
- Non-Terminal vs. Terminal Statuses
- Table of Message Statuses
- Non-Terminal Status
- Terminal Statuses
- Review Message Status In Exports
Non-Terminal vs. Terminal Statuses
- Non-terminal status means that a message may still be sent later without requiring any action on your part. This state is temporary and will change based on campaign open hours or provider throughput.
- Terminal statuses mean no further delivery attempts will be made for that message. If you still need to reach the contact, you’ll need to resend according to the action guidance below.
Table of Message Statuses
Before we examine each status in detail, the table below provides a quick reference for what each status means, whether it is billable, and the recommended action, if any, you should take.
| Status | Meaning | Billable? | Action Needed |
|---|---|---|---|
| Unsent | Message held in ThruText and not yet sent to the provider | No | May send later; see below for more info |
| Sent | Message successfully sent to provider | Yes | No action needed unless error |
| Sending Failed | The message couldn’t be sent | No | Resend from a new campaign |
| Campaign Closed | Message blocked because campaign was closed | No | Resend from a new campaign |
| Handoff Failure | Provider rejected the message | No | Resend from a new campaign |
| Country Unsupported | Message sent to an unsupported country | No | Do not resend to this contact |
Non-Terminal Status
Unsent
Definition: This status means the message was held in ThruText and not yet sent to the provider.
Context: Initial Messages may remain unsent while the campaign is open due to carrier rate limits. Replies will only be held if sent outside of the campaign's open hours. Unsent messages will be attempted when the campaign opens next.
- If the campaign's Initial Message Sending End Date has not passed, unsent initial messages will be attempted when the campaign opens next. If the T-Mobile daily limit is reached again, remaining unsent messages will be held until the next day. Review our guide Initial Message Sending Window for more information.
- Unsent initial messages by campaign can be reviewed on the Campaign Details Page in the Campaign Analytics section, in the Queued box. Review our guide ThruText Campaign Analytics for more information.
- If a reply or auto-opt out messages is sent while a campaign is closed, the messages will send when the campaign opens next. Review our guide Daily Open and Close Times for more information.
- If a message remains unsent, it will not be billed.
Action: If the initial message window has passed, the message will not be sent unless you create a new group and campaign.
Terminal Statuses
Sent
Definition: The message was successfully sent to the provider.
Context: These messages are included in your bill unless the provider returns a non-billable error code. Most errors are billable; learn more about error codes in our guide, Message Errors in Exports.
Action: No action needed unless the export shows a delivery error.
Sending Failed
Definition: The message was not sent to the provider.
Context: This can happen if messages were queued and the initial messaging sending window passed before they could be sent. Refer to our guide, Throughput and Queuing Post-10DLC, for information on sending limits.
Action: These messages will not be retried from this campaign. To resend these messages, filter them from your message export and create a new group and campaign.
Campaign Closed
Definition: The message was blocked because the campaign was closed before it could send.
Context: This status is applied if a message is scheduled outside of open hours and the campaign is archived, or if it was sent while the campaign was manually closed.
Action: Create a new group and campaign to resend these messages.
Handoff Failure
Definition: The provider rejected the message and did not accept it from ThruText.
Context: This typically occurs due to carrier restrictions or delivery issues.
Action: Create a new group and campaign to resend these messages if you still need to reach this contact.
Country Unsupported Failed
Definition: The message was sent to a phone number outside the supported country range.
Context: U.S. numbers can only text other U.S. numbers. Attempting to text a number outside the U.S. results in this failure.
Action: Do not resend messages to these contacts.
Review Message Status In Exports
The status of each message is reviewable in a message export. Create an Account or Campaign-level Message Export and review the columns message_status and billable to understand each message's status.
Related Guides