Sending an MMS Notification using HTTP
Overview
This page describes how to send an MMS notification through the SMS Gateway. For information about integrating with the SMS Gateway, see either Sending a Single SMS or Broadcasting an SMS.
How an MMS notification is displayed to an end user is dependent on the mobile phone. For example, some mobile phones may clip or not show the address of the sender (specified by the mms_from parameter). Depending on the mobile phone's settings, once a mobile phone has received an MMS notification it may automatically download the MMS content or just notify the end user.
MMS Notifications are sent as binary data to the network. Each binary SMS message has a character limit of up to 140 characters before the message must be split. The character length of the following parameters are included in the character limits:
mms_messagelocation mms_transaction_id mms_from mms_subject
To ensure that the MMS Notification does not require multiple SMS messages, make these parameters as short as reasonably possible.
You can use the MX Telecom MMS Gateway to send and receive MMS messages directly. For more information, see MMS Gateway.
Sending an MMS notification
| Single-recipient end points: |
http://sms.openmarket.com/sms/v1/send https://sms.openmarket.com/sms/v1/send |
| Broadcast end points: (HTTP POST only) |
http://sms.openmarket.com/sms/v1/bulksend https://sms.openmarket.com/sms/v1/bulksend |
Example single-recipient request:
http://sms.openmarket.com/sms/v1/send?This sends an MMS notification to the MSISDN 447700900750. The mms_messagelocation parameter tells the mobile phone to collect the MMS content from http://example.com/123456. The mms_expire parameter sets the message to expire after 24 hours.
Mandatory parameters:
| Parameter | Description | |
| user | The SMS Gateway account you are sending the message through. | |
| pass | The password for the SMS Gateway account. | |
| smsto | The MSISDN of the message recipient in international format (e.g. 447700900750). No leading "+" is required.
If you are sending a broadcast SMS request, separate each MSISDN with a line break (e.g. smsto=447700900750%0A447700900765%0A447700900999). | |
| smsfrom | Either a phone number (up to 16 digits) or an alphanumeric string encoded in the
Modified Latin-9 character set (up to 11 characters). This parameter is
mandatory for bulk services in all regions accept the US. Regulatory requirements means that you cannot change the originator for Premium Rate SMS messages in any region. In these instances, the originator is always your service's Short Code. If you do set the originator, the SMS Gateway will ignore the value. | |
| mms_expire | The length of time, in minutes, that the message will be available. Setting an expiry time ensures that you do not need to host content indefinitely. However, individual mobile phones may ignore this value and may use another expiry value. There is no defined maximum value for this parameter. The minimum value is 1 (1 minute). | |
| mms_messageclass | The "message class", as per the MMS specification. This enables some mobile phones to filter messages based on their class (for example, to ignore any MMS notification where class=81). There is currently no specific regulatory requirements for setting the MMS message type. | |
| 80 | Personal | |
| 81 | Advertisement | |
| 82 | Informational | |
| 83 | Auto | |
| mms_messagelocation | The URI of the location hosting the MMS content. This must start with http://. For maximum compatibility with different mobile phones, do not use HTTPS. | |
| mms_messagesize | The full size of message in bytes. This is passed to the mobile phone so that it can display the file size to the end user before they download the file. The mobile phone should not reject the message if this size is not exactly the same as the file itself. | |
| mms_notification | This identifies to the SMS Gateway that the request is for an MMS Notification. You must set this to 1. | |
| mms_transaction_id | A unique ID generated by your platform to identify the notification request when the mobile phone retrieves the MMS content. This ensures that the platform can deliver dynamic content for each MMS notification sent. This can be an alphanumeric string. | |
| mms_version | Specifies the MMS specification version number. Currently there is only one version supported, version 1.0. You must set this parameter to 1.0. | |
Optional parameters specific to this request type:
| Parameter | Description | |
| mms_from | Sets an originator for the MMS notification that is displayed to the end user
before the MMS message is downloaded. You can set this to any value; however, long
values may be clipped by the mobile phone. Some mobile phones may not show this value at all.
The value can be a number or email address, in one of these formats: +447700900999/TYPE=PLMN 58870/TYPE=PLMN yourbusiness@example.comSome mobile phones may overwrite this with the value of the smsfrom field delivered with the MMS content. Default: no default |
|
| mms_subject | The subject line displayed to the end user for the MMS notification. This can be an
alphanumeric string.
Default: no default | |
Optional parameters you can use for any request type:
- submitid: used to send broadcast SMS messages
- report: sets the delivery reports you want for the message
- response: (for single-recipient requests only) changes the format of the HTTP response from the SMS Gateway
- note, subaccount: optional reporting notes that you can add to the request
- vp, billingsingleshot: alters the validity period and billing for the SMS message
- purpose: (US only) adds message purpose details required by Verizon for Premium Rate services
- optin1, optin1ts, optin2, optin2ts: (US only) adds opt-in details required by T-Mobile US for Premium Rate services
