SMS GATEWAY XML SPECIFICATION v1.0 | LAST UPDATED : 06 DECEMBER 2011
print

Introduction

Channel Mobile allows rapid integration to our SMS gateway. This is facilitated through the use of our Application Programming Interface (SMS API).

Our API describes in detail how to build an XML string containing the SMS data you would like to send. From there it walks you though the process of connecting to our SMS Gateway using a choice of three protocol - HTTP, HTTPS and SMTP.

If you would like to send single or bulk SMS and you require those messages to be automated, or tied to a trigger e.g. SMS alerts on transactions, booking confirmations, responding to customer queries and orders, then our SMS API would provide a seamless solution for your business.

Key Features :
•  Connect to our SMS gateway
•  Send single and bulk SMS
•  Send SMS immediately
•  Schedule SMS for future delivery
•  Manage SMS expiry times for time sensitive messages
•  Handle delivery and status reports
•  Create reply routes
•  Send long messages (+160 characters)
•  Tag data to create billing centres

Audience :
This document is compiled for users familiar with XML.

Quick SMS Send

For a free demonstration account and 10 free credits to test the API connection please contact us on 021 200 5955 or by completing the contact form.

Step 1: Get a Username and Password

Once we have verified your account information, we will provide you with your own unique username and password.

Step 2: Generate XML

Below is XML code to send an immediate SMS

Code Sample

<XML>
   <SENDBATCH delivery_report="1" status_report="1">
      <SMSLIST>
        <SMS_SEND uid="UNIQUE UID" user="USERNAME" password="PASSWORD" to="MSISDN">MESSASGE TEXT</SMS_SEND>
      </SMSLIST>
   </SENDBATCH>
</XML>

Step 3: Connect to Gateway

HTTP
Post the XML to http://sg1.channelmobile.co.za/
Request method: POST
Form-request data name: xmldata

Email
XML can also be sent in the body or as an attachment of an email called "sms.xml" and the attachment content-type should be "text/xml"
Email address: sms@sg.channelmobile.co.za