Académique Documents
Professionnel Documents
Culture Documents
Overview
NIC Messaging Division has set up new SMS Gateway services. In order to integrate your application
and to access different services like reports and statistics please refer to below steps.
PARAMETERS VALUES
User Name
Password
Sender Id
Allowed Ip
Using the below mentioned URLs you can send SMS. For old accounts, authentication credentials and
sender id have been already provided. Please use the same credentials.
Using the above URL you can send English messages to any mobile subscribers. Currently, we
support maximum of 6000 characters for plain text messages.
PARAMETERS DESCRIPTION
Username It is an accountid which will be provided by SMS Platform during account creation.
Pin It is a password which will be provided by the SMS platform during the account creation.
Mnumber It is mobile number with country code.
Message It is a SMS text content.
Signature It is sender id or from address which will be configured by SMS platform during account
creation.
http://smsgw.sms.gov.in/failsafe/HttpLink?username=XXXXXX&pin=XXXX&message=<FEFF092
A093009400915094D09370923002009380902092609470936 >&mnumber=mobilenumber
&signature=<senderid>&msgType=UC
Using the above URL the user can send messages in any language to any mobile subscribers.
In the field of message in the above Url the user has to type the message in the format mentioned in
the above example. As a result the mobile subscriber will receive the message in their handset
as( ).Currently, we support maximum of 6000 characters for Unicode messages.
PARAMETERS DESCRIPTION
username It is an accountid which will be provided by SMS Platform during account creation.
pin It is a password which will be provided by the SMS platform during the account creation.
mnumber It is mobile number with country code.
message It is a SMS text content.
signature It is sender id or from address which will be configured by SMS platform during account
creation.
msgType Message type , here it will UC
o Flash Message
http://smsgw.sms.gov.in/failsafe/HttpLink?username=XXXXX&pin=XXXXX&message=
messagetext&mnumber=mobilenumber&signature=<sender id>&msgType=FL
PARAMETERS DESCRIPTION
username It is an accountid which will be provided by SMS Platform during account creation.
Pin It is a password which will be provided by the SMS platform during the account creation.
mnumber It is mobile number with country code.
message It is a SMS text content.
signature It is sender id or from address which will be configured by SMS platform during account
creation.
o Port Message
http://smsgw.sms.gov.in/failsafe/HttpLink?username=XXXXX&pin=XXXXX&message=
messagetext&mnumber=mobilenumber&signature=<sender id>&msgType=SP&port=XXXXXX
PARAMETERS DESCRIPTION
username It is an accountid which will be provided by SMS Platform during account creation.
Pin It is a password which will be provided by the SMS platform during the account creation.
mnumber It is mobile number with country code.
message It is a SMS text content.
signature It is sender id or from address which will be configured by SMS platform during account
creation.
msgType Message type , here it will SP
port It is a port number to which port the message should be delivered
HTTP API Parameters: Below are the API parameters which are being used for SMS Services.
Sample Responses:
Real Time Delivery Reports: In order to receive delivery reports to the client URL directly, below are
the steps:
1. The clients should share the HTTP Query string interface URL to NIC SMS gateway to handover the
operator ACK and DNs.
2. Following is the expected query string URL format,
http://IP:PORT/app-context?a2wackid=<a2wi-cknowledgement-id>&a2wstatus=<a2wi-
status>&carrierstatus=<carrier-status>&lastutime=<yymmddHHmm>&custref=<customer-referece-
id>&submitdt=<yymmddHHmm>&mnumber=<mobileno>
3. Clients should share the URL response OK to validate the successful handover
4. Below are the parameters:
S No. Parameter Description
1 a2wackid Acknowledgement id got from NIC SMS GATEWAY while submitting the
message to NIC SMS GATEWAY platform
2 a2wstatus NIC SMS GATEWAY ACK/DN status
3 carrierstatus Operator ACK/DN status
4 lastutime Operator Last Attempt time (in the format of yyMMddHHmm; here yy years
in two digit format, MM months in two digit format, dd days in two digit
format, HH Hours in 24 hour format, mm minutes in two digit format)
5 custref Customer reference id at time message submit
6 submitdt Message submitted date (in the format of yyMMddHHmm; here yy years in
two digit format, MM months in two digit format, dd days in two digit
format, HH Hours in 24 hour format, mm minutes in two digit format)
7 mnumber Mobile number
8 Sts Operator submitted Timestamp date (in the format of yyMMddHHmm; here yy
years in two digit format, MM months in two digit format, dd days in two
digit format, HH Hours in 24 hour format, mm minutes in two digit format)
9 Msg Message, first 20 characters
10 Acode Account code (User Name)
11 Senderid Senderid
NOTE
User Name is the account Id which will be provided by the SMS platform during the period of
account creation.
Pin will also be provided by the SMS platform. It is a secret password which will be authenticated
through LDAP.
Sender ID will be provided by the SMS platform. This will be used across the entire messaging. No
other sender id can be used to push messages.
http://sms.gov.in/
Using the above URL user can login using login credentials provided by the SMS platform during the
account creation and send SMS to any mobile subscribers. It enables users to create groups and upload file of
mobile numbers and send message in bulk. The GUI login credentials and LDAP credentials are same.
http://reports.sms.gov.in
Using the above URL the user can view the summary and detailed account transaction reports. The GUI
login credentials and LDAP credentials are same.
TROUBLE SHOOTING
NOTE: To use any services, please share the IP of the server/client which you wish to use for SMS
services.
The below mentioned steps are for users trouble shooting if any problem occurs in the connectivity:
1. Ping Command:
a. Click on Start Button
b. Go to Run menu option
c. Type CMD and press enter
d. Command prompt will open
e. Type Ping smsgw.sms.gov.in or Ping 164.100.14.211
f. If output comes like
3. Outgoing IP
In case, user is receiving error like below:
This error means that user machines outgoing IP is not whitelisted at the NIC SMS gateway. To know
the outgoing IP, below is the test to be performed:
URL: http://smsgw.sms.gov.in/findip.jsp
Copy the above URL and paste the same in any web browser and press enter key. In return, user will
gets the outgoing IP on the web browser itself. Both IPs (shared with NIC to be whitelisted and IP on
the browser) should match. In case IPs are different, please contact your system administrator.
In case user is not having a Web Browser on the server and Operating System is Linux, use the
following command:
4. Encoding Values
Some users application does not accept any special characters in password so, that particular special
character must be encoded with their respective values. The below mentioned are the encoding values
of special character.