|
|
Receiving incoming messages (MO)
When a message is received on the shortcode from a mobile device, TargetSMS will call a script on your webserver. The parameters and expected response are described below.
The preset URL will be called with these parameters:
Variable |
Description |
Format |
MO_MessageId |
Unique message ID |
Numeric |
ShortCode |
shortcode |
Numeric |
MO_ShortKey |
The keyword |
Alphanumeric |
Message |
The message body |
Alphanumeric |
SendTo |
Phone number of the sender |
Numeric |
operator |
Operator code |
Alphanumeric |
onoff |
Status |
on, off, ok |
Important!
In some scripting languages (including PHP), variable names are case-sensitive. Please note the exact spelling of the variable names when you use PHP.
Example: in PHP $_GET["MO_MessageID"] is different from $_GET["mo_messageid"].
More detailed explanation per variable:
- MO_MessageId
Unique identifier of the incoming message. This ID has to be specified when requesting our system to send out billed MT messages. When you insert the incoming messages, it is advisable to put a primary key on the MO_MessageId to prevent double entries. See also the notice at the end of this text.
- ShortCode
The shortcode on which the incoming message was received, e.g. 3010.
- MO_ShortKey
The keyword of your service, e.g. INFO
- Message
The complete text sent by your customer. The message contains max. 160 characters and may contain these characters: [a-z,A-Z,0-9,&+%# =].
The following characters will be send URL-encoded: & %26, + %2B, % %25, # %23, Space %20, = %3D.
- Operator
The code of the telecom operator of the customer, e.g. 02F480 (=KPN, The Netherlands).
- SendTo
The international phone number of a customer in the format 31612345678.
- Onoff (only applicable for subscription services!)
Indicates if the message was a sign up, sign off or confirmation message, respectively: 'on', 'off', 'ok'.
Confirmation is obligatory for subscription services for € 0.70 or more per message in The Netherlands.
Note: you can secure your scripts by checking if the requests are coming from the IP address: 195.140.234.120
Example
http://www.mysite.nl/smshandler.php?
SendTo=31612345678&Message=WEB+SMS+TEST&ShortCode=3010&
MO_MessageId=534048699&operator=02F480&MO_ShortKey=WEB+SMS
Your script has to output the text 45000 as body, not as HTTP header.
When another response is received by our system, the URL will be retried several times until the correct code is returned. Give only another response code when a retry would make sense (e.g. in case of a temporary error).
|
| |
Algemene Voorwaarden |
Cookie Policy |
Cookie Instellingen |
Privacy Statement
|