Using the SMS Gateway API, Automating Delivery Report Collection
Posted on May 26th, 2009 by Nick.
Categories: All SMS Gateway Documentation, Documentation, Technical
This blog post has been superseded with our website documentation
Introduction
If you are using the API / Gateway to send bulk SMS you can collect your delivery reports from the server, which is a good way of removing bad numbers from your data.
Delivery Reports and the API
It is important to understand the difference between getting a “failure” (or success) message at the API/Gateway and a delivery report. The HTTP GET response from the gateway only confirms that the number and message appear to be in the correct format this does not mean that the number exists. Delivery reports confirm to you what has actually happened to the message, the following outcomes are possible: “DELIVERED”,”REJECTED”,”FAILED” and no report at all.
- “REJECTED” means that the message was rejected by the relevant operator and did not attempt to deliver it.
- “FAILED” probably means that the number does exist (or at least not anymore).
- “DELIVERED” message received on the handset.
Occasionally we don’t received a delivery report at all, this can be down to a failure at the operator end due to high load or other problems.
Delivery Report Collection Methods
Method 1
See our RESTful services which offer a comprehensive and simplified method to collect your delivery reports. We recommend that you use this approach.
Method 2
Push notification. We can push the delivery reports via a GET request to a url of your choice. Just log into your account and go to “settings” => “api settings” .
| Parameter | Data Type | Info |
| id | INT | the unique message id |
| delivered_date | UNIX TIME STAMP | approximate time the message was delivered |
| processed_date | UNIX TIME STAMP | our processing date |
| status | DELIVERED | FAILED (STRING) | the outcome of the message report |
| msisdn | INT | the mobile number of the recipient |
Popularity: 7%
Related posts:
- SMS Gateway API – Specification
This blog post has been superseded with our website documentation It is recommended that you use the RESTful version of the API which has largely superseded this document... - How to use an SMS Gateway
Our SMS Gateway is extremely powerful indeed. It allows companies to connect to our systems and send out messages 1... - How to integrate our SMS Gateway API into your systems
Introduction Adding SMS as a communication method to a system is often very useful, for instance you don’t have issues... - Is there such a thing as ‘quality’ in Bulk SMS?
There are a vast number of different gateways that bulk sms service providers can use to connect to the UK... - Text Marketer short code / txtUs API options
Introduction The keyword on your system (on short code 88802) or your txtUs number can be used to “route” incoming...
