Bulk SMS API

This Section provides information for Software Developers, System Integrators and Webmasters. Users, who wish to send message-using HTTP (Hyper Text Transfer Protocol) features or develops applications using the SMS Gateway for sending SMS messages. Gateway can be accessed through HTTP protocol by submitting values by GET or POST method.

Sample URL to Submit SMS:

http://sms.arnaventerprises.co.in/smsaspx?ID=XXXX&Pwd=YYYYY&PhNo=919899999999,919898989999&Text=MessageText&ScheduleAt=25/03/2009+04%3A00+PM&TemplateID=<DLT Template ID Received from Telecom operator’s DLT Platform.>

Sample URL to Check Account Balance:

http://sms.arnaventerprises.co.in/smsaspx?ID=XXXX&Pwd=YYYYY

Parameter Name Possible Values / Function
ID Set sms.arnaventerprises.co.in account ID.
Pwd Set sms.arnaventerprises.co.in account Password.
PhNo Comma delimited list of phone numbers (Limit to max 100 Nos. per http invoke.) All numbers must start with Country Code (91 for India) - Message may not get delivered if Country Code is not added to numbers submitted to this HTTP API
Text Actual Message text. Length of single SMS is 160 characters. GSM handsets provides capability to receive long SMS (multi-segment) with each segment being 152 characters and SMS gets reassembled and displayed as single SMS by receiving GSM handset. If SMS contains single Unicode character, complete SMS would be sent as Unicode SMS with 70 chars as single SMS size and 64 chars as segment size in case of multi segment Unicode SMS.
ScheduleAt (Optional) Future Schedule Date and Time (Max 365 days in future) If included, SMS would be scheduled for delivery at a later date time indicated by this parameter. Format: "DD/MM/yyyy hh:mm tt"
SenderID By default, SenderID parameter disabled for all clients. Based on the business agreements with client, this feature can be enabled so that client can set their own SenderID for message delivery. 6 Char alphanumeric SenderID (3 Char routing information would be prefixed to this).
DlrUrl

Set DlrUrl parameter to get back delivery status on HTTP. DlrUrl should also have MsgID set to IDs of sms in your system. When our Server received delivery report from operator, DlrUrl would be invoked by our server by adding status parameter to same DlrUrl (which you have provided along with MsgID at the time of sms submission.).

Example DlrUrl value:

DlrUrl= http://www.mysmswebsite.com/ InBSDlr.aspx?MsgID= (comma-separated IDs of these sms in your system).

Note: For this to work you must have webpage shown above in place. This page will read parameters ‘msgid’ and ‘status’ and update in your database.
msgid SMS ID in your system.
PE (Optional) Principal Entity ID as per Registration of Message sending entities enterprise on telecom operators DLT portal. If user has updated PE ID in his profile and this param is absent in http API, PE ID would be picked up from user’s profile.
TemplateID SMS Template DLT ID as registered under registered header on telecom operator’s DLT Platform.
TM (Optional) Telemarketer’s ID. By default Telemarketer's TM ID would be added. It’s recommended not to provide this parameter without consultation with Team.

Notes:

  1. Passing only 'ID' and 'Pwd' parameters will return your Ac Balance.
  2. Numbers would be paged if 'Text' parameter is absent or blank.
  3. SenderID would be taken from your account Details.

HTTP Response

Response String Interpretation
'UserID, Password is required.' 'ID' and / or 'Pwd' parameters are blank.
'Authentication Failed.' UserID or Password is incorrect.
'Your Account is not active' Account is deactivated.
'Message Submitted' Message to Phone number(s) submitted successfully.
'Insufficient Credit.' Your account does not have sufficient balance to submit SMS batch.

SMS Quick Start Guide

We appreciate your interest in bulk SMS Service. Here are few quick tips which will help you best use SMS services:

User’s Guide – Quick Tips:
  1. Login to your account using your e-mail address as User ID and Password.
  2. You may send bulk sms by separating numbers by comma or return (enter).
  3. List of numbers may be pasted from Excel Sheet Column.
  4. We recommand ideal batch size of 1000 SMS in single submission using Web based Interface. This is to prevent any losses due to poor Internet Connection.
  5. Length of single SMS is 160 characters.
  6. GSM handsets provides capability to receive long sms (multi-segment) with each segment being 152 characters and sms gets re-assembled and displayed as single sms by reciving GSM handset.
  7. Some CDMA handsets doesn’t support multi-segment SMS and your long message may be displayed as separate message at receiving hand set.
  8. Sending single long sms will deduct your account by corresponding number of sms as displayed below sms text box on Send SMS screen.
  9. If sms contains single Unicode character, complete sms would be sent as Unicode sms with 70 chars as single sms size and 64 chars as segment size in case of multi segment Unicode sms.
  10. Alphabetic SenderID will be sent in the header of sms sent to the numbers.
  11. Windows or Web based interface filters invalid numbers at the user interface level and doesn’t send sms to number having insufficient digits.
  12. Scheduled SMS would be scheduled for Delivery within 10 minutes of your Scheduled Time, if your account has required balance to submit the complete batch.