Receive SMS via HTTP (MO) Example

This document will show you how to receive a SMS message (MO).

GET /yoursite.com.au/

When an SMS MO message arrives at the SMS Gateway, it will send the following request to your application.

Example

http://www.yoursite.com.au/SMSfromMobiles?ORIGINATOR=61412345678&RECIPIENT=1987654&PROVIDER=telstra&MESSAGE_TEXT=Hello%20There&KEYWORD=<KEYWORD>

Body

Parameter	Type	Example	Description
originator	integer	12345	The associated shortcode for your service.
recipient	integer	XX7432104492	The recipient you want to send this message to.
provider	string	Telstra	The network you plan to send the SMS message via.
message_text	string	Hello%20There	Your URL encoded message.
keyword	string	mv-100620006	Your unique Mobivate keyword for your service.

Output

{
 "ORIGINATOR": "61412345678",
 "RECIPIENT": "1987654",
 "PROVIDER": "telstra",
 "MESSAGE_TEXT": "Hello%20There",
 "KEYWORD": "<KEYWORD>"
}

Acknowledging MO's

For your endpoint to acknowledge MO's correctly your server needs to respond with a HTTP 200, and a body of either: “0” (ZERO), "OK" or "SUCCESS". To read more about this and see examples, click here.

You need to provide us with the MO destination (URL) before we can provide you with an account credentials. Please contact your account manager.