Hilfe & FAQ

SMS Versand

 

 

SMS Empfang

 

 

 

 

 

An welche Internetadresse muss der Aufruf für den Versand einer Standard SMS gesendet werden ?

Senden Sie Ihre Daten für die SMS an http://extern.web-2-sms.net/send.php

 

Wie müssen die Daten vorliegen ?

Die Daten müssen an die URL angehängt werden. Der SMS-Text und der Absender (falls alphanumerisch) müssen urlencoded sein.

Beispiel: http://extern.web-2-sms.net/send.php?USER=123456&PASS=Geheim&VON=mueller&AN=00491701234567&TEXT=der+text

Ein Aufruf per POST-Request ist ebenfalls möglich.

 

Welche Daten muss ich dem SMS-Gateway für eine Standard-SMS übergeben?

Folgende Parameter sind zwingend erforderlich:

Parameter Erklärung Beispiel
USER Ihre Benutzerkennung meier
PASS Ihr Passwort gsf45Gf
AN Die Empfängernummer im internationalen Format - bitte verwenden Sie anstatt der führenden 00 kein + Zeichen 00491721234567
VON Der Absender (je nach Netz auch alphanumerisch, dann urlencoded und maximal 11 Stellen) -um Replys zu ermöglichen numerisch mit vollständigem Ländercode 00491721234567 oder Frei-SMS
TEXT Den SMS-Text (bei ASCII Text urlencoded) Dies+ist+ein+Test

 

Welche Daten kann ich dem SMS-Gateway übergeben ?

Folgende Parameter sind optional:

Parameter Erklärung Beispiel
MODE Falls eine SMS abweichend von Ihren Einstellungen m Kundenbereich als Standard/HighQuality SMS versendet werden soll, geben Sie das bitte mit diesem Parameter an, ansonsten wird die Einstellung, die SIe im Kundenbereich als Default gesetzt haben, genutzt, Premium oder Standard
GETXML Wenn GETXML=1 wird die Gatewayrückgabe (success oder error) als XML-Dokument mit Detailsausgabe geliefert 1 oder 0
TIME Auslieferunszeit bei zeitversetztem Senden im Format hhmmddmmyyyy 1502030403
TEST Wenn TEST=1 wird die SMS nicht ausgeliefert, sie erhalten aber die Rückgabe des SMS-Gateway.  

 

Wie sieht ein einfacher Aufruf des SMS-Gatewayfür eine Standard-SMS aus ?

Ein einfacher Aufruf in sieht folgendermaßen aus:

http://extern.web-2-sms.net/send.php?USER=IhreGATEWAY-Benutzerkennung&PASS=IhrGATEWAY-Passwort&
VON=Free+SMS&AN=00491711234567&TEXT=Dies+ist+eine+SMS

Dieses Beispiel dient nur der Veranschaulichung, die entsprechenden Daten(USER,PASS etc.) müssen von Ihnen natürlich geändert werden.

 

Kann ich auch SMS verschicken, die länger als 160 Zeichen sind ?

Ja, es können maximal SMS mit einer Länge von 6*153 Zeichen als Multipart-SMS verschickt werden. Bedenken Sie jedoch, daß jeder Part der SMS als SMS abgerechnet wird, sodaß für eine SMS aus z.B. 3 Parts auch Kosten für 3 SMS entstehen.

 

Was bedeutet 'urlencoded' ?

Wandelt einen String so um, dass er in einer URL verwendet werden kann. Per Formular vom Browser versendete Daten sind automatisch urlencoded.

 

Wie erfahre ich die IP-Adresse meines Webservers ?

Unter Windows: Geben Sie in der Eingabeaufforderung > ping 'name-des-servers' ein.

 

Wenn ich im Kundenbereich die IP-Kontrolle auf aktiv setze bekomme ich beim Versand immer die Fehlermeldung 'Inkorrekte IP-Adresse'?

Die angegeben IP-Adresse muss die IP-Adresse des versendenen Scripts/Formular sein. Da in der Regel bei der Einwahl in das Internet vom Provider dynamische IP-Adresse vergeben werden, wird Ihre IP-Adresse nicht mit der eingetragenen übereinstimmen. Um diese Option verwenden zu können, müssen sie ein Script zwischenschalten, das Ihre Formulareingaben weiterverarbeitet und an das Gateway sendet. Die eingetragene IP-Adresse muss dann die IP-Adresse des Webservers enthalten, von dem dieses Script an das Gateway verschickt wird.

 

Meine SMS-Nachrichten haben keine Leerzeilen ?

Bitte senden Sie den Text im urlencoded-Format (wenn Sie den Text aus einem Formular versenden, wird der Text vom Clientbrowser entsprechend encodiert). Beispiel: Dies+ist+ein+Test

 

Gibt es ein Testscript, wo ich meine Einstellungen kontrollieren lassen kann?

Ein Testscript steht in der Version 4.0 nicht mehr zur Verfügung, dafür wurde der (neue) Parameter "TEST" mit eingeführt (siehe oben).

 

Aktuelle Errorcodes des SMS-Versandscript:
ShortCode LongDescription ShortDescription
000sms successfully transmittedsuccess
001internal server errorinternal error
002can not connect to databasedatabase error
003account not activenot active error
005format or netid error (recipient)format error
100wrong or missing username or passwordauthentication error
101ip restriction in actionip restriction error
102limit errorlimit error
105prepaid limit errorprepaid limit error
106prepaid termtime errorprepaid termtime error
111recipient not allowedrecipient restriction error
112missing recipientrecipient error
113message contains no contentcontent error

 

Ist der Versand von SMS in das Ausland möglich?

Der Versand von SMS ist mit allen Accounts ausser dem SMS-OUT Prepaid Standard möglich. Bitte beachten Sie aber die höheren SMS-Kosten (in der Regel 100% Zuschlag auf Premium-SMS, also 0.23 € bei Versand mit SMS-OUT Postpaid).


 

 
 
 
Wie kann ich die Daten einer eingehenden SMS bearbeiten ? Sie können eingehende SMS entweder per EMail oder per http-Request weitergeben. Zusätzlich können SIe bei gleichzeitiger Buchung eines SMS-OUT Accounts eingehende SMS per Autoreply mit einem vorgefertigtem Text beantworten lassen.

Welche Parameter werden bei eingehenden SMS genutzt?Folgende Parameter werden bei eingehenden SMS entweder per EMail oder per HTTP an Ihre Emailadresse bzw. Script weitergereicht:
Parameter Erklärung Beispiel
VON Die Rufnummer des Absenders, falls dieser keine Rufnummernunterdrückung aktiviert hat. 00491711234567
AN Die Rufnummer des SMS-IN Gateway, dass Ihrem Account zugeordnet ist. 00491711234567
TEXT Der Text der SMS-Nachricht. Hallo Du.
TIME Der Zeitcode des SMS-Eingangs im Format YYYY-MM-DD HH:MM:SS. 2009-10-10 11:21:55
MSG_ID Eindeutige 8-stellige Identifizierungsnummer. 21543812


In welcher Form werden die Parameter bei eingehenden SMS weitergegeben ?Sie können im Adminpanel (Kundenbereich) selbst einstellen, ob eingehende SMS per EMail oder HTTP an Sie weitergegeben werden. Bei Auswahl von HTTP werden die o.a. Parameter per GET-Methode an Ihr Script weitergereicht, bei Auswahl von Email werden die Parameter VON, AN, TIME, MSG_ID an das Subject der Email gehängt, der TEXT wird als Bodytext der Email weitergereicht. Das Email-Subject ("Betreff") hat dann zum Beispiel folgenden Inhalt:
"SMS-IN Nachricht|004917112345567|00491719876543|2009-10-10 12:44:36|23467120"


Was bedeutet Keywordgesteuert ? Bei dedizierten SMS-IN Gateways wird die Unterscheidung, welchem Kunden die eingehende SMS zugeordnet wird, anhand eines vorangestellten Keywords getroffen. Geben Sie z.B. als Keyword 'demo' ein, so werden alle eingehenden SMS, deren Text mit 'demo' beginnt, Ihrem Account zugeordnet. Eine Unterscheidung nach Gross-und Kleinschreibung wird dabei nicht getroffen (demo=Demo=DEMO) .