INDEX

Introduction

……………………………………………………………………………………………………2

Messaging

………………………………………………………………………………………………………………2

Reports

… …………………………………………………………………………………………………………………4

Detailed description

…………………………………………………………………………… 4

Examples

…………………………………………………………………………………………………………………7

Contact Details

……………………………………………………………………………………………8

Copyright © 2003. Sisrb Technologies Pvt Ltd, All rights reserved.

Telephone: 91-40-55254296 Email: contactus@smscountry.com

Page 1 of 8

1. Introduction

This document is dedicated for users who wish to use SISRB gateway for sending SMS messages. The gateway can be accessed by

HTTP protocol by submitting values to the API Server.

SISRB Gateway can be accessed by HTTP protocol and submitting the values by POST method to the Server. Accessing gateway through HTTP protocol is one of the best and the fastest ways to deliver SMS messages. The SISRB Gateway can be used to send various types of SMS messages including Normal text messages,

Unicode messages, ring tones, logos and picture messages. This document gives a detailed explanation of using the gateway through HTTP protocol.

2. Messaging

2.1 Single Messaging

To send a Single message of any type (Normal text messages,

Unicode messages, ring tones, logos and picture messages) through SISRB Gateway, the gateway requires parameters described in Table 1.1 for authentication purpose. An Optional IP validation feature is available for security of clients who access the gateway via a Global Static IP .

For sending a single SMS message the following SISRB Gateway URL needs to be accessed with the required parameters. http://www.smscountry.com:81/SMSCwebservice.asp?User=xxxxxx&passwd=xxxxxxxxxxxx& mobilenumber=xxxxxxxxxx&message=xxxxxxxxx&sid=xxxxxxxx&mtype=N

Copyright © 2003. Sisrb Technologies Pvt Ltd, All rights reserved.

Telephone: 91-40-55254296 Email: contactus@smscountry.com

Page 2 of 8

2.2 Bulk Messaging

For sending Bulk SMS messages the following SISRB Gateway URL needs to be accessed with the required parameters http://www.smscountry.com:81/SMSCwebservice.asp?User=xxxxxx&passwd=xxxxxxxxxxxmo bilenumber=xxxxxxx,xxxxxxx,xxxxxxxxx&message=xxxxxxxxx&sid=xxxxxxxx&mtype=N

Same procedure can be followed to send Normal text messages,

Unicode messages, ring tones, logos and picture messages as mentioned in the single messaging.

Following table gives a detailed explanation of parameters required for sending message through SISRB Gateway

Table 1.1

S.No Parameter Name Parameter

Value

Parameter Description

1

2

3

User

Passwd sid

TestUser

TestPassword

Smscountry

User name of the account

Password of the account

Name of the caller

4

5 mobilenumber message

6 mtype

* Type of message mobile number Destination mobile number

TestMessage Message to be send

N * Type of message

mtype ->N (Normal Text )

mtype ->U (Unicode (e.g.-Arabic) )

mtype ->R (Ring tone/Logo/Picture)

Note: The Description for message parameter in detail is given at 5.0

Copyright © 2003. Sisrb Technologies Pvt Ltd, All rights reserved.

Telephone: 91-40-55254296 Email: contactus@smscountry.com

Page 3 of 8

3.0 Reports:

Table 1.2 describes the response from the SISRB gateway

Table1.2

S.No

1

2

Status

Message not send

Response

Message send Successfully Success;<Message Id>

Invalid user

3.1 Message Delivery Reports

SISRB provides the facility to generate Delivery Reports of the messages sent.

The user would be given a CDR Report in the form of a CSV/ Excel sheet containing delivery status of the messages sent during a period.

3.2 Customer Status Report

To user can check their Account Status (Credits Purchased,

Credits Available, etc.) online using the following URL. http://www.smscountry.com

:81 and log in user name and password to access the reports.

4.0 Detailed description

Username: - user

The username will be provided to the client at the time of account Creation for sending SMS messages through SISRB Gateway.

Copyright © 2003. Sisrb Technologies Pvt Ltd, All rights reserved.

Telephone: 91-40-55254296 Email: contactus@smscountry.com

Page 4 of 8

The user parameter cannot be more than 20 characters long and can only contain alphabets and numbers, with no spaces.

Password: - passwd

The password will be provided to the client along with username at the time of account Creation for sending SMS messages through

SISRB Gateway. The passwd parameter cannot be more than 20 characters long and can only contain alphabets and numbers, with no spaces.

Sender Id/Name Of Sender: - sid

The called parameter refers to the alphanumeric Id of the

Sender. The Called parameter can be a maximum of 15 characters only. It can either be an alphanumeric string or an

International Number.

Mobile Number: - mobilenumber

The Calling parameter refers to the destination mobile number to which the message is to be sent. Any error in this parameter value would lead to non-delivery of the message. The mobile number should contain only numbers. It must also include the country code at the start beginning. It should not contain any symbols like "+", etc. and it must be a Valid Mobile number of the Networks supported by the SISRB Gateway.

Message: - msg

The msg parameter refers to the actual message that is to be sent to the destination mobile number. The format of the message differs depending on the type of message being sent.

For simple text messages, the message can contain numbers, alphabets, spaces and certain special characters. The message can contain a maximum of 160 characters, including spaces.

Copyright © 2003. Sisrb Technologies Pvt Ltd, All rights reserved.

Telephone: 91-40-55254296 Email: contactus@smscountry.com

Page 5 of 8

In case of Unicode messaging, the message can contain only numbers in the form of Unicode digits. Further, it can be a maximum of 69 characters i.e. 69 x 4 Unicode digits for each character that means 276 digits.

In case of Binary messaging, the message can contain only valid

8-bit data string. The binary message can be a maximum of 140 characters only, one SMS. However, Ring tones, logos and

Pictures that exceed one SMS can also be sent.

2

3

4

5

The message parameter may consist of up to 160 characters belonging to the following set:

A …. Z a …. z 0 .... 9

Blank space

Due to restrictions in the HTTP protocol format, the following special characters must be encoded in order not to collide with reserved HTTP characters:

S.No.

1

Character

&

+

%

#

=

Hexa-decimal Encoded String

%26

%2B

%25

%23

%3D

User Defined Header: binmess

The binmess parameter refers to the user-defined header while sending binary messages such as Ring tones, Logos and Picture messages. The binmess parameter must be a valid 8-bit binary data string.

Message Type: - mtype

Message Type is to identify the type of message being sent. The default value of message type is N, which refers to Normal text message. It is on the basis of this parameter that the SISRB

Copyright © 2003. Sisrb Technologies Pvt Ltd, All rights reserved.

Telephone: 91-40-55254296 Email: contactus@smscountry.com

Page 6 of 8

Gateway classifies the type of messages to be sent and pushes it accordingly. For details refer table 1.1

Mtype

N

Description

Normal Text Message

U

R

Unicode Message

Ringtone, Picture, Logo

6. Examples

1. SMS containing normal text message

http://www.smscountry.com:81/SMSCwebservice.asp?User=wworks&passwd=5hdshj3&mobile number=9198356272,91944362623,91985352323&message=testingsmscountry&sid=wworks& mtype=N

2.

SMS containing Unicode message

(UCS-2)

To support European languages with characters not included in default GSM 7-bit character set

Eg. for sending Arabic Message http://www.smscountry.com:81/SMSCwebservice.asp?User=wworks&passwd=5hdshj3&mobile number=9198356272&message=062A06450020062A0633062C064A064406430020062806460

62C0627062D00200641064A0020062E062F06450629002006310633062706260644002006270

64406470627062A064100

3.

SMS containing 8-bit binary data (e.g. for Ring tone/Logo)

Eg. for sending Ring Tone http://www.smscountry.com:81/SMSCwebservice.asp?User=wworks&passwd=5hdshj3&mobile number=9198356272&binmess=%06%05%04%15%81%00%00&message=%02J%3Ai%1D%B

D%B1%91%19%A5%B9%9D%95%C8%04%00%25%18%C5%12a%06%19av%10%81%98%

11%81%16%12%81&sid=wworks&mtype=R

Copyright © 2003. Sisrb Technologies Pvt Ltd, All rights reserved.

Telephone: 91-40-55254296 Email: contactus@smscountry.com

Page 7 of 8

Contact Details

Address:

SISRB TECHNOLOGIES PVT LTD

8-3-214/23, 2nd floor, Srinivasa colony (west), Hyderabad - 500038, Andhra Pradesh, India

Telephone : 91-40-55254296

Fax. : 91-40-55254297

Email: contactus@smscountry.com

pooja@smscountry.com

Copyright © 2003. Sisrb Technologies Pvt Ltd, All rights reserved.

Telephone: 91-40-55254296 Email: contactus@smscountry.com

Page 8 of 8