FEBNO SMS -SOAP Interface

This document provides the technical details of the SOAP based SMS API for the FEBNO SMS Engine Suite. This API is provided for customers to use any standard software development application to send SMS Messages through the Gateway. This protocol is best suited for offline application who wishes to send messages by calling the function each time.

How to Use the API

Any standard software development tool can be used to use the SOAP API. The following are the steps required to send a message.

Consume the web service in your application using the WSDL file (downloadable from the URL)

Using the reference added to the application call the method for calling the function

Pass the Parameters to the function and call the method

Check the status of the message delivery and retrieve the message reference

User Validation

User validation is done using the user id and password provided to the SOAP function

Programming Details

a) Send MessageParameters

MobileNumber

MessageText

Unicode

User ID

Password (Encrypted)

The Web service Link: http://febnosms.com/InContactSOAP/SubmitSoap.asmx

This method provides applications to send text messages in English and Arabic. A message id is returned by the function for the application to check the status of delivery.

Response String :

<?xmlversion='1.0'encoding='utf­8'?><SMS><SMSREF>110130133403</SMSREF><Status>OK</Status></SMS>

Return string includes a message reference number and the status. b) Query The Status of the Message

Parameters

▪ Message Queue ID

With the message id returned by the sent function the status of the message submitted can be queried. The result will be Pending, Success or Failed

Response String :

<?xmlversion='1.0'encoding='utf­8'?><SMS><Status>S</Status><Error></Error></SMS>

The status includesS – SentF-FailedP-Pending