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
- keyword
Het keyword waarmee het bericht begint. - param
Alle overige tekst uit het bericht, behalve het (sub) keyword - phonenumber
Het telefoonnummer van de klant. - operator
De telecom provider waarbij de klant aangesloten is.
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
- ac
Je accountnaam. - pw
Het bijbehorende wachtwoord. - shortcode
Het verkorte nummer, in dit geval 7111. - keyword
Het volledige (sub) keyword waarnaar de klant eerder een bericht heeft gestuurd. Gebruik in geval van een subkeyword dus ORDER.[JOUWKEYWORD] - nw
Het netwerk / de telecom provider. Gebruik één van de onderstaande waarden:
KPN
Orange
T-Mobile
Telfort
Vodafone
Tele2 - gsm
Het telefoonnummer van de klant, incl. landcode (bijvoorbeeld “31612345678”). - text
De SMS tekst, maximaal 160 karakters. - tariff
Het tarief voor dit bericht in aantal centen. Gebruik hierbij één van de onderstaande waardes:
| Tarief | Waarde |
|---|---|
| €1.50 | 150 |
| €1.10 | 110 |
| €0.90 | 90 |
| €0.80 | 80 |
| €0.70 | 70 |
| €0.55 | 55 |
| €0.40 | 40 |
| €0.35 | 35 |
| €0.25 | 25 |
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:
| Code | Betekenis |
|---|---|
| 0 | Aanvraag wordt verwerkt. * |
| 1 | Probleem met het telefoonnummer. |
| 5 | Onbekende fout. |
| 10 | Gateway is tijdelijk niet beschikbaar. Aanvraag is in een wachtrij geplaatst. |
| 19 | Fout in username of password. |
| 20 | Fout in operator. |
| 21 | Fout in sms tekst (te lang / te kort). |
| 22 | Fout in afzender. |
| 23 | Fout in tarief. |
| 24 | Telefoonnummer niet geactiveerd. |
| 29 | Telefoonnummer staat op de Blacklist |
| 33 | Geen geldige SMS gateway gevonden. |
| 40 | Eindgebruiker wenst geen premium SMS berichten te ontvangen. |
| 41 | Maandelijks tegoed overschreden. |
| 42 | Eindgebruiker heeft Infofilter (zie www.Infofilter.nl) geactiveerd. |
| 43 | Eindgebruiker heeft een uitstaande STOP aanvraag voor deze shortcode. |
| 44 | Telefoonnummer 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. | |
