Sending an SMS

Overview

The MX Telecom SMS Server is the most advanced, reliable and easy to use SMS (Short Messaging Service) solution available for any existing mobile phone. It is perfectly suited to both large and small corporate information systems.

The MX Telecom SMS Server provides an easy to use connection between any existing corporate system and a user's mobile phone. It is a complete solution, supplied, implemented and supported by MX Telecom.

Requirements

• UNIX, Linux or Windows NT operating system.
• Ability to send standard Web HTTP GET or HTTP POST requests or send emails.
• Although optional, for extra security reasons, list 3 IP addresses only from which SMS Send requests will be accepted, using your username and password.

Contents

• Installation
• Sending an SMS Text Message using HTTP GET
• Possible HTTP GET responses
• Sending an SMS To Multiple Recipients
• Over-The-Air Provisioning (WAP Configuration)
• WAP Bookmarks
• Ring Tones
• Operator Logos
• Group Graphics
• Picture Messages
• Hex Encoding Logos
• vCard
• vCalendar
• Sending an SMS Text Message using the Session Interface
• Sending User Data Header (UDH)

• Embed HTTP GET requests in scripts and remove "SMS Received"

Installation

The MX Telecom SMS Server requires NO Installation of MX Telecom software. In order to send SMS Text Messages (including 8-Bit Messages) all that is required is a Standard HTTP request or an email sent to the MX Telecom SMS Server. A HTTP request is simply the standard method of requesting a Web page. Our servers interpret this request for a Web page and send out your SMSs.

All the Examples below, can be found here.

Sending an SMS Text Message using HTTP GET:

Simply request the following web page, using your provided username and password:

http://jaguar.mxtelecom.com/servlets/com.wapmx.SMSServer.SMSServerSend?user=<USER>& pass=<PASS>& smsto=<SMS TO>&smsmsg=<SMS MESSAGE>& smsfrom=<SMS FROM>& subaccount=<SUBACCOUNT>& note=<NOTE>& message_class=<MESSAGE CLASS>

eg.

http://jaguar.mxtelecom.com/servlets/com.wapmx.SMSServer.SMSServerSend?user=user &pass=pass& smsto=+447770123456&smsmsg=Test&smsfrom=www.wapMX.com

SMS TO: The mobile phone number of the intended recipient (International Format Only). To send to multiple recipients, simply submit each number separated by a comma.

SMS MESSAGE: The message you wish to send. Standards SMSs can be 160 characters long. If your message is longer than 160 characters then it will be automatically split up into multiple messages.

SMS FROM: This parameter can be sent in numeric (16 characters max) or alphanumeric (11 characters max).

SUBACCOUNT: (Optional) For your own billing purposes, it is possible to specify a Sub-Account. This will be logged automatically in the Live Online Billing System.

NOTE: (Optional) Allows you to parse an optional Note field. This will be logged automatically in the Live Online Billing System.

MESSAGE CLASS: (Optional) 1 = Standard text message, 0 = Flash SMS. To enable delivery reports add 14 to your existing MESSAGE CLASS setting. (eg. 15 for standard SMSs and 14 for Flash SMSs)

Blinking SMSs: Send %01 before and after the text you wish to blink.

Possible HTTP GET responses:

SMS Received. : SMS Received by MX Telecom, and will be delivered to the Mobile Operator

500 Error : General Server Error

Incorrect Login. : Incorrect Username or Password

IP Address 217.169.11.162 is not authorised to access this service. : If IP checking has been enabled, only authorised IP addresses will be able to access your account.

Reverse Billing not allowed for +447970123456. : It is only possible to send Reverse Billing SMSs to users from whom an SMS has been received on to a Short Code or Shared Short Code Keyword. If no SMS has been received from a particular mobile number, then it is not possible to send out a Reverse Billing SMS Text Message to that number. For customers who have multiple Short Codes, it is possible to receive and send out Reverse Billing SMSs on any Short Code, using any combination.

Sending an SMS To Multiple Recipients:

In order to send an SMS to multiple recipients you need to submit each mobile phone number in the "smsto" parameter separated by a comma.

Over-The-Air Provisioning (WAP Configuration)

Nokia 7110, 6210, 6250, 9110i: 

Make a HTTP GET request in the following format to setup Nokia 7110/6210/6250/9110i mobile phones for accessing WAP services:

http://jaguar.mxtelecom.com/servlets/com.wapmx.SMSServer.SMSServerSend? user=<user>&pass =<pass>&smsto=+447770123456&otatype=7110& profile_name=<PROFILENAME>& home_page=<HOME PAGE>& dial_up_number=<DIAL UPNUMBER>&ip_address=<IPADDRESS>& username=<USERNAME>&password=<PASSWORD>& data_call_speed=<DATA CALL SPEED>&data_call_type=<DATA CALL TYPE> &connection_type=<CONNECTION TYPE>& bearer_type=<BEARER TYPE>& authentication_type=<AUTHENTICATION TYPE>

DATA CALL TYPE: ISDN, ANALOGUE.

CONNECTION TYPE: CONT (Continuous), TEMP (Temporary), CONTSEC (Continuous Secure), TEMPSEC (Temporary Secure).

AUTHENTICATION TYPE: PAP (Normal), CHAP (Secure).

BEARER TYPE: DATA.

DATA CALL SPEED: 9600, 14000, AUTOBAUD.

Ericsson R320, R380, T39: 

Make a HTTP GET request in the following format to setup Ericsson R320/R380/T39 mobile phones for accessing WAP services:

http://jaguar.mxtelecom.com/servlets/com.wapmx.SMSServer.SMSServerSend? user=<user>&pass =<pass>&smsto=+447770123456&otatype=R320& profile_name=<PROFILENAME>& home_page=<HOME PAGE>&home_page_title=<HOME PAGE TITLE>& dial_up_number=<DIAL UPNUMBER>&ip_address=<IPADDRESS>& username=<USERNAME>& password=<PASSWORD>& data_call_type=<DATA CALL TYPE>

DATA CALL TYPE: ISDN, ANALOGUE.

WAP Bookmarks

Make a HTTP GET request in the following format to send a WAP Bookmark:

http://jaguar.mxtelecom.com/servlets/com.wapmx.SMSServer.SMSServerSend? user=<user>&pass =<pass>&smsto=+447770123456& wap_bookmark_type=<WAP BOOKMARK TYPE>& wap_bookmark_name=<WAP BOOKMARK NAME>&wap_bookmark_url=<WAP BOOKMARK URL>

WAP BOOKMARK TYPE: 7110 (Nokia 7110 v4.94/6210/6250/9110i), R380 (Ericsson R380).

Ring Tones

Nokia Ring Tones

Nokia Ring Tones must be in RTTTL format. Make a HTTP GET request in the following format to send Ring Tones to compatible mobile phones:

http://jaguar.mxtelecom.com/servlets/com.wapmx.SMSServer.SMSServerSend? user= <user>&pass =<pass>&smsto=+447770123456&rtttl=<RTTTL>& tune_style=<TUNE STYLE>& tune_loop=<TUNE LOOP>

RTTTL: RTTTL ring tone.

TUNE STYLE: N (Normal), C (Continuous), S (Staccato).

TUNE LOOP: 0 - 15 (0 = No loop, 15 = Infinite loop).

Motorola Ring Tones

Motorola Ring Tones can be sent as standard text messages in the smsmsg field. You can use the Motorola Ringer Tone Maker software to create your ringtones.

Operator Logos

Operator logos must be in hex encoded OTB, GIF, BMP or NOL format as created by LogoManager or similar graphics software. They can be up to 72x14 pixels in size. Make a HTTP GET request in the following format to send Operator Logos to compatible mobile phones:

http://jaguar.mxtelecom.com/servlets/com.wapmx.SMSServer.SMSServerSend? user=<user>&pass=<pass>&smsto=+447770123456&logo_type=OPERATOR& img=<IMG>&mobile_operator_code=<MOBILE OPERATOR CODE>

IMG: Hex encoded OTA Binary, GIF, BMP or NOL file.

MOBILE OPERATOR CODE: ID of the destination mobile operator. eg. "32F433" for Orange in the UK. For a list of Mobile Operator Codes, see:
http://www.mxtelecom.com/?m=tech/dosend

Group Graphics

Group Graphics must be in hex encoded OTB, GIF, BMP or NOL format as created by LogoManager or similar graphics software. They can be up to 72x14 pixels in size. Make a HTTP GET request in the following format to send Group Graphics to compatible mobile phones:

http://jaguar.mxtelecom.com/servlets/com.wapmx.SMSServer.SMSServerSend? user=<user>&pass =<pass>&smsto=+447770123456&logo_type=GROUP &img=<IMG>

IMG: Hex encoded OTA Binary, GIF, BMP or NOL file.

Picture Messages

Picture Messages must be in hex encoded OTB, GIF, BMP or NOL format as created by LogoManager or similar graphics software. They can be up to 72x28 pixels in size. They can also include a Text Message sent as part of the Picture Message. Make a HTTP GET request in the following format to send Picture Messages to compatible mobile phones:

http://jaguar.mxtelecom.com/servlets/com.wapmx.SMSServer.SMSServerSend? user=<user>&pass =<pass>&smsto=+447770123456&logo_type=PICTURE& img=<IMG>& img_text=<IMG TEXT>

IMG: Hex encoded OTA Binary, GIF, BMP or NOL file.

IMG TEXT: Text to be displayed along with the Picture Message.

Hex Encoding Logos

Download this Java based application to hex encode your logos. This utility will hex encode all the files in the specified directory. Hex encoded files will be saved with a ".hex" extension.

Usage:

java FileToHex c:\temp

FileToHex.java

FileToHex.class

vCard

Make a HTTP GET request in the following format to send a vCard:

http://jaguar.mxtelecom.com/servlets/com.wapmx.SMSServer.SMSServerSend? user=<user>&pass =<pass>&smsto=+447770123456&vcard_data=<VCARD DATA>

VCARD DATA: See http://www.rfc-editor.org/rfc/rfc2426.txt for the vCard specification. An example of a vCard would be:

BEGIN:VCARD
VERSION:2.1
FN:John Smith
TEL;WORK;VOICE:+442071231234
TEL;MOBILE;VOICE:+447970123456
TEL;HOME;FAX:+442071231235
END:VCARD

vCalendar

Make a HTTP GET request in the following format to send a vCalendar:

http://jaguar.mxtelecom.com/servlets/com.wapmx.SMSServer.SMSServerSend? user=<user>&pass =<pass>&smsto=+447770123456&vcalendar_description= <VCALENDAR DESCRIPTION> &vcalendar_date_start=<VCALENDAR DATE START>&vcalendar_date_end=<VCALENDAR DATE END>
&vcalendar_audio_alarm=<VCALENDAR AUDIO ALARM>

VCALENDAR DATE START: Format = 20001110T113000

VCALENDAR DATE END: Format = 20001110T120000

VCALENDAR AUDIO ALARM: Format = 20001110T110500

Sending an SMS Text Message using Email:

SMS's can also be sent upon the receipt of an email sent to MX Telecom Servers. This can be especially useful for large bulk sending of SMS's. Simply send an email in the following format:

To: sendsms@jaguar.mxtelecom.com
Subject: (Optional)
Body: Send a list of HTTP GET messages as part of the message body of the Email. The HTTP GET messages should be in the same format as described above, with each line containing a whole HTTP GET string (Both for sending Normal and 8-Bit messages). The MX Telecom SMS Server will go through each line, and send each HTTP GET request in order. There is no limit on the number of HTTP GET requests in one email.

Sending an SMS Text Message using the Session Interface:

SMS's can also be sent using a session interface to MX Telecom Servers. This can be useful for large bulk sending of SMS's, where HTTP GET requests are not fast enough.

In order to use the Session Interface you must connect to jaguar.mxtelecom.com on port 4001. You send the requests separated by a carriage return. The requests should be hex encoded as per the HTTP interface. Eg:

user=user&pass=pass&smsto=447970123456&smsmsg=This%20is%20a%20test%202
OK
user=user&pass=pass&smsto=447970123456&smsmsg=test
OK

The server will respond with "OK" if your request was successful. Other possible responses are:

01 Error - Incorrect Username or Password
02 Error - Malformed Request
03 Error - Account Suspended

At the moment, you can send normal text messages, flash SMSs, operator logos, group graphics, picture messages and ringtones via the Session Interface. We intend to support the other types of SMSs in the near future.

Sending User Data Header (UDH):

This is an advanced topic and allows you to have greater control over the content of your SMSs. The smsudh and smsmsg parameters must be hex encoded and the HTTP GET request is as follows:

http://jaguar.mxtelecom.com/servlets/com.wapmx.SMSServer.SMSServerSend? user=<user>&pass =<pass>&smsto=+447770123456&smsudh= <SMS UDH> &smsmsg=<SMS MSG>

Embed HTTP GET requests in scripts and remove "SMS Received":

If you are writing scripts for your Website, then you should not be pointing the user direct to our server. Instead, you should embed the HTTP GET requests within your scripts. Remember that some characters must be URL Encoded. See the following for more information.

Java:

http://java.sun.com/j2se/1.3/docs/api/java/net/URLConnection.html

http://java.sun.com/j2se/1.3/docs/api/java/net/URLEncoder.html

eg:

HttpGet.java

PHP:

http://www.php.net/manual/en/function.fopen.php

http://www.php.net/manual/en/function.urlencode.php

eg:

$msg = urlencode($msg);
$fp = fopen ("http://jaguar.mxtelecom.com/servlets/com.wapmx.SMSServer.SMSServerSend?user=testuser&pass=testpass &smsmsg=$msg&smsto=447970123456", "r");

Active Server Pages:

http://www.asp101.com/samples/http.asp

Perl:

http://www.perldoc.com/perl5.6/lib/URI.html

http://www.perldoc.com/perl5.6/lib/URI/Escape.html

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.