SMS ontvangen op een eigen URL
Doorsturen naar URL
Zodra er een bericht binnenkomt wat met uw keyword is gekoppeld, kunnen wij deze direct doorsturen naar het door u opgegeven URL. Dit gaat middels een HTTP request naar uw platform. We sturen de benodigde gegevens in GET of POST variabelen. U kunt het URL instellen bij uw keyword instellingen.
Voorbeeld van een door u opgegeven URL:
http://www.uwsite.nl/sms/incoming.php
Wij vragen het URL bijvoorbeeld op deze manier op:
http://www.uwsite.nl/sms/incoming.php?shortcode=1008&keyword=EXAMPLE&message=Example&
originator=31612345678&operator=02F440&
receive_datetime=20100311204038&mid=9000123
Let op! Controleer voor de veiligheid of het HTTP-request van onze IP adressen (82.94.203.80 t/m 82.94.203.86) afkomstig is.
| Parameter | Uitleg |
|---|---|
shortcode |
het verkorte nummer waar de consument de SMS heen heeft gestuurd |
keyword |
het keyword dat gebruikt is |
message |
het volledige bericht (inclusief het keyword) dat de consument heeft gestuurd |
originator |
het telefoonnummer van de consument |
operator |
operator code (zie lijst onderaan) |
mid |
MO message ID, deze ID is nodig bij het reageren op een inkomend bericht |
subscription |
alleen bij abonnementsdiensten: wanneer de consument het bericht met ON/AAN of OFF/UIT eindigt is het een aan- of afmelding voor een abonnementsdienst. Wij sturen ter bevestiging dan ook nog de parameter 'subscription' met de waarden 'on' of 'off' mee. |
receive_datetime |
tijdstip waarop het bericht is ontvangen bij de operator. Format: YYYYMMDDhhmmss |
Verwachte response
Als antwoord op het HTTP-request (de zogenaamde response) verwacht ons systeem het woordje 'OK' (zonder quotes of HTML-code). Als uw systeem geen 'OK' terug geeft zal ons platform de aanvraag herhaald opnieuw proberen te sturen.
Response van de opgevraagde URL:
OK
Hierna kunt u bijvoorbeeld het bericht in uw database opslaan, of gegevens op basis van het bericht uit uw database halen en een SMS-bericht terug sturen via onze (premium) SMS-gateway.
Operators
In het request naar het URL sturen wij ook een parameter operator mee. Deze parameter correspondeert met de verschillende (Nederlandse) operators.
| Code | Naam | |
|---|---|---|
| 204-08 | KPN Telecom | Hi |
| 204-04 | Vodafone | Libertel |
| 204-16 | T-Mobile | BEN |
| 204-02 | Tele2 | --- |
| 204-20 | Orange | Dutchtone |
| 204-12 | Telfort | O2 |