Send messages seamlessly!

Integrate our API with your applicated and take over ther control

Messaging API

Messaging API

SMS Api lets you integrated your application with our platform so that you can send and receive messages on without the use of our Web GUI. We are constantly updating our API to give you most of out of our platform, so keep do visit this page frequently.

Communiaction

Making a Request
Our Messaging API only accepts HTTP Post calls. POST Data is accepted in REST format like key1=value1&key2&value2 pairs, where value fiels are URL Encoded. All key fields are case sensitive
Response
You will receive an HTTP 200 response in case the communication was established successfully, non 200 respone is received in case of communication of server failur.
Once the script is executed, you will recieve a respone and JSON format. All API endpoint will send Status key in the JSON string, in case of success, its value will be OK, API will send NOK in case of an error.
if the Status is "NOK" then response will have Reason key that will have the description of error
Authentication
You need to authenticate your request by sending USERNAME and PASSWORD keys in your API request. Your USERNAME is your email address, whereas your PASSWORD is the API Token that you can that you can find out here.
API Token

Send Message

Endpoint
https://www.hostedbots.com/sm/API/SMSPlus.php
Parameters
To send message, you need to send following parameters
  • TO_MSISDNMandatory parameter, Recipient’s Mobile number in E.164 Format. You can add multiple number separating they by comma (,), or if you have a contact list you can add List name like LIST_1,LIST_2 etc
    e.g. TO_MSISDN=61412345678
    or
    TO_MSISDN=61412345678,61412345679
    or
    TO_MSISDN=LIST_3
  • FROM_MSISDN Optional field to send the SMS only from this number. This number should be in E.164 format. You can only use the parameter if you have purchased a dedicated number and want to send SMS from that number if no sending number is provided , random number will be chosen to send the SMS
  • MESSAGEMessage body to be sent
  • USERNAMEYour email address.
  • PASSWORDYour API Token
  • SEND_ATOptional parameter. Timestamp(AEDT) when the message needs to be sent, if this parameter is not provided, message will be sent at once. This parameter should be sent in this format YYYY-MM-DD HH:MM:SS
    e.g.
    SEND_AT=2017-12-28 13:56:28
Response
If a non 200 response is sent, it means, our platform was unable to process the request and generate a response of its own. Whenever hosted bots Platform process a request it will send a 200 response and JSON Object that conatins description of the response

Cancel Message

If the SMS Send request was sent with parameter “SEND_AT”, it can be cancelled provided the scheduled time is not more than 5 minutes away from cancel request time.
Endpoint
https://www.hostedbots.com/sm/API/Cancel.php
Parameters
  • MESSAGE_ID ID of the message request that you want to cancel.
  • USERNAMEYour email address.
  • PASSWORDYour API Token
Response
If a non 200 response is sent, it means, our platform was unable to process the request and generate a response of its own. Whenever hosted bots Platform process a request it will send a 200 response and JSON Object that conatins description of the response