Developers Guide

Overview

This User Manual is for the developers and clients who want to integrate their systems with our Bulk SMS service.  The manual contains all the necessary API specifications required for automated SMS sending via the Internet.

Required Environment

Our API requires an Internet enabled system.  The Internet connection may be established:

  • Directly
  • Via a firewall
  • Via proxy server

This server-based mode of communication is extremely simple.  In case of large data transfer and data security requirements, we recommend HTTP POST form, however, both HTTP POST and HTTP GET forms can be used for the service.  URL encoding of all calls to the API is a must and care must be taken that parameter names are case sensitive.

bulk sms software free download
sms software download for pc
Sender ID Options

Every text message has a sender ID.  Any text message sent through API should be sent via a sender ID approved for your account.  In case you need a new sender ID, please connect with us and we would be happy to help you.

Setting a Sender ID (Alphabetic Originator)

Enjoy the flexibility of setting the sender ID based on your company name, or any other parameter relevant to you.  Your chosen name will reflect as the sender to the recipients instead of a phone number.  You may choose a sender ID containing alphabets only.

Supported Character Sets
GSM 03.38 Encoding

A message sent via this service can be written using the standard SMS mobile-phone character set.  160 characters including few of the Roman alphabet, certain special character, the most common accented forms, and few Greek alphabets are allowed in the character set.

The following characters are included:
@ £ \ $ ¥ è é ù ì ò Ç \ n Ø ø \ r Å å ? _ F " ? O ? ? S T ? Æ æ ß É ! \ " # ¤ % & ' ( ) * + , - ../ 0 1 2 3 4 5 6 7 8 9 : ; < = > ? ¡ A B C D E F G H I J K L M N O P Q R S T U V W X Y Z ? Ö Ñ Ü § ¿ a b c d e f g h I j k l m n o p q r s t u v w x y z ö ñ ü à ä Ä { } \ ~ [ ]

Note: In case of extended characters, they will be treated as two characters to send. Extended characters are: £ ¥ è é ù ì ò Ç Ø ø Å å Δ Φ Γ Λ Ω Π Ψ Σ Θ Ξ Æ æ ß É ¤ ¡ Ä Ö Ñ Ü § ¿ ä ö ñ ü à | \ { } ~ [ ] ^ In case of the extended character €, three characters will be consumed.

sms software
sms gateway software

Unicode

In case of non-GSM 03.38 characters, the SMS is transmitted as a Unicode message.  The Unicode character support allows messages to be sent in multiple languages such as Hindi and regional languages like Kannada, Tamil etc.

Transmission of Unicode messages costs double even when sent in plain English.  If you choose the Unicode format, the entire message will have to be sent as a Unicode message.

Message Length - Multipart Messages
Standard GSM 03.38 Character Set

A single text message allows up to 160 characters (including spaces).  In case you wish to send two-part or three-part multipart text messages, the maximum character allowance is 306 (2 x 153) and 459 (3 x 153) characters, respectively.  You can send maximum seven-part multipart messages summing to 1000 character limit. This is applicable only on messages containing the standard GSM 03.38 character set.  The need for user-data headers (UDHs) information limits each multipart text message to 153 characters instead of the usual 160 characters.  The UDH information is used by cell phones to link long messages together so that they appear as a single SMS in recipient’s inbox.

Number of SMS
  1. upto 160 characters
  2. upto 306 characters (2 x 153)
  3. upto 459 characters (3 x 153)
  4. upto 612 characters (4 x 153)
  5. upto 765 characters (5 x 153)
  6. upto 918 characters (6 x 153)
  7. upto 1000 characters (6 x 153) + (1 x 82)

Character
limit for
linked SMS

Bulk sms software
Group sms software
Unicode Characters

Unicode messaging allows a maximum of 70 characters per SMS.  If you wish to send longer messages, our system will split them into two or three separate text messages.  In this case, the maximum lengths of two-part and three-part multipart Unicode text messages will be 134 (2 x 67) and 201 (3 x 67) characters, respectively. You can send maximum 8 multi-part messages with character limit of maximum 500 characters.

Number of SMS

Character
limit for
linked SMS

  1. upto 70 characters
  2. upto 134 characters (2 x 67)
  3. upto 201 characters (3 x 67)
  4. upto 268 characters (4 x 67)
  5. upto 335 characters (5 x 67)
  6. upto 402 characters (6 x 67)
  7. upto 467 characters (7 x 67)
  8. upto 500 characters (7 x 67)+(1x31)