SMS Push Service

Introduction

Departments can use SMS Push Service, to send the SMS notifications to the citizens. Following is the integration process.

Integration Step by Step

Step 1: Account Creation

The department needs to first create the account on the SMS Gateway. Following fields are required for account creation:

• User Name (use alphabets and numbers only, max of 15 chars)
• Password (use alphabets and numbers only, min of 8 & max of 15 chars)
• Mobile Number (for verification and alerts)
• Alternate Mobile Number (for alert messages)
• Email-ID (for verification and alerts)
• Sender ID (maximum up to 6 characters)
• Organisation/Department Name
• Address
• Project details where this service will be used

Please send these details to msdp(at)cdac(dot)in.After the account is created from your end, C-DAC will review and approve the account. Subsequently, we will share the next steps along with the required documentation and provide some SMS credits for testing purposes.

Step 2: How to access the Service?

These are the following two ways to use the SMS Gateway service.

Method One: Log in to https://services.mgov.gov.in and send the sms manually.

The department's user can login with the credentials which is provided when the account for the department is created.
The user can then do the following on this portal.

• Send Quick SMS
• Send Group SMS
• Send Bulk SMS using an Excel file (same or different content)
• View delivery reports

Method Two: Send SMS Programmatically

The department's application can send SMS's using the HTTP interface of SMS Gateway provided by MSDG.

Appendix

1. HTTP API Documentation

HTTP API lets departments send across SMS messages using HTTP URL interface. The API supports SMS push (Single SMS and Bulk SMS).

Terms and definitions

Sender ID: Sender ID or CLI (Caller Line Identification) is limited to 6 characters in the API and will be correlated with the respective department. According to TRAI regulations, there will be a 2 character prefix when delivered to the phone. For example, if you are passing the Sender ID as "ABCDEF", you will see the SMS delivered as AD-ABCDEF or TA-ABCDEF according to the route SMS Gateway chooses.

Message Length: If the message is in English, up to 160 characters per SMS are supported. If the message is in a Unicode language, up to 70 characters per SMS are supported.

Using the HTTP URL for sending messages

The end point of the service is https://msdgweb.mgov.gov.in/esms/sendsmsrequestDLT.
This Service is only available on HTTP POST.

Parameter Definitions

Parameter	Description
username	Specify the username provided
password	Password attached to the username
content	The SMS Text you want to submit
senderid	The Sender ID for this SMS. 6 characters for SMS as per new TRAI regulations. Also note senderid is not the email-id.
mobileno	The set of mobile numbers to broadcast the above SMS content. You can pass 10 or 12 digit mobile numbers in comma separated format. Eg : 9895123456,9847123456,919809123456
key	Mandatory
templateid	The Template ID must be obtained from the telecom operator and should be between 12 to 19 digits
smsservicetype	Select the SMS service type from the documentation based on the type of SMS you want to send.

API Response Codes

Response Code	Meaning
401	Credentials Error, may be invalid username or password
402, X	X messages submitted successfully
403	Credits not available
404	Internal Database Error
405	Internal Networking Error
406	Invalid or Duplicate numbers
407,408	Network Error on SMSC
409	SMSC response timed out, message will be submitted
410	Internal Limit Exceeded, Contact support
411, 412	Sender ID not approved.
413	Suspect Spam, we do not accept these messages.
414	Rejected by various reasons by the operator such as DND, SPAM etc
415	Secure Key not available
416	Hash doesn't match
417	otpmsg method contains only single number
418	Daily Limit Exceeded