S M A R T D A T A

With the Bulk SMS API, you can integrate your systems to automatically leverage on the instant delivery of SMS to generate receipts, alerts and relevant communications to your clients and customers.

Bulk SMS API Codes:


As a developer, the following two methods will greatly assist you to implement this service to your systems

GET PARAMS:

  • apikey : Valide API KEY. Get this by clicking the button “GET API KEY & PARTNER ID” in your account.
  • partnerID : Valid Partner ID. Get this by clicking the button “GET API KEY & PARTNER ID” in your account.
  • message : URL Encoded Text Message with valid GSM7 Characters
  • shortcode : Valid Sender ID / Shortcode
  • mobile : Valid Mobile Number

POST is the HTTP method that is designed to send loads of data to a server from a specified resource. Most common HTML forms on the web operate using this request method.

At Smart Data , we’ll walk with you help you to achieve your desired success. Our methodology includes but is not limited to:

  • User requirement interviews to understand the end-use experience better
  • Reviewing your social media presence, technology, tools and resources used
  • Delivering the reviews on strict deadline basis
  • Providing clear, actionable recommendations
  • Helping you actively re-purposing content into different marketing channels to get maximum economic value from your investment on content.

This HTTP API  supports the below things.

  • Supporting bulk sms sendings
  • Supporting all languages with special characters (English, Gujarati, Arabic, Greek etc) Supporting concatenated messages (long SMS)  Supports text and Unicode messages.
  • Scheduling SMS
  • Dynamic sender identity URL:

You will call the below URL using POST or GET method.

http://sms.smartd.co.ke/sendsms.jsp?

Please find the below parameters for above URL request:

Compulsory Parameter Description 

  • user = userid of the Smart data analytical ltd account
  • password = valid password of above user
  • mobiles = comma separated mobile number on which message will be deliver (ex.

           ,254XXXXXXXX) 

  • sms= sms text which you want to send to your customer (ex. Dear Valued Client)

Optional Parameter Description  

  1. Clientsmsid = pass unique sms serial no (ex. 311) which will get the same send id in response.
  2. Groupname = group name which you have created in application. If you want to send sms to particular group contacts then specify group name which you have made in application
  3. Senderid = sender id. If you pass sender id as a blank so it will take defaul sender id which is assigned in your account.
  4. Scheduletime = If you want to schedule the sms specify date & time in yyyy-mm-dd hh:mm:ss format
  5. Unicode =If you want to send unicode sms pass value 1. If you do not provide it will take 0 mean non-unicode.
  6. Isallowduplicatemobile = if you want to allow duplicate mobile pass value = yes . If you do not provide it will not allow duplicate mobiles.
  1. Version = For multiple mobile number with comma(,) seperated, pass version greater than 1.1 otherwise you will not able to send to multiple number  TESTING ACCOUNT DETAILS

Username :  Smartdatademo PasswordSmart254

Sender ID : SmartData

The Above account details can be used on the codes below by editing and adding the username and password. 

Example to call HTTP API:

http://sms.smartd.co.ke/sendsms.jsp?

user=username&password=password&mobiles=254XXXXXXXX&sms=msgbody&unicode=1&clien

tsmsid=10001&groupname=any_xyz&senderid= SmartData &scheduletime=2020-04-19 12:12:12

<smslist>

<sms>

          <smsclientid>0</smsclientid>

                 <messageid>2001318955</messageid> </sms>

          </smslist>

//For Multiple Mobile Entry with version parameter.

<smslist>

<error>

           <smsclientid>0</smsclientid>

                      <error-code>-10018</error-code>

                                <error-description>Duplicate Mobile</error-description>

                                             <mobile-no>8888888888</mobile-no>

                                  <error-action>1</error-action>

                         </error>

 <sms>

                 <smsclientid>1</smsclientid>

          <messageid>2001318954</messageid>

</sms>

 <sms>

             <smsclientid>0</smsclientid>

               <messageid>2001318955</messageid> </sms>

</smslist>

You will call the below URL using POST method.

http://sms.smartd.co.ke/sendsms.jsp?

For bulk SMS sending make the xml in the below format and post to above URL.

<?xml version=’1.0′?> 

<smslist> 

<sms> 

             <user>userid</user> 

                     <password>password</password> 

                              <message>message content</message> 

                                       <mobiles>254XXXXXXXX</mobiles> 

                                                 <senderid>SmartData</senderid> 

                                       <cdmasenderid>254XXXXXXXX</cdmasenderid> 

                            <clientsmsid>0</clientsmsid> 

                       <accountusagetypeid>1</accountusagetypeid>

                 <unicode>1</unicode> 

         <isallowduplicatemobile>yes</isallowduplicatemobile>

 </sms> 


<sms> 

             <user>userid</user> 

                   <password>password</password> 

                            <message>message content</message> 

                                    <mobiles>254XXXXXXXX</mobiles> 

                                              <senderid>SmartData</senderid> 

                                                    <cdmasenderid>254XXXXXXXX</cdmasenderid> 

                                           <clientsmsid>0</clientsmsid> 

                                    <accountusagetypeid>1</accountusagetypeid> 

                             <unicode>1</unicode>

                <isallowduplicatemobile>yes</isallowduplicatemobile>

          </sms>

     </smslist> 

Compulsory Parameter Description 

  • user = userid of the Smart data analytical .ltd account
  • password = valid password of above user
  • mobiles = mobile number on which message will be delivered (ex. 254XXXXXXXX)
  • message= sms text which you want to send to your customer (ex. Test message) 5) clientsmsid = pass unique sms serial no (ex. 311) 

Optional Parameter Description  

  • Unicode = 0 or 1. 0 mean normal message and 1 mean unicode message
  • Group = Name of the group created in Smart data analytical .ltd application. If you want to send sms to all contacts which are falling under this group then specify group name
  • Senderid = sender id. If you pass sender id as a blank it will take defaul sender id which is assigned in Smart data analytical .ltd account.
  • Cdmasenderid = cdma mobile number accountusagetypeid=If your account type is service sms then pass 1 and if your account type is promotional then pass 0.
  • Accountusagetypeid = If your account type is service sms then pass 1 and if your account type is promotional then pass 0.
  • Isallowduplicatemobile = if you want to allow duplicate mobile pass value = yes . If you do not provide it will not allow duplicate mobiles. This parameter will be checked only in first xml node and what ever value will be there it will consider for all other SMS.

Response For above both format:

You will receive below XML response if Message is Successfully Sent.  

<?xml version=”1.0″ encoding=”iso-8859-1″ ?> 

         <smslist>

             <sms>

             <smsclientid>0</smsclientid>

             <messageid>2001318955</messageid>

            </sms> </smslist>

You will receive below XML response if Message is not successfully sent.  

<smslist>

         <error>

                <smsclientid>0</smsclientid>

                 <error-code>-10018</error-code>

                 <error-description>Duplicate Mobile</error-description>

                  <mobile-no>254XXXXXXXX</mobile-no>

                  <error-action>1</error-action>

        </error>

<smslist>

*You will receive below XML response from bunch of message a few are sent and others are not sent .

<smslist>

<sms>

<smsclientid>0</smsclientid>

<messageid>2001318955</messageid> </sms>

<error>

<smsclientid>1</smsclientid>

<error-code>-10018</error-code>

<error-description>Duplicate Mobile</error-description>

<mobile-no>254XXXXXXXX</mobile-no>

<error-action>1</error-action>

</error> <sms>

<smsclientid>2</smsclientid>

<messageid>2001318956</messageid> </sms>

<smslist>

Here is also a list of common error responses if SMS not sent successfully.
  1. <sms>

                <messageid>-1</messageid> 

           </sms> 

  1. <sms>

           <error>

                            <error-code>-10007</error-code>

                             <error-description>Invalid Group</error-description>

                       <error-action>1</error-action>

           </error>

          </sms>

  1. <sms>

          <error>

                            <error-code>-10006</error-code>

                             <error-description>Enter mobile no or Select group</error-description> <erroraction>1</error-action>

           </error>

         </sms>

  1. <sms>

               <error>

                      <error-code>-10005</error-code>

                              <error-description>Invalid Sender ID</error-description>

                                 <error-action>1</error-action>

                  </error>

               </sms>

  1. <sms>

                  <error>

                         <error-code>-10004</error-code>

                              <error-description>Unknown</error-description>

                      <error-action>0</error-action>

                  </error>

                  </sms>

  1. <sms>

                   <error>

                            <error-code>-10003</error-code>

                            <error-description>Invalid Mobile</error-description>

                             <error-action>0</error-action>

                     </error>

    </sms>

  1. <sms>

          <error>

                <error-code>-10002</error-code>

                <error-description>Invalid Username Or Password</error-description> <error-action>1</error-action>

         </error>

           </sms>

  1. <sms>

              <error>

                               <error-code>-10001</error-code>

                                 <error-description>Limit Exceed</error-description>

                                   <error-action>1</error-action>

              </error>

        </sms>

  1. <sms>

              <error>

                               <error-code>-1111</error-code>

                              <error-description>VersionNotSupported</error-description>

                               <error-action>1   </error-action>

             </error> </sms>

 

© 2020 Smart Data Analytical Limited. All rights reserved.
Proudly made in Kenya

Contact Us

 

Call us at :  0722 569 968

0722 572 853

Email: info@smartd.co.ke

Our Offices