Delivery Reports

Overview

Delivery reports provide feedback to applications concerning the delivery of MT messages. This information can include:

Confirmation of successful billing for premium messages
Confirmation of successful delivery to the handset (where this is supported by the carrier)
Details of errors which prevented successful delivery

Enabling receipt of delivery reports
Interpreting delivery reports
Delivery report type
Detailed reason code

Enabling receipt of delivery reports

In order to receive delivery reports, two steps are necessary. Firstly, delivery reports must be requested when the corresponding MT message is submitted to the MX Telecom SMS Gateway:

HTTP interface: via the report parameter. See the HTTP Interface documentation for more details.
SMPP interface: via the registered_delivery parameter in the DELIVER_SM PDU.

Secondly, delivery reports must be routed to an HTTP URL of your choosing or via your SMPP connection. This routing is configured on a per-account basis; please contact us to have this routing configured or altered.

Interpreting delivery reports

A delivery report contains the following:

The message-ID (smsid) of the MT message to which it pertains.
A date, giving the time at which the delivery event occured.
A delivery report type code giving an overview of the delivery status of the message.
A detailed reason code, giving further information on the reason for the delivery report.

Delivery report type

The delivery report type code is one of "DELIVERED", "FAILED", "BUFFERED" or "REJECTED". This will correspond to the Type nibble in the detailed reason code. See here for more details on the meaning of each code.

Detailed reason code

The detailed reason code is a 4-byte integer value. It can be interpreted as explained here.

About MX Telecom

MX Telecom is a leader in wireless technology. MX Telecom offers an easily accessible gateway to data, voice and video messaging services including 2-way and premium SMS, multimedia messaging, interactive voice response, location-based services, video short codes, Internet and TV related solutions.

For more information, MX Telecom can be reached on 1-877-MXTELECOM (+1 877 698 3532), or via email at sales@mxtelecom.com.