SMS Gateway
MMS Gateway
Receiving MMS messages from the MMS Gateway
The MX Telecom MMS Gateway will push received MMS messages by making an HTTP request to a URL provided by you 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. You 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. |
| to1 | The to recipient of this message. This parameter may be repeated if an MMS has several to recipients. |
| date | The time and date that the MMS Gateway received the MMS message. This uses the following format, where Z represents the UTC offset:
yyyy-MM-dd HH:mm:ss Z. Example: 2010-08-21 17:32:21 +0000. |
| type | 2 - MMS 6 - SMS |
| *network | Network (if known). Required for messages to Short Codes. 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 you choose 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 |
|---|---|
| cc1 | The cc recipient of this MMS message. |
| subject | The subject of the MMS message. |
| mms.zip | Zipped MMS contents. |
| expiry | The date at which the MMS message will no longer be available. |
1 this parameter may be repeated if the MMS message has several cc recipients.
| HTTP | HTTPS (SSL) |
http://mms.openmarket.com/mms/v1/http/retrieve | https://mms.openmarket.com/mms/v1/http/retrieve |
You 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.openmarket.com/mms/v1/http/retrieve?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 MMS Gateway
Your 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.
