|
◘ Algemene gegevens : |
◘
Met een IP-SMS account krijgt u de beschikking over
krachtige middleware die via de geavanceerde 1601SMS
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 1601SMS server. Het
request wordt geverifieerd en u ontvangt van de
1601SMS 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
1601SMS API in Pdf
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 1601SMS Gateway API gebruiken zijn :
|
◘ Technische gegevens : |
◘ URL aanspreken :
De 1601SMS 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 sms 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 xxx |
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 ?
|
◘ Let op : |
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 1601SMS 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 : |
|
◘ Parameters : |
|
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
|
|
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. |
|
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. |
|
◘ Error codes : |
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.
|
◘ Support : |
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@1601sms.nl
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 530
Of neem online even contact via het chat venster op, door te klikken op onderstaande contact button.
|
◘ Terugbel service : |
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.
