SMS Gateway
MMS Gateway
Receiving reports using HTTP
The MX Telecom MMS Server will push reports by making an HTTP GET request to a URL provided by you 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 |
|
| status |
|
| *useragent | A description of the recipient's handset (if known) |
Optional parameters are marked with a *
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
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.
