Documentatie SMS-2-Web module
AlgemeenWanneer uw klant een SMS verstuurt naar een door ons afgehandelde shortcode, dan roepen we een URL aan op uw server. Deze URL heeft u in de Wizard aangegeven.
ParametersDe door u geregistreerde URL wordt door ons met de volgende parameters aangeroepen d.m.v. een HTTP GET:
Variabele Omschrijving Formaat
MO_MessageId Bericht ID van de operator Numeriek
ShortCode SMS Shortcode Numeriek
MO_ShortKey Subkeyword of keyword Alfanumeriek
Message Het bericht Alfanumeriek
SendTo Telefoonnummer van de afzender Numeriek
operator Operatorcode Alfanumeriek
Belangrijk!
In sommige scripting-talen (waaronder PHP) zijn variabele-namen hoofdlettergevoelig. Let in dat geval goed op de schrijfwijze die hierboven staat aangegeven.
Voorbeeld: in PHP is $_POST["MO_MessageID"] een andere variabele dan $_POST["mo_messageid"].
Toelichting per variabele:
MO_MessageId
Het unieke id van het MO bericht. Als u de MO berichten in een database tabel opslaat, dan doet u er verstandig aan dit nummer er bij te zetten.
ShortCode
De SMS shortcode waarop het bericht binnenkwam, bijvoorbeeld 3010.
MO_ShortKey
Het keyword van uw dienst.
Message
Het volledige bericht van de consument. Dit kan maximaal 160 karakters lang zijn en de volgende karakters bevatten [a-zA-Z0-9+%#()*+,-/:;<=>?_£¥§ÄÅÜäèéìñòöùü=]. De volgende karakters worden URL encoded verzonden: + % # ( ) * + , - / : ; < = > ? _ £ ¥ § Ä Å Ü ä è é ì ñ ò ö ù ü =.
SendTo
Het telefoonnummer van de afzender in het formaat 31612345678, ofwel het internationale telefoonnummer zonder voorafgaande nullen of plusteken.
Operator
De operatorcode van de afzender. Bijvoorbeeld: 02f480.
Klik hier voor een lijst met operators.
N.B. U kunt de scripts beveiligen door te controleren of aanroepen gedaan worden vanaf IP adres: 89.184.168.*
Voorbeeld
http://www.mijnsite.nl/smshandler.php? SendTo=31612345678&Message=WEB+SMS+TEST&ShortCode=3010& MO_MessageId=534048699&operator=02F480&MO_ShortKey=WEB+SMS
ResultaatcodesUw script moet de tekst 45000 teruggeven als alles in orde is.
Wanneer dit niet gebeurt dan zal de URL nog een aantal keer aangeroepen worden totdat wel de goede resultaatcode terugkomt. Stuur dus alleen een andere statuscode terug als het zin heeft het script later opnieuw te proberen, bijvoorbeeld als uw database tijdelijk niet beschikbaar is!
