Sending Binary SMS

Sending Binary SMS over HTTP

To send a binary SMS message via a menu driven interface, please see the help section titled Web Menu Interface. This section describes how to send a binary message programmatically via URL parameters.

To send a binary SMS message via HTTP , please refer to the specifications for the particular binary message format that you wish to send, and use the following URL format:

http://127.0.0.1:8800/?PhoneNumber=xxxxxxxx&Data=00112233445566&UDH=060504030201&pid=AA&dcs=AA&binary=1

For 127.0.0.1, please substitute the IP address or host name assigned to your gateway PC. (Note: 127.0.0.1 is a local loop back address that can be utilized when you are connecting to the gateway from the same computer.)

For 8800, please substitute the port number that the gateway is configured to use.

Substitute the phone number that you wish to send the SMS message to for the “xxxxxxxx” in the “PhoneNumber” parameter. Use either the local phone number format, or the international phone number format (your network provider may or may not allow you to send to international phone numbers). If the international phone number format is used, note that you must substitute “%2B” for the “+” character, because of URL escaping restrictions. For example, to send an SMS to +447778001210, use %2B447778001210 instead.

The “Data” parameter should include a string of hexadecimal digits that form the binary data content for the message.

The “UDH” parameter should include a string of hexadecimal digits that form the binary user data header for the message. Common UDH parameter settings include “06050415811581″ for Nokia ring tones, “06050415821582″ for Nokia operator logos, and “06050415831583″ for Nokia CLI logos.

The “pid” parameter is a hexadecimal value between 0 and FF that specifies the GSM 03.40 TP-Protocol-Identifier.

The “dcs” parameter is a hexadecimal value between 0 and FF that specifies the GSM 03.38 SMS Data Coding Scheme. F5 is a common data coding scheme for most binary message formats.

The “binary” parameter should be set to “1″ to tell the gateway that this is a binary message.

An example EMS message which includes a predefined EMS animation and a predefined EMS sound is shown below:

http://127.0.0.1:8800/?phone=xxxxxxxx&udh=080D0200040B020007&data=00&binary=1

Refer to specifications such as “How to Create EMS Services” on the Ericsson developer site, and “Smart Messaging Services” on the Nokia developer site for more information on binary formats for SMS messages.

The gateway includes some HTML forms to simplify the process of creating Nokia smart messages. Those HTML message forms include JavaScript commands that build the binary message parameters for submitting smart messages. Refer to the JavaScript in the corresponding HTML forms and the Nokia “Smart Messaging Services” specification for additional information.

Please note that when a “user data header” is included, the data portion of the SMS message must be encoded in binary format. Text formats cannot be mixed with a user data header.

For a complete list of URL parameters, please refer to the section Submitting SMS Messages – URL Parameters.