{"id":1711,"date":"2022-08-16T13:09:41","date_gmt":"2022-08-16T13:09:41","guid":{"rendered":"https:\/\/thesmsworks.co.uk\/blog\/?p=1711"},"modified":"2024-02-05T11:55:09","modified_gmt":"2024-02-05T11:55:09","slug":"sms-delivery-reports","status":"publish","type":"post","link":"https:\/\/thesmsworks.co.uk\/blog\/sms-delivery-reports\/","title":{"rendered":"SMS delivery reports – a complete guide"},"content":{"rendered":"\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t\t
\n\t\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t\t\t

<\/p>\n

SMS delivery reports – a complete guide<\/h1>\n

Delivery reports for SMS always cause confusion.<\/p>\n

We receive far more supports requests on delivery reports than any other subject.<\/p>\n

Let’s see if we can clarify what they’re all about.<\/p>\n

This won’t take long…<\/p>\n

What is an SMS delivery report?<\/strong><\/span><\/h2>\n

<\/p>\n

An SMS delivery report or DLR is a notification that you receive from the SMCS (Short Message Service Center) that lets you know the status of a text message that you sent to a mobile phone.<\/p>\n

<\/p>\n

The outgoing message does a virtual handshake with the receiving phone and allows you to confirm that the message has arrived on the recipient\u2019s phone.<\/p>\n

<\/p>\n

Unlike email where you can see if an email has been read, there\u2019s no way of knowing the text message has actually been read, only that it has arrived in the person\u2019s SMS inbox.<\/p>\n

\"How<\/p>\n

<\/p>\n

How do SMS delivery reports work?<\/strong><\/span><\/h2>\n

<\/p>\n

As soon as a text message is received by a mobile network it will attempt to deliver it to the relevant network that the mobile number is assigned to.<\/p>\n

<\/p>\n

Before the message has been delivered, the delivery report status will be pending.<\/p>\n

<\/p>\n

Once the text has been successfully received the SMCS provides a \u2018delivered\u2019 delivery report which is updated as the message status.<\/p>\n

<\/p>\n

If the message is undelivered then the message status is updated accordingly. If the text has been sent using an SMS provider\u2019s SMS API<\/strong>, then the reason for failure will also be logged as an error code.<\/p>\n

<\/p>\n

Are SMS delivery reports reliable?<\/strong><\/span><\/h2>\n

<\/p>\n

Broadly speaking, yes, delivery reports are pretty reliable. Certainly if you\u2019re sending messages to UK mobiles you can depend on the SMS delivery report being accurate.<\/p>\n

<\/p>\n

The only time to be wary is if you make the mistake of using an indirect grey route<\/a><\/strong> for sending your messages.<\/p>\n

<\/p>\n

You may then find that delivery receipts are either missing or inaccurate. Sometimes you will receive a delivered outcome for messages that you know were not delivered to the phones.<\/p>\n

<\/p>\n

Inaccurate or missing delivery reports is one of the main reasons for avoiding SMS grey routes.<\/p>\n

<\/p>\n

There are many common reasons why a text message might not be delivered<\/a><\/strong>, the most obvious being a wrong number.<\/p>\n

<\/p>\n

Delays to text messages<\/a><\/strong> are also quite common.<\/p>\n

<\/p>\n

How do I know if an SMS was delivered?<\/span><\/h2>\n

<\/p>\n

The process for switching on delivery notifications is slightly different depending on whether you\u2019re an IOS of Android user.<\/p>\n

<\/p>\n

You need to give permission for others to receive delivery reports.<\/p>\n

<\/p>\n

Switching on delivery reports for Android<\/span><\/h2>\n

<\/p>\n

From the Home screen, tap Messages
Tap More (top right)
Tap Settings
Select Text messages.
Tap Delivery Reports On or Off<\/p>\n

\"Android<\/p>\n

<\/p>\n

\n
Here’s a brief video on how to change the delivery report settings for Android<\/a><\/strong>.<\/div>\n
\u00a0<\/div>\n<\/figure>\n

Switching on delivery reports for\u00a0iPhone<\/span><\/h2>\n

If you\u2019re using an iphone, delivery or read receipts are switched off by default. As a user you decide whether you would like others to be notified if you have read their texts.<\/p>\n

<\/p>\n

To change read receipts on an iphone..<\/p>\n

<\/p>\n

Go to Settings<\/strong>
Scroll to Messages<\/strong>
Scroll to Send read Receipts<\/strong> and toggle it on.<\/p>\n

\"IPhone<\/p>\n

<\/p>\n

Can you turn off delivery reports for SMS?<\/strong><\/span><\/h2>\n

<\/p>\n

Yes, you can easily switch off delivery notifications. By default these are always switched off anyway, so unless you\u2019ve switched them on you don\u2019t need to change anything.<\/p>\n

<\/p>\n

See above for the process of switching delivery reports on and off for Android and IOS phones.<\/p>\n

<\/p>\n

Business SMS delivery reports<\/strong><\/h2>\n

<\/p>\n

When you\u2019re using a business SMS service, delivery reports come with far more detail than those you receive when sending from one phone to another.<\/p>\n

<\/p>\n

There are a vast number of different delivery outcomes that can give you enormous detail on the status of every single message that you send.<\/p>\n

<\/p>\n

For example, at The SMS Works, we provide a total of 16 different delivery reports error codes<\/a><\/strong>.
There are 2 different types of delivery report status.<\/p>\n

<\/p>\n

Permanent<\/strong>
This outcome indicates that the message can never be delivered to the number that you sent to. Further attempts will also result in a failed outcome.<\/p>\n

<\/p>\n

For example, error 5001 indicates that the number does not exist on any network or had not been assigned to anyone.<\/p>\n

<\/p>\n

Repeated sending to the same number won\u2019t change that.<\/p>\n

<\/p>\n

Non-permanent<\/strong>
Other delivery report codes are temporary. For example, error code 5015 means that the message expired before it could be delivered. This usually means that the person\u2019s phone is switched off and the message couldn\u2019t be delivered.<\/p>\n

<\/p>\n

Most networks try to deliver a text for about 2 days before it expires.<\/p>\n

\"Business<\/p>\n

<\/p>\n

The SMS Works failed SMS delivery report codes<\/strong><\/span><\/h2>\n

<\/p>\n

\n\n\n\n\n\n\n\n\n\n\n\n\n\n
5001<\/td>\nHandset Error: Number does not exist or has not been assigned to a user.<\/td>\ntrue<\/td>\n<\/tr>\n
5004<\/td>\nMessage has been sent to the operator but the request was rejected, or a delivery report with status REJECTED was reverted.<\/td>\ntrue<\/td>\n<\/tr>\n
5006<\/td>\nHandset Error: No response. Handset may be switched off or in a low signal area.<\/td>\ntrue<\/td>\n<\/tr>\n
5008<\/td>\nHandset Error: Roaming not allowed.<\/td>\ntrue<\/td>\n<\/tr>\n
5009<\/td>\nMessage has been sent to the operator, but has failed to deliver, since a delivery report with status UNDELIVERED was reverted from the operator.<\/td>\ntrue<\/td>\n<\/tr>\n
5010<\/td>\nMessage has been received and rejected due to the user being subscribed to DND (Do Not Disturb) services, disabling any service traffic to their number.<\/td>\ntrue<\/td>\n<\/tr>\n
5011<\/td>\nThe subscriber’s mobile service has been suspended by the operator.<\/td>\ntrue<\/td>\n<\/tr>\n
5013<\/td>\nHandset Error: Device is set to Do Not Disturb (DND). In this instance the message may still be delivered if the DND setting is removed within the validity period of the message.<\/td>\nfalse<\/td>\n<\/tr>\n
5015<\/td>\nThe message was received and sent to the operator. However, it has been pending until the validity period has expired, or the operator returned EXPIRED status in the meantime.<\/td>\nfalse<\/td>\n<\/tr>\n
5020<\/td>\nMessage has been rejected due to an anti-flooding mechanism<\/a><\/strong>. By default, a single number can only receive 20 varied messages and 6 identical messages per hour.<\/td>\ntrue<\/td>\n<\/tr>\n
5034<\/td>\nHandset Error: System failure.<\/td>\ntrue<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n

<\/p>\n

What are the SMS delivery status codes and what do they mean?<\/span><\/strong><\/h2>\n

The following table breaks down each of the industry standard delivery status values that you may encounter.<\/span><\/p>\n

\u00a0<\/b><\/p>\n

\n<\/colgroup>\n\n\n\n\n\n\n\n\n
\n

Status<\/span><\/p>\n<\/td>\n

\n

Description<\/span><\/p>\n<\/td>\n<\/tr>\n

\n

SCHEDULED<\/span><\/p>\n<\/td>\n

\n

The message has been accepted by the platform and is scheduled for delivery to the relevant mobile network<\/a><\/strong> at the time you have specified. It has not yet been sent by us.<\/span><\/p>\n<\/td>\n<\/tr>\n

\n

SENT<\/span><\/p>\n<\/td>\n

\n

The message has been validated and sent to the mobile network for delivery. This does not mean it has been delivered, as we are yet to receive any delivery status notification. This is the default status that we set, once messages leave our platform, but does not indicate or imply that the message has been delivered. Messages will remain in a SENT state until we get a further update from the network. You don\u2019t need to take any more action at this time.<\/span><\/p>\n<\/td>\n<\/tr>\n

\n

DELIVERED<\/span><\/p>\n<\/td>\n

\n

The message has been delivered successfully. All is well with this one.<\/span><\/p>\n<\/td>\n<\/tr>\n

\n

UNDELIVERABLE<\/span><\/p>\n<\/td>\n

\n

The message was accepted by the mobile network but cannot be delivered. The network has discarded this message and will not attempt to redeliver it. There are a variety of reasons why SMS messages may not be delivered. We provide a simplified set of error codes and categories that help you to understand why a particular message is undeliverable and decide on next steps.<\/span><\/p>\n<\/td>\n<\/tr>\n

\n

EXPIRED<\/span><\/p>\n<\/td>\n

\n

By default, we ask the mobile networks to continue to retry delivery of messages over a 48 hour period. If this expiry time is reached without either the message being delivered or a permanent error returned (when the message will be marked as UNDELIVERABLE) you\u2019ll receive a delivery report with an EXPIRED status<\/a><\/strong>. You can reduce the expiry time by using the \u2018validity\u2019 parameter in our SMS API to set the number of minutes before an EXPIRED status is returned.<\/span><\/p>\n<\/td>\n<\/tr>\n

\n

REJECTED<\/span><\/p>\n<\/td>\n

\n

If the mobile network does not accept the message you\u2019ll receive a delivery report with a status of REJECTED. There can be several reasons for messages being<\/strong> rejected<\/a>, such as the number in question no longer being assigned to a handset.<\/span><\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n

<\/p>\n

Why does the status of a delivery report change?<\/span><\/h2>\n

<\/p>\n

Where you have an non-permanent delivery report status like SENT, this outcome will be updated to DELIVERED when the message is actually delivered to the handset. Non-permanent delivery outcomes can change when a new status replaces it.<\/p>\n

<\/p>\n

How long does it take for SMS delivery notifications to be updated?<\/h2>\n

<\/p>\n

New updates are received and updated in real time. So as soon as a new delivery report status is received, the delivery report outcome is updated.<\/p>\n

<\/p>\n

What\u2019s the difference between a delivery report and a DLR?<\/h2>\n

<\/p>\n

Delivery report and DLR are exactly the same thing. DLR is simply an abbreviation.<\/p>\n

<\/p>\n

Accessing SMS delivery reports<\/h2>\n

<\/p>\n

At the SMS Works, we provide 3 ways that you can view, download and access your delivery reports.<\/p>\n

<\/p>\n

1 Login to your account<\/strong><\/p>\n

<\/p>\n

Having logged in to your account, go to Delivery Reports. Here you\u2019ll see the last 1000 messages along with the delivery outcome.<\/p>\n

You\u2019ll also see the mobile number, what you used as the sender ID<\/strong> and the number of credits used to send the message.<\/p>\n

<\/p>\n

\"view<\/p>\n

<\/p>\n

By clicking on the eye icon you can view detailed information on any of the messages.<\/p>\n

<\/p>\n

\"detailed<\/p>\n

The delivery report will also indicate whether our AI SMS shortener<\/a> <\/strong>has been used to reduce the number of characters used to send the message.<\/p>\n

\"SMS<\/p>\n

The number of credit used and saved will also be show,<\/p>\n

<\/p>\n

2 Custom delivery report export<\/strong><\/p>\n

<\/p>\n

You can also choose to export export delivery reports for a given date range or other criteria that you can set.<\/p>\n

<\/p>\n

\"select<\/p>\n

<\/p>\n

3. SMS delivery reports sent to a webhook<\/strong><\/p>\n

<\/p>\n

We will make an HTTP POST for each delivery report to the URL end-point that you specify on your account page. You will need to write code to handle these reports, if you wish to do so automatically.<\/p>\n

<\/p>\n

To set the URL, login to your account and go to Profile and then webhooks. Here you can set the URL to which you want delivery reports to be posted.<\/p>\n

<\/p>\n

\"setting<\/p>\n

You can also set up delivery report monitoring alarms<\/a><\/strong>. This tool will send you an email notification if your webhook for forwarding delivery reports fails or is unresponsive.<\/p>\n

It’s a powerful safeguarding tool to ensure that delivery reports are forwarded to your systems as expected.<\/p>\n

If you would like a visualisation of your delivery reports without getting lost in data, our SMS insights tool will help. It’s an SMS analytics platform<\/a><\/strong> that provides a number of charts and tables to help you understand your SMS activity.<\/p>\n

It’s free to all customers.<\/p>\n

<\/p>\n

Delivery reports and sending to international phone numbers<\/h2>\n

<\/p>\n

In the UK, mobile networks handle delivery reports in the same way and they are typically very reliable indeed.<\/p>\n

<\/p>\n

It\u2019s very rare for a delivery report to be missing, incomplete or inaccurate.<\/p>\n

<\/p>\n

International networks are often not nearly as reliable in providing accurate delivery reports. SMS providers can only pass on the information that they receive from the networks and if there is missing or incorrect data, there isn\u2019t much that the SMS company can do to resolve it.<\/p>\n

<\/p>\n

This is worth bearing in mind if your SMS campaigns send significant amounts of international SMS traffic<\/strong>.<\/p>\n

<\/p>\n

Calculating the SMS delivery rate with DLR reports<\/h2>\n

\"calculating<\/p>\n

<\/p>\n

The average non-delivered rate for business SMS traffic in the UK is 11.2%.
This figure is surprisingly high and is mainly due to companies not keeping their SMS data as clean as possible.<\/p>\n

<\/p>\n

Often dead numbers are retained in the database or the number format might be completely wrong.(Numbers are too short, too long or contain non-numeric values.)<\/p>\n

<\/p>\n

Delivery reports allow you to calculate the non-delivered rate for all your SMS activity.<\/p>\n

<\/p>\n

It’s a simple calculation.<\/p>\n

<\/p>\n

\"SMS<\/p>\n

<\/p>\n

How can you use delivery report data to improve mobile phone quality data?<\/h2>\n

<\/p>\n

SMS delivery reports are an extremely valuable resource to help you improve the quality of your customer data.<\/p>\n

<\/p>\n

There\u2019s no point in sending messages to bad numbers.<\/p>\n

<\/p>\n

If some of your mobile numbers are incorrect then you\u2019re not communicating effectively and the response rates to your campaigns will be suppressed. Worse still, your customers will not be receiving vital information.<\/p>\n

<\/p>\n

Data cleansing and improvement can be a painstaking task.<\/p>\n

<\/p>\n

The best way to tackle it is to be systematic and stick to a process.<\/p>\n

There is no magic solution and every organisation will need to tackle it in their own way.<\/p>\n

<\/p>\n

Firstly download your SMS delivery reports for the past month and identify all numbers that have an undelivered outcome.<\/p>\n

<\/p>\n

Match these individual numbers against your customer data and identify email addresses for each customer.<\/p>\n

<\/p>\n

Add the email addresses to the delivery report.<\/p>\n

<\/p>\n

You can then do a merged email asking customers to update their mobile number. The correct number can then be allocated to the record, ready for the next SMS campaign.<\/p>\n

If you need to clean your database before sending your text campaign, you could use an HLR lookup service<\/a><\/strong> which checks the number is active without actually sending a text.<\/p>\n

<\/p>\n

Are SMS delivery reports free?<\/h2>\n

<\/p>\n

Delivery reports are free, there is no additional charge for them.<\/p>\n

<\/p>\n

How long are delivery reports retained?<\/h2>\n

<\/p>\n

Most SMS providers retain delivery reports for 90 days, then they are archived. This is due to the fact that SMS delivery reports create huge file sizes.<\/p>\n

<\/p>\n

If your organisation has a specific SMS data retention policy<\/a> we can work with you to put this in place.<\/p>\n

<\/p>\n

SMS delivery reports, data security and persona data<\/h2>\n

\"data<\/p>\n

<\/p>\n

Sometimes you may wish to delete delivery reports and all personal data as soon as the message has been successfully delivered.<\/p>\n

<\/p>\n

Many organisation have strict personal data policies that require personal data, including SMS DLR reports to be deleted immediately.<\/p>\n

<\/p>\n

To allow this, The SMS Works have a TTL (time to live) parameter<\/strong> that allows you to specify a set number of minutes, after which the delivery report will be permanently deleted.<\/p>\n

<\/p>\n

This does of course mean that you won\u2019t be able to refer to the delivery reports at a later date.<\/p>\n

<\/p>\n

<\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/section>\n\t\t\t\t<\/div>\n\t\t","protected":false},"excerpt":{"rendered":"

SMS delivery reports – a complete guide Delivery reports for SMS always cause confusion. We receive far more supports requests […]<\/p>\n","protected":false},"author":1,"featured_media":2297,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","ast-disable-related-posts":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"default","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"footnotes":""},"categories":[1],"tags":[],"class_list":["post-1711","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-uncategorized"],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/thesmsworks.co.uk\/blog\/wp-json\/wp\/v2\/posts\/1711","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/thesmsworks.co.uk\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/thesmsworks.co.uk\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/thesmsworks.co.uk\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/thesmsworks.co.uk\/blog\/wp-json\/wp\/v2\/comments?post=1711"}],"version-history":[{"count":0,"href":"https:\/\/thesmsworks.co.uk\/blog\/wp-json\/wp\/v2\/posts\/1711\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/thesmsworks.co.uk\/blog\/wp-json\/wp\/v2\/media\/2297"}],"wp:attachment":[{"href":"https:\/\/thesmsworks.co.uk\/blog\/wp-json\/wp\/v2\/media?parent=1711"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/thesmsworks.co.uk\/blog\/wp-json\/wp\/v2\/categories?post=1711"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/thesmsworks.co.uk\/blog\/wp-json\/wp\/v2\/tags?post=1711"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}