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='utf8'?><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='utf8'?><SMS><Status>S</Status><Error></Error></SMS>
The status includesS – SentF-FailedP-Pending