Menu

HTTP Api Specification

1. Send Single SMS

2. Send Interactive Whats App Message

1. Send Single SMS

https://api-msg4.sathyainfo.com/sms.aspx?apikey=xxx&tmpid=aaaa&sid=xxxx&sno=98940&to=989403&msg=Test

Parameter Name, Value and Description

Parameter

Description

apikey

User Msg4 Account Api key

sid

Sender Id of the message

sno

Sender No of the message

to

Destination Mobile Number

msg

Message to be sent.

tmpid

DLT Template Id

Response: The customer would get following response values for sending messages.
Inputs Return values : <STATUS>OK</STATUS><MESSAGE>SMS SENT</MESSAGE>

Message parameters in details

a. User Email (email)

The user email parameter value is passed for authentication purposes. The user email (email) parameter cannot be more than 50 characters long and can only contain alphabets and numbers, with no spaces.

b. Password (pw)

The password parameter value is also passed in combination with the username for authentication purposes. The password (pw) parameter cannot have more than 50 characters and can contain only alphabets and numbers, with no spaces.

c. Mobile Number (to)

The mobile number parameter refers to the destination mobile number to which the message is to be sent. However, the mobile number is required to be in a specific format. 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 (+) or 00 etc.

d. Message Parameter (msg)

The message parameter refers to the actual message that is to be sent to the destination mobile (msg). The behavior of the message parameter differs depending on the type of message being sent. The message parameter may consist of up to 160 characters belonging to the following set:

· A…Z a…z 0…9
· Blank space
· The meta characters \ (line feed)

Due to restrictions in the HTTP protocol format, the following special characters must be encoded in order not to collide with reserved HTTP characters: Character must be encoded as:
Character Hexa‐decimal Encoded String

& %26
+ %2B
% %25
# %23
= %3D

For simple text messages, the message can contain numbers, alphabets, spaces and certain special characters. However, the message can contain a maximum of 160 characters, including spaces. In case of Unicode messaging, the message can contain only numbers in the form of Unicode digits. Further, it can be a maximum of 70 characters i.e. 70 x 4 Unicode digits for each character = 280 digits. In case of binary messaging, the message can contain only valid 8‐bit data string. The binary message can be maximum of 140 characters only (i.e. one SMS). However, Ring tones, operator logos & Pictures that exceed one SMS can also be sent in form of concatenated SMS.

e. Sender Id (sid)

The sender Id parameter refers to the message dispatcher or from clause (THE SENDER), from whom the message is sent. The sender Id cans either be a valid international number up to fifteen characters long or an eleven character alphanumeric string.