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 |
| 000 | sms successfully transmitted | success |
| 001 | internal server error | internal error |
| 002 | can not connect to database | database error |
| 003 | account not active | not active error |
| 005 | format or netid error (recipient) | format error |
| 100 | wrong or missing username or password | authentication error |
| 101 | ip restriction in action | ip restriction error |
| 102 | limit error | limit error |
| 105 | prepaid limit error | prepaid limit error |
| 106 | prepaid termtime error | prepaid termtime error |
| 111 | recipient not allowed | recipient restriction error |
| 112 | missing recipient | recipient error |
| 113 | message contains no content | content 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) .
|
