|
|
Documentation SMS-2-Web module
When your customer sends an SMS to a short code settled by us, we call a URL on your server. This URL has been indicated in the Wizard by you.
The URL registered by you will be reached by us with the following parameters by means of HTTP GET:
| Variable |
Description |
Format |
| MO_MessageId |
Operator message ID |
Numerical |
| ShortCode |
SMS Shortcode |
Numerical |
| MO_ShortKey |
Sub keyword or keyword |
Alphanumeric |
| Message |
Message |
Alphanumeric |
| SendTo |
Sender's phone number |
Numerical |
| operator |
Operator code |
Alphanumeric |
Important!
In some scripting languages (e.g. PHP) variable names are case-sensitive. Please pay attention to the spelling mentioned above!
Example: in PHP $_GET["MO_MessageID"] is different from $_GET["mo_messageid"].
Explanation per variable:
- MO_MessageId
The unique ID of a message. This ID must be sent along with the answer to the message. If you store the MO messages in a database table, it is advisable to check first, whether or not the MO_Message ID already exists. See also the remarks at the bottom of this document.
- ShortCode
The SMS shortcode of the incoming message, e.g. 3010.
- MO_ShortKey
The keyword for your service.
- Message
The complete message of the customer. This may contain a maximum of 160 characters and the following characters [a-z,A-Z,0-9,%#()*+-/:;<=>?_£¥§ÄÅÜäèéìñòöùü=].
The next characters need to be sent URL encoded: + % # ( ) * + , - / : ; < = > ? _ £ ¥ § Ä Å Ü ä è é ì ñ ò ö ù ü =.
- SendTo
The phone number of the sender in the format 31612345678, or the international phone number without preceding zeros or plus sign.
- Operator
The operator code of the sender. Example: 02f480.
Click here for an operator list.
N.B. You can secure the scripts by checking whether the requests are coming from an IP address: 195.140.234.120
Example
http://www.mysite.com/smshandler.php?
SendTo=31612345678&Message=WEB+SMS+TEST&ShortCode=3010&MO_MessageId=534048699&operator=02F480&MO_ShortKey=WEB+SMS
Your script has to return the text 45000 if everything is right.
When this does not happen, the URL will still be called a number of times until the right result code returns. Therefore, only send another status code when it makes sense to try the script again later, for example when your database is temporarily unavailable!
|
|  |
|
