Delivery Report Receiving Interface using HTTP

Overview

The MX Telecom SMS Server allows SMS Delivery Reports to be received using HTTP. This page details the format of the HTTP requests which are send by the MX Telecom SMS Server to allow the receipt of SMS delivery Reports by external software systems.

If messages are sent with delivery reports enabled (and the networks concerned support reports) then delivery reports will be added to the online billing system automatically.

Contents

• Receiving a delivery report using HTTP
• Message format
• Response to the server
• Security considerations

Receiving a delivery report using HTTP

If a sending account has an HTTP (or HTTPS) URL associated with it then the MX Telecom SMS Server will push SMS delivery reports back to the application.

Message format

The paramaters are the same as for the HTTP SMS Receiving interface:

Parameter	Description
smsto	This should be ignored by the customer
smsfrom	The number that was used as smsto in the message that triggered the report
smsdate	The timestamp of the delivery report. Format: yyyy-MM-dd HH:mm:ss
smsmsg	Defined below

However the smsmsg field will be of the format:

REPORT <SENDID> <STATUS>

The values above are defined in the following table:

Parameter	Description
<SENDID>	The smsid returned when the message was sent
<STATUS>	Delivery status of the message, defined below

Delivery report status codes are explained here.

For example:

https://server.com/drpt.cgi?smsfrom=447931123456&smsmsg=REPORT+17218733+DELIVERED&
  smsto=913&shortcode=913&smsid=17221293&smsdate=2002-04-30+21%3A58%3A00 

Response to the server

The customer's server should respond with an HTTP 200 response with a non-empty body. This response must be given in a timely manner (sub 10 seconds) currently we do not abandon a request (waiting for the HTTP response) until 60 seconds have passed but this might be reduced in future.

Security considerations

To ensure the authenticity of the HTTP requests you should only accept requests from the following MX Telecom IP addresses:

• 83.166.68.0/23 (ie 68.0 -> 69.255)

The HTTP endpoint can be an HTTPS (SSL) URL to protect the data whilst in transit.

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 0845 666 7778, or via email at sales@mxtelecom.com.