Understanding Text Message Delivery Codes

Christy Cook Updated by Christy Cook

The following diagram shows the status progression of your text messages as DailyStory attempts to send them to your contacts' inbox.

Status

Description

Sent

The text message was sent successfully to the upstream carrier, which will then deliver the message to the contact's inbox.

Fail

DailyStory could not send the text message to the upstream carrier because of an invalid phone number or the phone number belonging to a non-mobile system such as landline, Voice Over IP (VoIP), and so forth.

Delivered

DailyStory has received confirmation from the upstream carrier that the text message has been delivered to the contact's inbox.

Undelivered

The upstream carrier failed to send the text message to the contact due to the following reasons:

  • Your text message failed the upstream carrier's content filtering system.
  • The contact's destination handset is turned off or unavailable.

Failed

The upstream carrier could not send your text message due to overloading message queues, account suspensions, or missing or corrupted content in your text message.

Plivo failed and undelivered error codes

When the text message is flagged as Failed or Undelivered, Plivo determines the cause and reports it back to DailyStory where we identify and report it to our customers. See the table below for codes and descriptions.

Error code

Message

Description

10

Invalid Message

The message was rejected by downstream carriers with the reason "invalid message".

20

Network Error

The carrier delivering the text message had network issues. This is a temporary error. You can retry later when the carrier network is unaffected.

30

Spam Detected

The most common reason for delivery failure is carrier-level spam filters. Carriers have algorithims to detect spam content and block messages before they get delivered. Unfortunately these reasons are hidden and vary from carrier to carrier.

40

Invalid Source Number

The source number is either not in the correct format, is not SMS enabled, or is not assigned to your Plivo account.

50

Invalid Destination Number

The destination number is either not correctly entered, not SMS enabled or is a landline.

100

Prohibited by Carrier

The carrier rejected the message because the network didn't support the message being sent. This can occur if the destination network doesn't support SMS.

120

MMS Message Too Large

The total size of the MMS exceeds the 5MB limit. These messages are marked and not sent to the downstream carriers, and thus are not charged to the customer.

130

Unsupported MMS

One or more of the MMS messages is not supported. These messages are marked and not sent to the downstream carriers, and thus are not charged to the customer.

140

MMS Processing Failed

The attachments could not be processed. This may happe if the medial URL is unreachable or file data is incorrectly formatted. These messages are not sent to the downstream carriers, and thus are not charged to the customer.

200

Source number blocked by STOP from destination number

The destination number has opted out from your campaign and blocked all messages sent from your phone number.

420

Message Expired

Messages in the Plivo cue for more than 16 hours. Consider spreading your traffic across a larger pool of source numbers.

900

Insufficient Credit

Your account does not have the required credits to send this message. Rechard your account and try again.

1000

Unknown Error

Your message failed for reasons that are unknown to us and the carriers. Please open a support ticket if you notice too many of these.

Twilio failed and undelivered error codes

When the text message is flagged as Failed or Undelivered, Twilio determines the cause and reports it back to DailyStory where we identify and report it to our customers. See the table below for codes and descriptions.

Error code

Message

Description

21610

Contact has opted out

The contact has opted out of receiving text messages from your account.

21614

Invalid phone number

The contact's phone number is missing or containing extra digits, or containing invalid characters.

30003

Unreachable destination handset

The contact's destination handset is turned off or unavailable.

30004

Message blocked

The contact is blacklisted in your system and, therefore, cannot receive your text messages.

30005

Unknown destination handset

The contact's number is unknown or may no longer exist.

30006

Landline or unreachable carrier

The contact's destination handset may be a landline, VoIP, or a non-mobile system, which cannot receive text messages.

30007

Carrier violation

Your text message failed the upstream carrier's content filtering system.

30008

Unknown error

The error is unknown or cannot be determined.

How did we do?

Replies to Text Messages

Setting up Keywords for Text Message Replies

Contact