SMS Gateway

Technische Documentatie

De uitleg voor het gebruik van de Premium SMS Gateway vindt je op deze pagina. Het gehele proces is eenvoudig: op het moment dat wij een bericht binnenkrijgen voor jouw keyword sturen we je deze informatie toe op de door jou opgegeven URL. Aan de hand van deze gegevens bepaal je om welke dienst het gaat, om vervolgens één of meerdere berichten via onze pagina uit te sturen.

Momenteel is deze dienst alleen nog in Nederland beschikbaar via de shortcode 7111.

Het hoofdkeyword op 7111 is ORDER. De tekst die je klant moet toesturen is "ORDER.JOUWKEYWORD" of "ORDER JOUWKEYWORD". Het is tevens mogelijk voor je klant om meer tekst achter jouw keyword mee te sturen zoals "ORDER.NIEUWS.BARCELONA", waarbij men zich bijvoorbeeld aanmeld voor wekelijks nieuws over de Spaanse stad Barcelona.

Lees hieronder meer over de werkwijze!

Keywords

Geef bij het keyword een zogenaamde "callback" URL op. Wij zullen deze aanroepen wanneer er door een eindgebruiker een bericht met dit keyword wordt gestuurd naar de 7111 shortcode.

Binnenkomende SMS

De gegevens van de berichten welke binnenkomen op de shortcode 7111 die beginnen met jouw (sub) keyword sturen wij door aan de door jou opgegeven "callback" URL. Hierbij gebruiken wij de POST methode.

Een voorbeeld aanroep:
http://www.jouwdomein.com/jouwpagina.php?param=barcelona&phonenumber=3161234567
&operator=kpn&keyword=nieuws


Uitgaande SMS

Nadat er een SMS bericht is binnengekomen van een klant, of wanneer hij/zij zich eerder heeft aangemeld op bijvoorbeeld het dagelijkse weerbericht, kun je een betaald SMS bericht uitsturen via onze gateway.

Een voorbeeld aanroep:
http://www.mobilemoney.com/rbpost.asp?ac=xxxxxx&pw=xxxxxx&gsm=xxxxxx&text=xxxxxx
&nw=xxxxxx&tariff=xxxxxx&keyword=xxxxxx&shortcode=xxxxxx

TariefWaarde
€1.50150
€1.10110
€0.9090
€0.8080
€0.7070
€0.5555
€0.4040
€0.3535
€0.2525

Wanneer je de "rbpost.asp" pagina aanroept met bijbehorende parameters geeft de pagina een zogenaamde returncode terug. De betekenissen van deze codes zijn als volgt:

CodeBetekenis
0Aanvraag wordt verwerkt. *
1Probleem met het telefoonnummer.
5Onbekende fout.
10Gateway is tijdelijk niet beschikbaar. Aanvraag is in een wachtrij geplaatst.
19Fout in username of password.
20Fout in operator.
21Fout in sms tekst (te lang / te kort).
22Fout in afzender.
23Fout in tarief.
24Telefoonnummer niet geactiveerd.
29Telefoonnummer staat op de Blacklist
33Geen geldige SMS gateway gevonden.
40Eindgebruiker wenst geen premium SMS berichten te ontvangen.
41Maandelijks tegoed overschreden.
42Eindgebruiker heeft Infofilter (zie www.Infofilter.nl) geactiveerd.
43Eindgebruiker heeft een uitstaande STOP aanvraag voor deze shortcode.
44Telefoonnummer niet in gebruik.

* Het is helaas (nog) niet mogelijk om real-time te bevestigen of een Premium SMS bericht zonder problemen afgerekend kon worden. Dit kan soms tot wel enkele uren duren, waarna de bijbehorende verdiensten in de statistieken opgenomen zullen blijven.