 
Met een IP-SMS account krijgt u de beschikking over
krachtige middleware die via de geavanceerde 1609SMS
Message Gateway aangesloten is op de SMS Centrales
van alle Nederlandse mobiele operators. Hiermee
kunt u vanaf iedere bestaande applicatie (met
Internet verbinding) of website SMS berichten
creëren en ontsluiten; simpelweg door een
http-request te posten op de 1609SMS server. Het
request wordt geverifieerd en u ontvangt van de
1609SMS server een response. SMS berichten
ontsluiten vanaf uw bestaande applicaties is nog
nooit zo eenvoudig en snel geweest. IP-SMS is
geschikt voor alle programmeertalen, scripts,
legacy-software en bestaande systemen. Via onze
gateway kunt u onze diensten op een zeer eenvoudige
manier integreren in uw bestaande beheersoftware en
uw
wachtwoord bijvoorbeeld ook encoderen met
SHA-1
voor extra veiligheid. Ook kunt u
vanzelfsprekend een
virtual
number
bij ons afnemen en zodoende inkomende sms
berichten
ontvangen, en hier vervolgens
automatische vervolgacties aan koppelen.
 Samengevat:
-
SMS berichten genereren via het http-protocol
-
(Web) applicaties verrijken met SMS ontsluiting
-
Geschikt voor alle programmeertalen en scripts
PHP voorbeeld
Enkele toepassingen van IP-SMS
-
Planning of voorraadsysteem koppelen aan SMS.
Informeer uw klanten real-time
per SMS over de status van
orders
-
SMS diensten om uw website
interactiever te maken: Denk hierbij aan een
routebeschrijving, contactinformatie of het
laatste nieuws per SMS
-
Stroomlijnen interne
bedrijfsprocessen. Afspraken bevestiging voor uw
verkoopteam, belangrijke mededelingen,
notificatie als server down is etc...
-
Partijen die bijvoorbeeld de 1609SMS Gateway API
gebruiken zijn :
◘
URL aanspreken :
De 1609SMS message gateway
staat in verbinding met alle Nederlandse
SMS-Centrales zodat een goede Quality of Service
(beschikbaarheid, capaciteit en snelheid) voorhanden
is. De meest gebruikte methode om berichten via onze
message gateway te versturen of te ontvangen is via
het HTTP GET protocol.
Via een HTTP request (GET of POST) kunt u onze
gateway aanspreken via uw eigen software applicatie.
---------------------------------------------------------------------------------------------------
http://217.19.227.48/module/gateway.php?klantuser=USERNAME&klantpwd=PASSWORD&bericht=BERICHT&naar=NAAR&afzender=SENDER
---------------------------------------------------------------------------------------------------
(simpele test) - Wanneer
u bovenstaande string in uw browser invoert, uw Username en Password
ingeeft, kunt u gemakkelijk
via url bulk/groep sms berichten versturen. Wanneer u 31612345678,31612345677
toevoegt, slechts gescheiden door een komma, verstuurt u naar meerdere mobiele nummers.
Open hier een
test account om dit te proberen.
|
Antwoord |
Uitleg |
Opmerking |
|
OK |
Uw sms werd succesvol
verzonden |
Uw SMS werd succesvol
verzonden |
|
ERROR x.x.x |
Er was een probleem +
errorcode |
Een overzicht van mogelijke
errorcodes kunt u
hieronder terugvinden. |
Wilt u meer overigens meer informatie over
het kunnen
versturen
of het kunnen
ontvangen
van SMS berichten ?
U moet de bovenstaande url steeds encoderen voordat
u deze verzend omdat deze o.a. geen spaties mag
bevatten.
Bvb : bericht=dit is een test , dit moet in de
praktijk worden : bericht=dit%20is%20een%20test .
In PHP is hier een zeer eenvoudige functie voor :
urlencode($url);
Dit moet ook gebeuren voor de afzendernaam indien u
hierin een spatie wil gebruiken of andere speciale
tekens !
UTF-8
(8-
bit
Unicode Transformation Format) is een manier
om
Unicode/ISO
10646-tekens op te slaan als een stroom van
bytes, een zogenaamde
tekencodering. UTF-8 is een tekencodering met
een variabele lengte: niet elk teken gebruikt
evenveel bytes. Afhankelijk van het teken worden
tussen 1 en 4 bytes gebruikt. Omdat veel westerse
letters slechts 1 byte in beslag nemen, is UTF-8
voor westerse talen compacter. Wanneer u via onze
gateway verstuurt, zorg er dan voor dat
uw bericht (bericht) en de afzendernaam (sender)
UTF-8 geëncodeerd is. U kunt UTF8 encodering overigens
gemakkelijk testen via deze pagina:
http://www.hypergurl.com/urlencode.html ;
let op: encoding op UTF8 zetten, en niet op ASCII
De 1609SMS
gateway ondersteunt het gebruik van alfanummerieke
afzenders (letters en/of cijfers). In plaats van een
telefoonnummer ziet de ontvanger van het bericht een
tekst - van maximaal 11 karakters - als afzender
|
◘
Voorbeeldscripts in diverse
programmeertalen : |
|
Programmeertaal |
Naam |
Uitleg |
|
PHP |
Fsockopen |
Hier kunt u informatie terugvinden over Fsockopen, een PHP functie voor het
aanspreken van een url. |
|
PHP |
Urlencode |
Hier kunt u informatie terugvinden of urlencode, een PHP functie voor het
encoderen van een url. |
|
VB.net |
easyHTTP |
Hier kunt u informatie terugvinden voor
het aanspreken van de gateway via VB.net |
|
Een PHP
Voorbeeld |
PHP voorbeeld |
Hier ziet u een werkend PHP voorbeeld : |
|
Parameter |
Uitleg |
Opmerking |
|
klantuser |
uw gebruikersnaam |
Hetzelfde als u ontvangen
heeft voor de sms module |
|
klantpwd |
uw wachtwoord |
Hetzelfde als u ontvangen
heeft voor de sms module ( u kunt dit
wachtwoord ook encoderen met
SHA-1
voor extra
veiligheid. ( enkel het gebruik van 1 - case
karakters is overigens toegestaan ) |
|
bericht |
het SMS bericht |
Let op : het bericht moet
urlencoded zijn vooraleer u verstuurd. (dit
is een test = dit%20is%20een%20test) |
|
naar |
het gsmnummer |
Een geldig sms nummer (steeds
beginnen met de juiste landcode : bvb
32478123456) |
|
afzender |
de afzendernaam |
maximaal 11 tekens
(afzendernaam) |
|
|
|
|
|
Optionele parameters |
|
logging=ja |
Loggingsfunctie |
Indien u logging=ja toevoegd
zullen alle smsverzendingen automatisch
opgeslagen worden in de historiek van de sms
module. |
|
delivery=ja |
Afleverrapporten |
Indien u delivery=ja toevoegd
krijgt u bij een succesvolle verzending OK +
een smsID terug.
bvb : OK 1234567
U kan dit SMS ID opvangen en kunt hier een
callback action op uitvoeren om het rapport
op te vragen. |
|
type=long |
Versturen van lange berichten |
Indien u type=long toevoegd
kan u berichten > 160 tekens versturen. Het
bericht wordt in dit geval opgesplitst in
meerdere SMS-berichten en vervolgens op de
telefoon als één bericht weergegeven. U kan
een bericht aanleveren tot maximum 459
tekens en wij splitsen het op naar maximaal
3 SMS-berichten. Let op : je kan per SMS
maar 153 tekens gebruiken (de andere 7
tekens worden gebruikt om aan te geven dat
het om een "long SMS" gaat). |
|
test=ja |
Testen van het systeem |
Het systeem zal wel alle
controles uitvoeren (correcte
gebruikersnaam,wachtwoord ,bericht,
afzendernaam, ...) maar zal geen effectieve
SMS versturen. Er worden ook geen credits
afgetrokken. |
Als uw bericht niet succesvol
verzonden is geeft de gateway een error + nr terug.
Hier kunt u een overzicht terugvinden van de errors.
|
Errorcode |
Uitleg |
|
100 |
Gebruikersnaam-waarde is leeg
en mag niet leeg zijn |
|
101 |
Wachtwoord-waarde is leeg en
mag niet leeg zijn |
|
102 |
SMS bericht bevat geen inhoud |
|
103 |
Gsmnummer bevat geen inhoud |
|
104 |
Geen geldige gebruikersnaam
en/of wachtwoord combinatie |
|
105 |
Bericht bevat meer tekens dan
toegestaan (> 160 tekens) |
|
106 |
Geen geldig GSMnr. Een geldig
nummer start altijd met de landcode gevolgt
door het nummer : bvb 32478123456 |
|
107 |
Geen geldige landcode. U kan
geen smsjes versturen naar dit land. Gelieve
ons te contacteren of we dit mogelijk kunnen
maken. |
|
108 |
U heeft niet voldoende
credits meer |
|
109 |
De afzendernaam is leeg |
|
110 |
U maakt gebruik van een
afzendernummer, maar deze moet altijd met
een +teken beginnen. |
|
111 |
U maakt gebruik van een
ongeldige afzendernaam/nummer. Deze mag
maximaal 12 tekens bevatten. |
|
112 |
U maakt gebruik van een
ongeldige landcode |
|
113 |
Uw afzendernaam/nummer bevat
speciale tekens die niet op alle netwerken
zijn toegelaten. |
|
114 |
Geen geldige landcode (land
niet toegestaan). |
|
115 |
Uw account werd geblokkeerd
omdat uw betaling nog niet in orde is. |
|
116 |
Uw account werd geblokkeerd
om een bepaalde reden. U kan contact met ons
opnemen voor meer informatie.
|
|
117 |
Deze afzendernaam is niet
toegestaan. |
|
118 |
Indien u een lange SMS wil
versturen (> 160 tekens) mag deze maximaal 3
berichten lang zijn, (max 153 tekens per
bericht) dus maximaal 459 tekens lang. |
|
119 |
Voor versturen van smsjes
naar dit land , kan u de mogelijkheid om
lange smsjes (> 160 tekens) te versturen
niet gebruiken. |
|
120 |
Er was een probleem met onze
gateway. Gelieve ons te contacteren. |
|
150 |
Onze module is tijdelijk
buiten gebruik wegens werkzaamheden. |
|
◘
Afleverrapporten opvragen : |
Om afleverrapporten te gebruiken moet
u altijd eerst de parameter "delivery=ja" gebruiken.
U krijgt dan als antwoord OK + nr terug . bvb OK
1234567
Via deze pagina kan u de statussen
opvragen :
http://217.19.227.48/module/gatewayrapport.php?smsid=1234567
Het systeem geeft een code terug naargelang de
status van het bericht.
|
Aflevercode |
Uitleg |
|
DELIVERED |
Het bericht werd
succesvol afgeleverd (eindstatus) |
|
NOT DELIVERED |
Het bericht werd niet
succesvol afgeleverd (eindstatus) |
|
BUFFERED |
Het bericht werd
geaccepteerd door de operator, maar nog
niet afgeleverd aan de ontvanger. De
operator zal op regelmatige tijdstippen
proberen dit bericht af te leveren . Dit
is een tijdelijke status. |
|
SUBMITTED |
Het bericht werd
succesvol afgeleverd aan de operator, en
er is (nog) geen status beschikbaar van
het bericht. |
|
REJECTED |
De operator heeft dit
bericht geweigerd (eindstatus) |
|
NONE |
Van dit bericht is er
geen afleverrapport (meer) beschikbaar
en dus ook geen status bekend. |
|
◘
Opvragen van resterend aantal credits
: |
U kunt ook uw aantal resterende
credits opvragen aan de gateway.
http://217.19.227.48/module/gateway.php?klantuser=USERNAME&klantpwd=PASSWORD&action=credits
Dit geeft een getal terug : bvb 476
Dit is het aantal credits dat u nog op uw SMS
account heeft staat.
U kunt ons
vanzelfsprekend contacteren als u
problemen heeft met het implementeren van onze gateway in uw scripts.
Stuur eventuele vragen / scripts naar
php-support@1609sms.com
Wilt u onze gateway eens testen en
berichten ontsluiten vanaf uw bestaande applicaties,
open dan even een
test-account
,
en gebruik de via de mail te ontvangen
gebruikersnaam- en wachtwoord gegevens als
identificatie in uw scripts.
Of neem telefonisch even contact op met onze support- of sales medewerkers...
+31 (0)84 0030 090
Of neem online even contact via het chat
venster op, door te
klikken op onderstaande contact button.
Heeft u
vragen over integratie van uw scrips en wilt u
gebeld worden? Vul hieronder uw gegevens
in en wij nemen vervolgens z.s.m. contact met
u op.
| 
