Datasheet SMS Comfort URL De SMS Comfort biedt de mogelijkheden om via http SMS berichten te versturen: LET OP Eventueel gebruikte gegevens in de onderstaande voorbeelden zijn fictief! URL Methode: HTTP Get Request URL: Host: IP of DNS van SMS comfort server Port: ingestelde poort server (default 22281) Path: /smsin/smsin.asp De SMS Comfort heeft een aantal parameters nodig voordat het uw SMS bericht kan versturen. Parameter Omschrijving Waarde IP of DNS SMS gateway Sms Comfort IP / DNS IP-adres SMS Comfort en eventueel poort logon= Alias Gebruiker Alias toegewezen aan gebruikersnaam pass= e-mailadres gebruiker / afzender gsmnr= nr bestemming Mobiel nummer Op dit e-mailadres ontvangt u een bevestiging van het verstuurde bericht inclusief extra info name= naam klant e.a. Naam klant (aanmaak mobile account) msgcontent= Inhoud bericht Het te versturen bericht, dit kunnen grote berichten zijn senderid= verificatie ID ID of mobiel nummer verzender. i.p.v. email / alias extracommands= commands zelfde als subject commands LET OP gsmnr= nummer notificatie enkel in 00324xxxxxxxx of 324xxxxxxxx of 04xxxxxxxx Speciale karakters, deze moeten URL-Encoded zijn. Daar je gebruik maakt van het http protocol ben je dus ook afhankelijk van deze structuur. Zie RFC-1738. 1
Voorbeeld van hoe u onze SMS Comfort kan aanspreken. HTTP Get Request Door de onderstaande URL aan te roepen met de correcte gegevens is het mogelijk om een SMS bericht te versturen via onze SMS gateway. http://sms.comfort.gateway:port/smsin/smsin.asp?logon=alias&pass=email@address.com&gsmnr =MobileNR&name=MobileNae&senderID=MobileID&msgcontent=test&extraCommands=%25Spl Hoe worden SMS berichten ontvangen? Sms Comfort kan ontvangen SMS berichten enkel doorsturen onder SMTP (email) niet naar XML - Bericht worden dus afgeleverd in de mailbox van de verzender (zie pass=) - Berichten die niet kunnen afgeleverd worden gaan naar de Receptie Welke informatie bevat het email confirmatie bericht? Sms Comfort notificatie - Bericht aan mobielnr is afgeleverd op het netwerk - Inhoud van het bericht - Bericht aan mobielnr is afgeleverd op GSM. - Inhoud van het bericht - Deze SMS kon niet worden afgeleverd met als reden: Niet verzonden op SMS netwerk. Extra parameters in te stellen in SMS Comfort. - Sms Comfort notificatie enkel als functie actief staat (varius / notification) - Alias in SMS bericht permanent actief (accounts / email) - Alias in body email permanent actief (accounts / email) - Dag / week / maand limieten verzenden berichten (accounts / email) SMDR Logging - logging van de in en uitgaande berichten worden opgeslagen in een CSV bestand - SMDR file kan dagelijks, wekelijks of maandelijks naar een verantwoordelijke verzonden worden (zie ook SMS comfort TechTip 5 SMDR reporting) 2
Testen connectie naar web server via Http Client: Host: ip adres sms server Path: ingesteld path (default: /smsin/smsin.asp) Port: ingestelde poort op server (default 22281) Name: parameter msgcontent= inhoud van het te verzenden bericht. GSM no: parameter gsmnr= gsm nummer van de bestemmeling. Email: parameter pass= e-mailadres van de verzender. (gebruiker) Alias: parameter logon= alias van de gebruiker Sender ID: parameter senderid= ID is geconfigureerd in het email account en gebruikt i.p.v alias of email. Extra Command: parameter extracommands= zijn dezelfde als de Subject commands. Message: parameter name= naam van de bestemmeling. Druk op GET om het bericht te verzenden URL: Onderaan staat de volledige URL zoals hij verzonden zal worden. 3
Generated errors : url errocode: 1000 = rsnolocaccount, = No Local Account 1001 = rsnomobaccount, = No Mobile Account 1002 = rsduplicatealias, = Duplicate Alias 1003 = rsnotsenttonet, 1004 = rsinvalidtohdr, 1005 = rsreasontoolong, 1006 = rsblacklist, 1007 = rswhitelist, 1008 = rsmonthlimit, 1009 = rsweeklimit, 1010 = rsdaylimit, 1011 = rsnopermission, 1012 = rsgroupnotexists, 1013 = rstoomanyemailclients, 1014 = rsaccountdisabled 1015 = rswrongtoheader 1016 = rsroutenotfound 1017 = rsinvaliddelay bij een lege email in de url word ook 1000 + rsnolocaccount teruggegeven. Correct verzonden bericht: <smscomfort> <status>accepted</status> <error>0</error> <reference>0</reference> </smscomfort> Statuscode 200 Error 1001 = No Mobile Account. <smscomfort> <status>not accepted</status> <error>1001</error> <reference>0</reference> </smscomfort> Statuscode 200 4
Testen connectie naar web server via telnet: Start telnet naar IP adres sms comfort op ingestelde poort. Vb: TELNET 192.168.1.2 22281 Vervolgens geef je de GET parameters in: GET /smsin/smsin.asp?login=xx&pass=xx@domain.com&gsmne=324xxxxxxxx&name=custema rname&msgcontent=testje 5