Receiving MMS messages using HTTP

The MX Telecom MMS Server will push received MMS messages by making an HTTP request to an URL to be provided by the customer to indicate the receipt of an MMS message. This request can either be in the form of an HTTP GET request, in which case a url will be provided to indicate where the MMS may be retrieved from, or as a Multipart HTTP POST request, where the mms itself is included in the request. The customer may choose which of these two formats is used.

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:

Parameter	Description
id	Unique MX Telecom id for this message
from	Originator of the message
to¹	The `to` recipient of this message. This parameter may be repeated if an MMS has several `to` recipients.
date	Format: yyyy-MM-dd HH:mm:ss
type	2 - MMS 6 - SMS
*network	Network (if known). Required for messages to shortcodes, click here for a table of network codes.

Note that optional parameters are marked with a *

MMS contents

The MMS contents will be presented as a zip file. If the customer chooses to use Multipart POST, this file will be included as part of the request named mms.zip. The MMS specific parameters are listed below:

Parameter	Description
cc¹	The `cc` recipient of this mms
subject	The subject of the mms
mms.zip	Zipped MMS contents
expiry	The date at which the MMS message will no longer be available

¹ this parameter may be repeated if the MMS message has several cc recipients.

HTTP	HTTPS (SSL)
`http://mms.mxtelecom.com/RetrieveMMS`	`https://mms.mxtelecom.com/RetrieveMMS`

The customer may then download the MMS from either of URLs above, before the expiry date provided (which will be no less than 24 hours). For example :-

http://mms.mxtelecom.com/RetrieveMMS?user=myUsername&pass=myPass&id=messageid

Parameters for retrieval are as below:

Parameter	Description
user	Your inbound account username
pass	Your inbound account password
id	The id supplied in the GET request

SMS contents

Parameter	Description
message	The text of the SMS message

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.