wireless solutions for a wired world

Receiving reports using HTTP

The MX Telecom MMS Server will push reports by making an HTTP GET request to an URL to be provided by the customer to indicate the receipt of an MMS message.

Request format

On receipt of an MMS or SMS message we will make an request to your server, using the parameters included in the table below (note that if Alice sends Bob an MMS, the delivery report will be from Bob to Alice):

Parameter Description
id Unique MX Telecom id for this report
requestid Id of the MMS that this report describes
to The sender of the original message
from The recipient of the original message
date Format: yyyy-MM-dd HH:mm:ssZ (Z is UTC offset, eg +0100)
type
  1. Delivery report
  2. Read report
status
  1. Buffered - a delivery attempt has been made which failed
  2. Indeterminate delivery
  3. Delivered
  4. Delivery expired
  5. Rejected
  6. Forwarded
  7. Read
  8. Deleted
  9. Indeterminate read
  10. Expired read

Note that as an MMS may have several recipients, if Alice sends an MMS to Bob and Carol, two delivery reports will be sent, one from Bob to Alice, and another from Carol to Alice.

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 1-877-MXTELECOM (+1 877 698 3532), or via email at sales@mxtelecom.com.