Interface SMS-Versand Version 2.0 Stand:

Transkript

1 Interface SMS-Versand Version 2.0 Stand: Allgemeines Die Bereitstellung der SMS-Dienste basiert auf der Nutzung der Funktionalitäten der SMS-Gateways der. Diese Funktionalitäten stehen über die im Folgenden aufgeführten Schnittstellen zur Verfügung. Derzeit werden folgende Funktionen in den einzelnen Tarifen unterstützt: Basic: Economy: Quality: - Absenderkennung nicht einstellbar, es wird ein numerischer Absender aus unserem Versandsystem verwendet. - Auf die SMS kann geantwortet werden. - SMS Typen: Text-SMS, überlange SMS* Wap-Push, Flash-SMS*, Binär-SMS, UTF-8-SMS - Absenderkennung frei einstellbar. - Auf die SMS kann geantwortet werden (siehe Punkt 4) - SMS-Typen: Text-SMS, überlange SMS*, Wap-Push, Flash-SMS*, Binär-SMS, UTF-8-SMS - Absenderkennung frei einstellbar. - Auf die SMS kann geantwortet werden (siehe Punkt 4) - SMS-Typen: Text-SMS, überlange SMS*, Wap-Push, Flash-SMS*, Binär-SMS, UTF-8-SMS *alle mit Stern markierten Begriffe werden am Ende des Dokuments genauer erläutert Inhalt 1. Schnittstellen zum Versand einzelner SMS (HTTP/HTTPS, SMTP) HTTP/HTTPS Löschen von zeitversetzten SMS HTTP Single Übergabe der Daten per (einzelne SMS per SMTP) Löschen von zeitversetzten SMS SMTP Single Schnittstellen zum Versand von Massen-SMS Interface zur Übergabe der Daten per (mehrere SMS per SMTP) HTTP2List Versand an eine bestehende Liste per HTTP Mail2List Versand an eine bestehende Liste per Versand von Binärnachrichten Nachrichtentyp binary Empfang von Antworten und Empfangsbestätigungen Sicherheit SMS-Empfang Hinweise GSM-Standard-Alphabet bit GSM-Standard-Alphabet Versionshistorie Fon/Fax: +49 (0) /79 Seite 1 von 19

2 1. Schnittstellen zum Versand einzelner SMS (HTTP/HTTPS, SMTP) 1.1 HTTP/HTTPS Die Ansprache der Gateways kann per SSL* erfolgen. Es sind die Methoden GET und POST erlaubt. URL: (load balanced, mit SSL) Im Störungsfall können Sie die folgende Adresse verwenden (nicht load balanced, mit SSL): URL: Parameter: Obligatorisch receiver sender msg id pw time msgtype Optional useraccount tarif test=1 Empfängernummer, internationales Format Absenderkennung (Wird im Tarif Basic überschrieben) 11 Zeichen alphanumerisch oder 16 Zeichen numerisch, URL- Encoded Erlaubt sind laut Spezifikation lediglich die Zeichen a-z, A-Z und 0-9. Kein Leerzeichen, Bindestriche o.ä. Wenn auf die SMS geantwortet werden soll, muss eine gültige Empfängernummer als Absenderkennung gesetzt werden. SMS-Text Übergabe an die Schnittstelle erfolgt im Zeichenformat ISO /15, URL-Encoded Erlaubte Zeichen siehe GSM Standard Alphabet im Anhang Die Zeichen Anzahl pro SMS beträgt 160 Zeichen. Einige Sonderzeichen werden 2fach gezählt. Siehe Hinweise und GSM Standard Alphabet Account-ID Passwort des Accounts URL kodiert wenn Sonderzeichen verwendet werden Auslieferungszeit bei zeitversetztem Versand Format hhmmddmmyyyy 0= Versand erfolgt sofort, ohne Zeitversatz Nachrichtentyp t= Text-SMS mit 160 Zeichen, Nachricht wird nach 160 Zeichen abgeschnitten c = überlange SMS* f = Flash-SMS* utf8 = Nachricht im UTF-8 Format. UTF-8-Zeichenanzahl pro SMS=70 Kostenstellen des Kunden zur Einzelabrechnung seiner Unterkunden. Aufstellung erfolgt auf der Rechnung Freischaltung erfolgt pro Kundenaccount über unseren Support Im Kombitarif muss hier der gewünschte Tarif angegebene werden OA = Tarif Basic MA = Tarif Economy PM = Tarif Quality Schnittstellentest Es wird keine SMS erzeugt, jedoch die entsprechende Antwort vom Server zurückgegeben. Fon/Fax: +49 (0) /79 Seite 2 von 19

3 getid=1 countmsg=1 getlimit=1 Sie erhalten als Rückgabewert zusätzlich die Nachrichten-ID, welche die übermittelte Nachricht identifiziert. Sie erhalten als Rückgabewert zusätzlich die Anzahl der berechneten Nachrichten Sie erhalten als Rückgabewert zusätzlich das Restvolumen, das Ihnen auf Ihrem Account noch zur Verfügung steht (Nur bei Prepaid-Accounts) getstatus=1 Es wird für die versendete SMS ein Statusreport (DLR) angefordert (siehe Punkt 5.) *siehe Hinweise am Ende des Dokuments Beispiel: =testtext&id=11111&pw=pass&time= &msgtype=t&getid=1&countmsg=1 Rückantwort für den o.g. Beispielaufruf: OK ( , 1 messages submitted) Im Fehlerfall erhalten Sie z.b.: access error (invalid user) (0 messages submitted) Fehlermeldungen: access error limit error format error no content content not allowed sender not allowed account disabled Zugriffsfehler invalid user =Account-ID oder Passwort falsch invalid ip = IP Restriktion, IP nicht in Whitelist limit Guthaben-Fehler ohne Angabe = Paket Guthaben aufgebraucht MONTH, DAY,HOUR= monatliches, tägliches, stündliches, Sendelimit erreicht IP, NUMBER = monatliches Limit für IP, Empfängernummer erreicht Empfängernummer nicht erlaubt oder ungültig empty = kein Empfänger angegeben INT = internationaler Versand nicht möglich length empf = Empfängernummer zu lang / zu kurz Kein SMS-Text angegeben SMS-Text enthält unzulässigen Inhalt Absenderkennung nicht zulässig, z.b. Kurzwahlnummern Account wurde gesperrt Test der Schnittstelle: Bei der Anmeldung auf erhalten Sie als Neukunde 10 Test SMS Fon/Fax: +49 (0) /79 Seite 3 von 19

4 1.2 Löschen von zeitversetzten SMS HTTP Single Um eine bereits gesendete, zeitversetzte SMS wieder zu löschen wird die URL: aufgerufen. Parameter: accountid password msgid Account-ID Passwort des Accounts Nachrichten-ID der SMS. Diese wird mit dem Parameter getid=1 beim Versand ausgegeben Rückgabewerte: Ok parameter error (msgid not in database) access error (invalid user) SMS wurde erfolgreich gelöscht Übergebene MsgId nicht gefunden fehlerhafte Zugangsdaten (accountid, password) 1.3 Übergabe der Daten per (einzelne SMS per SMTP) Eingehende s an der Zieladresse werden im spezifizierten Format weiterverarbeitet. Die enthält Passwort und Daten zu Empfänger, Sendezeit, Absenderkennung und Text. Bitte beachten Sie, dass Ihre im Textformat(text/plain) gesendet wird, HTML-Mails können nicht verarbeitet werden. Zieladresse: Betreff: Sendezeit;Absender;Empfänger;Passwort;AccountID;Typ;Kostenstelle(optional);Tarif(optional) (Parameter getrennt durch Semikolon) Body: SMS-Text* Parameter: Obligatorisch Sendezeit Absender Empfänger Auslieferungszeit bei zeitversetztem Versand Format hhmmddmmyyyy 0= Versand erfolgt sofort, ohne Zeitversatz Absenderkennung 11 Zeichen alphanumerisch oder 16 Zeichen numerisch, URL- Encoded Erlaubt sind laut Spezifikation lediglich die Zeichen a-z, A-Z und 0-9. Kein Leerzeichen, Bindestriche o.ä. Wenn auf die SMS geantwortet werden soll, muss eine gültige Empfängernummer als Absenderkennung gesetzt werden. Empfängernummer, internationales Format Fon/Fax: +49 (0) /79 Seite 4 von 19

5 Passwort AccountID Typ Optional Kostenstelle Tarif Passwort des Accounts Account-ID Nachrichtentyp t= Text-SMS mit 160 Zeichen, Nachricht wird nach 160 Zeichen abgeschnitten c = überlange SMS* f = Flash-SMS* Kostenstelle des Kunden zur Einzelabrechnung seiner Unterkunden. Aufstellung erfolgt auf der Rechnung Freischaltung erfolgt pro Kundenaccount über unseren Support Im Kombitarif muss hier der gewünschte Tarif angegebene werden OA = Tarif Basic MA = Tarif Economy PM = Tarif Quality HINWEIS: Wird Tarif verwendet, dann MUSS das Semikolon für Kostenstelle gesetzt werden. * siehe Hinweise am Ende des Dokuments Beispiel: Betreff: ;SMS-Info; ;pass;1111;t;1234(optional);PM(optional) Body: Dies ist eine Testsms Hinweis: Alle obligatorischen Parameter sind zwingend anzugeben, ungültiges Zeitformat, abgelaufene Zeit oder 0 werden ignoriert, die Nachricht wird dann sofort gesendet. Beachten Sie bitte, dass ein Zeilenumbruch zwei Zeichen in der SMS entspricht. Rückantwort: Als Bestätigung erhalten Sie eine an die im Account hinterlegte adresse für Fehler und Erfolgsmeldungen im folgenden Format: Absender: Im Erfolgsfall: Betreff: success sms gateway Body: OK TIME: :38:12 TO: FROM: MSG: Test SMTP Single MSGID: Im Fehlerfall: Betreff: error sms gateway Body: ERROR: format error TIME: :35:31 TO: FROM: MSG: Hallo Welt. MSGID: Fon/Fax: +49 (0) /79 Seite 5 von 19

6 Fehlermeldungen: mail error access error limit error format error no content content not allowed sender not allowed account disabled Fehler beim Lesen der subject = Betreffzeile ist ungültig Zugriffsfehler invalid user =Account-ID oder Passwort falsch invalid sender = -Adresse nicht in Whitelist no tarif = Kein Tarif angegeben (nur im KOMBI Tarif) Guthaben-Fehler ohne Angabe = Paket Guthaben aufgebraucht MONTH, DAY,HOUR= monatliches, tägliches, stündliches, Sendelimit erreicht IP, NUMBER = monatliches Limit für IP, Empfängernummer erreicht Empfängernummer nicht erlaubt oder ungültig empty = kein Empfänger angegeben INT = internationaler Versand nicht möglich length empf = Empfängernummer zu lang / zu kurz Kein SMS-Text angegeben SMS-Text enthält unzulässigen Inhalt Absenderkennung nicht zulässig, z.b. Kurzwahlnummern Account wurde gesperrt Test der Schnittstelle: Bei der Anmeldung auf erhalten Sie als Neukunde 10 Test - SMS 1.4 Löschen von zeitversetzten SMS SMTP Single Um eine bereits gesendete, zeitversetzte SMS wieder zu löschen, wird eine an folgende Adresse gesendet: single@massenversand.de Betreff: delete;passwort;accountid;msgid (getrennt durch Semikolon) Body: leer Parameter: Passwort AccountID msgid Passwort des Accounts Account-ID Nachrichten-ID der SMS. Diese erhalten Sie nach erfolgreichem Einstellen der SMS in der Bestätigungs- . Fon/Fax: +49 (0) /79 Seite 6 von 19

7 Beispiel: Betreff: delete;xxxxxx; ;56789 Body: [leer] Rückantwort: Als Bestätigung erhalten Sie eine an die im Account hinterlegte adresse für Fehler und Erfolgsmeldungen im folgenden Format: Absender: Subject="gateway status / deleted message" TIME: Zeitpunkt des Löschversuchs STATUS: OK, message deleted Error, message not deleted MSGID: zum Löschen übergebene Message-ID ERROR: Fehlerbeschreibung Fon/Fax: +49 (0) /79 Seite 7 von 19

8 2. Schnittstellen zum Versand von Massen-SMS 2.1 Interface zur Übergabe der Daten per (mehrere SMS per SMTP) Eingehende s an der Zieladresse werden im spezifizierten Format weiterverarbeitet. Die enthält Passwort und Angaben zur Sendezeit, Absenderkennung, Text sowie alle Empfängerdaten in Form einer Text- oder CSV-Datei im Anhang. Es besteht die Möglichkeit zur Personalisierung der SMS. Bitte beachten Sie, dass Ihre im Textformat(text/plain) gesendet wird, HTML-Mails können nicht verarbeitet werden. Zieladresse: Format: Betreff: Sendezeit;Absender;Passwort;AccountID;Typ;Kostenstelle(optional) ;Tarif(optional) (Parameter getrennt durch Semikolon) Body: SMS-Text mit Platzhaltern für die Personalisierungsdaten* Anhang: CSV-Datei mit den Empfängernummern und Personalisierungsdaten Parameter: Obligatorisch Sendezeit Absender Passwort AccountID Typ Optional Kostenstelle Tarif Auslieferungszeit bei zeitversetztem Versand Format hhmmddmmyyyy 0= Versand erfolgt sofort, ohne Zeitversatz Absenderkennung (Muss gesetzt werden, wird im Tarif Basic überschrieben) 11 Zeichen alphanumerisch oder 16 Zeichen numerisch, URL- Encoded Erlaubt sind laut Spezifikation lediglich die Zeichen a-z, A-Z und 0-9. Kein Leerzeichen, Bindestriche o.ä. Wenn auf die SMS geantwortet werden soll, muss eine gültige Empfängernummer als Absenderkennung gesetzt werden. Passwort des Accounts Account-ID Nachrichtentyp t= Text-SMS mit 160 Zeichen, Nachricht wird nach 160 Zeichen abgeschnitten c = überlange SMS* f = Flash-SMS* Kostenstelle des Kunden zur Einzelabrechnung seiner Unterkunden. Aufstellung erfolgt auf der Rechnung Freischaltung erfolgt pro Kundenaccount über unseren Support Im Kombitarif muss hier der gewünschte Tarif angegebene werden OA = Tarif Basic MA = Tarif Economy PM = Tarif Quality HINWEIS: Wird Tarif verwendet, dann MUSS das Semikolon für Kostenstelle gesetzt werden. Fon/Fax: +49 (0) /79 Seite 8 von 19

9 -Text: Der Body der enthält den Text der zu versendenden SMS. Es gibt standardmäßig fünf Platzhalter für Personalisierungsfelder, die folgendes Format haben müssen: %FELD1%, %FELD2%,... %FELD5% Die Felder werden der Reihe nach durch die Personalisierungsdaten im Dateianhang ersetzt. Auf Absprache können weitere Felder hinzugefügt werden. Die Verwendung der Felder ist optional. Dateianhang: Der Dateianhang besteht aus einer Datei im Text- oder CSV-Format, in der die Empfängerdaten, durch Semikolon getrennt, eingetragen werden. Jede Zeile entspricht einer SMS. Die Empfängerdaten werden in folgendem Format angegeben: Empfängernummer;%FELD1%;%FELD2%;%FELD3%,%FELD4%,%FELD5% In den Feldern %FELD1% bis %FELD5% befinden sich die Daten, welche an Stelle der Platzhalterzeichen eingesetzt werden. Diese Felder müssen nicht gesetzt werden, wenn keine Personalisierung erfolgen soll. Es ist möglich, lediglich die Empfängernummer anzugeben. Beachten Sie bitte, dass die Empfängernummern internationalen Format vorliegen. Beispiele: Betreff: ;smsinfo;pass;1111;t Body: Guten Tag %FELD1% %FELD2% %FELD3%, Willkommen bei sms-info. Anhang: beispiel.csv mit diesem Inhalt: ;Herr;Max;Mustermann ;Herr;Andreas;Meier ;Frau;Cornelia;Schulz Erklärung: Diese SMS wird am um 12:30 an die eingetragenen Empfänger versendet. Der Text der ersten SMS lautet: Guten Tag Herr Max Mustermann, Willkommen bei sms-info. Betreff: 0;smsinfo;pass;1111;t;12345(optional);PM(optional) Body: Hallo, das heute Treffen findet heute wie geplant statt. Anhang: beispiel.csv mit diesem Inhalt: Erklärung: Diese SMS wird sofort versendet, eine Personalisierung findet nicht statt. Der Text der ersten SMS lautet: Hallo, das heute Treffen findet heute wie geplant statt. Rückantwort: Als Bestätigung erhalten Sie eine an die im Account hinterlegte adresse für Fehler und Erfolgsmeldungen im folgenden Format: Absender: Fon/Fax: +49 (0) /79 Seite 9 von 19

10 Im Erfolgsfall: Betreff: success sms gateway Body: OK Auftrags-Nr.: Anzahl Empfänger: 2 Text: Info SMS für alle TIME: :24:29 FROM: smsinfo Im Fehlerfall: Betreff: error sms gateway Body: ERROR: format error (no receivers attached) Text: Hallo Welt. TIME: :35:31 FROM: Fehlermeldungen: mail error access error limit error format error no content content not allowed sender not allowed account disabled Fehler beim Lesen der subject = Betreffzeile ist ungültig Zugriffsfehler invalid user =Account-ID oder Passwort falsch invalid sender = -Adresse nicht in Whitelist no tarif = Kein Tarif angegeben (nur im KOMBI Tarif) Guthaben-Fehler ohne Angabe = Paket Guthaben aufgebraucht MONTH, DAY,HOUR= monatliches, tägliches, stündliches, Sendelimit erreicht IP, NUMBER = monatliches Limit für IP, Empfängernummer erreicht Empfängernummer nicht erlaubt oder ungültig Empty list = kein Empfänger angegeben no receivers attached = kein Anhang mit Empfängern Kein SMS-Text angegeben SMS-Text enthält unzulässigen Inhalt Absenderkennung nicht zulässig, z.b. Kurzwahlnummern Account wurde gesperrt Fon/Fax: +49 (0) /79 Seite 10 von 19

11 2.2 HTTP2List Versand an eine bestehende Liste per HTTP Im Online-Zugang können Sie mehrere Listen anlegen und dort Nummern bzw. zusätzliche Daten wie Vorname, Nachname, Geburtsdatum etc. eintragen. Der Versand kann anschließend per http-request an folgende URL ausgelöst werden: Parameter: text sttm sender pw accountid listenid Text der Nachricht Auslieferzeit bei zeitversetztem Senden im Format hhmmddmmyyyy Verwenden Sie die 0, wenn der Versand sofort erfolgen soll. 11 Zeichen alphanumerisch oder 16 Zeichen numerisch Erlaubt sind die Zeichen a-z, A-Z und 0-9 Passwort des Accounts Ihre Account-ID für den Online-Zugang Die ListenID der zu versendenden Liste, Sie finden diese ListenID im Online- Zugang nach Auswahl der gewünschten Liste. Beispiel: &sttm= &sender=test&pw=xxx&accountid= &listenid= Antwort: Als Antwort erhalten Sie beim erfolgreichen Request den Serverstatus 200 sowie den Antwortstring OK. Anderenfalls erhalten Sie den Antwortstring ERROR mit Fehlercode. Fehlermeldungen: access error limit error empty list no content content not allowed sender not allowed account disabled Zugriffsfehler invalid user =Account-ID oder Passwort falsch invalid ip = IP Restriktion, IP nicht in Whitelist Guthaben-Fehler ohne Angabe = Paket Guthaben aufgebraucht MONTH, DAY,HOUR= monatliches, tägliches, stündliches, Sendelimit erreicht IP, NUMBER = monatliches Limit für IP, Empfängernummer erreicht Empfängerliste ist leer oder existiert nicht Kein SMS-Text angegeben SMS-Text enthält unzulässigen Inhalt Absenderkennung nicht zulässig, z.b. Kurzwahlnummern Account wurde gesperrt Fon/Fax: +49 (0) /79 Seite 11 von 19

12 2.3 Mail2List Versand an eine bestehende Liste per Im Online-Zugang können Sie mehrere Listen anlegen und dort Nummern bzw. zusätzliche Daten wie Vorname, Nachname, Geburtsdatum etc. eintragen. Der Versand kann anschließend per an folgende Mailadresse ausgelöst werden: Den Betreff der formatieren Sie bitte mit folgenden 5 Feldern (getrennt durch Semikolon): Format Betreff: Sendezeit;Absender;Passwort;AccountID;ListenID Trennung: durch Semikolon Body: SMS-Text mit Platzhaltern für optionale Personalisierungsdaten Parameter Betreff: Sendezeit Absender Passwort Auslieferzeit bei zeitversetztem Senden im Format hhmmddmmyyyy Verwenden Sie die 0, wenn der Versand sofort erfolgen soll. Absenderkennung (Muss gesetzt werden, wird im Tarif Basic überschrieben) 11 Zeichen alphanumerisch oder 16 Zeichen numerisch, URL- Encoded Erlaubt sind laut Spezifikation lediglich die Zeichen a-z, A-Z und 0-9. Kein Leerzeichen, Bindestriche o.ä. Wenn auf die SMS geantwortet werden soll, muss eine gültige Empfängernummer als Absenderkennung gesetzt werden. Passwort des Accounts AccountID Account-ID ListenID Die ListenID der zu versendenden Liste, Sie finden diese ListenID im Online- Zugang nach Auswahl der gewünschten Liste. -Text: Der Body der enthält den Text der zu versendenden SMS. Sie können Platzhalter für Personalisierungsfelder einfügen, die den Namen der entsprechenden Felder in Ihrer Empfängerliste haben müssen und in <> eingerahmt werden. Bsp.: <Vorname> Die Felder werden durch die Personalisierungsdaten in der gewählten Empfängerliste ersetzt. Die Verwendung der Felder ist optional. Beispiel-Betreff: Zeitversetzter Versand: ;TestSender;xxxxx; ; Sofortiger Versand: 0;TestSender;xxxxx; ; Fon/Fax: +49 (0) /79 Seite 12 von 19

13 3. Versand von Binärnachrichten 3.1 Nachrichtentyp binary Die Verwendung des Nachrichtentyps binary ermöglicht es, die einzelnen Parameter einer (Binär-)Nachricht selbst zu beeinflussen. Es werden dabei die zu versendenden Inhalte bereits kodiert übergeben. Dabei ist die Angabe folgender Werte notwendig: DCS (Data Coding Scheme) UDH (User Data Header) Msg (Inhalt der Nachricht) Der eigentliche Inhalt der Binärnachricht wird mit dem Parameter msg übergeben. Folgende Werte für DCS und UDH sind möglich: Parameter DCS 240 DCS für Flash-SMS (keine Binärnachricht) 241 DCS für Text-SMS (keine Binärnachricht) 245 DCS für Binärnachrichten Beispiele für den Parameter UDH 05040B8423F A0000 Wap-Push-SMS Bildnachricht für Nokia Klingelton für Nokia Betreiberlogo für Nokia Beispiel Wap-Push: A0045C60B A2F2F E6D E E642E64652F736D F5F E7A2F73616D706C65732F6D756C F6C6F722E4A D D &dcs=245&udh=05040B8423F0&id=100001&pw=xxxxx&msgt ype=binary Fon/Fax: +49 (0) /79 Seite 13 von 19

14 4. Empfang von Antworten und Empfangsbestätigungen Das SMS-Gateway bietet die Möglichkeit, eingehende Antworten und Empfangsbestätigung von versendeten SMS zu empfangen und per oder HTTP-GET weiterzuleiten. Die adresse ODER die URL für die Weiterleitung kann unter im Kundenbereich unter Einstellungen hinterlegt werden. Bitte schließen Sie eine URL stets mit einem? oder, wenn Sie weitere eigene Parameter angeben möchten, mit einem & ab. Beispiel: oder Um eine Antwort auf eine SMS im Tarif Economy oder Quality zu empfangen muss beim Versand eine gültige Empfangsnummer als Absenderkennung gesetzt werden. Dafür benötigen Sie: eine exklusive Empfangsnummer (kontaktieren Sie uns hierzu bitte) die Empfangsnummer unseres Systems*: Der http-aufruf enthält folgende Parameter: datereceived Empfangszeit, Format: DD.MM.YYYY HH:MM:SS sender msg msgid Absender der Antwort Text der Antwort ID der Nachricht (entspricht der ID, die beim Versand abgefragt werden kann) state Art der Nachricht (2 3) 2 -> Status Report Request (Empfangsbestätigung) 3 -> Text-Antwort des Empfängers dlr Statusreport ( )* 1: die SMS ist am Endgerät angekommen 2: die SMS wurde am SMSC des Netzbetreibers gespeichert, es folgen weitere Auslieferungsversuche 3: die SMS kann nicht zugestellt werden (Fehler am Endgerät, ungültige Nummer etc.) 4: es werden keine weiteren Versuche unternommen, die SMS zuzustellen Beispiel ( = Beispiel für Ihre Url ): Antwort&msgID=10001&state=3 Die enthält folgende Parameter: RESPONSE: ORIGINAL MESSAGE: Text der Antwort Text der Originalnachricht, auf die geantwortet wurde STATE: Art der Nachricht (2 3) 2 -> Status Report Request (Empfangsbestätigung) 3 -> Text-Antwort des Empfängers SENDER: Absender der Antwort RECEIVED: Empfangszeit, Format: DD.MM.YYYY HH:MM:SS MSGID: ID der Nachricht (entspricht der ID, die beim Versand abgefragt werden kann) DLR: Statusbericht ( ), siehe http-aufruf Fon/Fax: +49 (0) /79 Seite 14 von 19

15 4.1 Sicherheit SMS-Empfang Der Sicherheitsaspekt kann zusätzlich durch die Einschränkung auf spezifizierte Mail-Absender- bzw. IP- Adressen berücksichtigt werden. Weiterhin kann ein von Ihnen definierter Parameter genannt werden, welcher beim Aufruf zusätzlich übergeben wird. Für die Übertragungssicherheit können sie uns auch eine SSL-Domain(https) nennen. Bei der Übergabe per wird die TLS Verschlüsselung verwendet. 5. Hinweise Flash-SMS: Flash SMS werden nur teilweise von den Endgeräten unterstützt. Eine Flash-SMS wird sofort auf dem Display dargestellt und kann oft nicht gespeichert werden. Überlange SMS: Es werden jeweils 7 Zeichen pro gezählter SMS für Verknüpfungsinformationen verwendet, so dass bereits aller 153 Zeichen eine neue SMS gezählt/berechnet wird. 2 SMS entsprechen also 306 verfügbaren Zeichen für Ihren Text. Überlange SMS werden im Tarif Basic und Economy gegebenenfalls in mehrere SMS aufgeteilt. SSL: Die http Schnittstelle kann per HTTPS angesprochen werden, manche Implementierungen benötigen dafür das aktuelle Root-Zertifikat. Dieses senden wir Ihnen auf Nachfrage gerne zu. Empfangsnummer unseres Systems: Die genannte Empfangsnummer wird von mehreren Accounts genutzt, bzw. automatisch eingetragen wenn die Absenderkennung im Tarif Economy oder Quality nicht gesetzt wurde. Auf diese Nummer kann geantwortet werden, die SMS wird dann über ein Session-basiertes System der vorangegangenen versandten SMS zugeordnet. Hier kann es in vereinzelten Fällen zu Mehrfachzuordnungen kommen. Wir empfehlen Ihnen für ein sicheres Dialogsystem eine exklusive Empfangsnummer. Kontaktieren Sie hierzu unsere Servicemitarbeiter. DLR / Statusreport: Der DLR(DeliveryReport) enthält Informationen über den Auslieferung der SMS. Bitte beachten Sie dass die Übermittlung des DLR bis zu 48h dauern kann. Der DLR Status 2: Die Nachricht wurde gespeichert, kann mehrere Ursachen haben: Das Endgerät ist ausgeschaltet Das Endgerät hat keinen Empfang Das Endgerät hat keinen Speicherplatz für die SMS frei Der Empfänger befindet sich in einem Roamingnetz ohne Roamingverträge Das Endgerät ist nicht korrekt in die Funkzelle eingebucht Die Funkzelle ist überlastet (Jahreswechsel, Großveranstaltungen) Die Funkzelle ist gestört Je nach Provider sind die DLR unterschiedlich, der Wortlaut sowie die enthaltenen Details können sich jederzeit ändern. Einige Provider liefern mehrere DLR pro SMS Versand aus, z.b. wenn die Nachricht gespeichert wurde und wenn die Nachricht dann erfolgreich ausgeliefert wurde. Der Provider Telefonica-O2 liefert im Tarif Quality (SMSC-Direktanbindung) keine DLR aus. Fon/Fax: +49 (0) /79 Seite 15 von 19

16 6. GSM-Standard-Alphabet Eine Standard-SMS kann bis zu 160 Zeichen beinhalten. Diese Zeichen müssen jedoch Bestandteil des 7-bit GSM-Standard-Alphabetes sein (festgelegt in GSM 3.38), welches Sie im Anschluss finden. Hier sind alle verwendbaren Zeichen aufgeführt. Beispielsweise gehören deutsche Umlaute mit zum Zeichenumfang. Sollen Zeichen verwendet werden, die nicht in dieser Tabelle aufgeführt sind, muss eine sogenannte Unicode-SMS versendet werden, die Länge einer SMS verringert sich dann auf 70 Zeichen. (Nur über die http-schnittstelle mit dem Parameter t=utf8 möglich) Bitte beachten Sie, dass die folgenden Zeichen im GSM-Zeichensatz die doppelte Länge beanspruchen und daher innerhalb des SMS-Textes auch als 2 Zeichen berechnet werden: ^ { } [ ] \ ~ (Vollständigkeit ohne Gewähr, siehe Tabelle) bit GSM-Standard-Alphabet Hex Dec Character name Zeichen Berechnete Zeichen COMMERCIAL POUND SIGN DOLLAR SIGN $ YEN SIGN LATIN SMALL LETTER E WITH GRAVE è LATIN SMALL LETTER E WITH ACUTE é LATIN SMALL LETTER U WITH GRAVE ù LATIN SMALL LETTER I WITH GRAVE ì LATIN SMALL LETTER O WITH GRAVE ò LATIN CAPITAL LETTER C WITH CEDILLA Ç 1 0 0A 10 LINE FEED 1 0 0B 11 LATIN CAPITAL LETTER O WITH STROKE Ø 1 0 0C 12 LATIN SMALL LETTER O WITH STROKE ø 1 0 0D 13 CARRIAGE RETURN 1 0 0E 14 LATIN CAPITAL LETTER A WITH RING ABOVE Å 1 0 0F 15 LATIN SMALL LETTER A WITH RING ABOVE å GREEK CAPITAL LETTER DELTA Δ LOW LINE _ GREEK CAPITAL LETTER PHI Φ GREEK CAPITAL LETTER GAMMA Γ GREEK CAPITAL LETTER LAMBDA Λ GREEK CAPITAL LETTER OMEGA Ω GREEK CAPITAL LETTER PI Π GREEK CAPITAL LETTER PSI Ψ GREEK CAPITAL LETTER SIGMA Σ GREEK CAPITAL LETTER THETA Θ 1 0 1A 26 GREEK CAPITAL LETTER XI Ξ 1 0 1B 27 ESCAPE TO EXTENSION TABLE 1 0 1B0A FORM FEED 2 0 1B CIRCUMFLEX ACCENT ^ 2 0 1B LEFT CURLY BRACKET { 2 0 1B RIGHT CURLY BRACKET } 2 Fon/Fax: +49 (0) /79 Seite 16 von 19

17 0 1B2F REVERSE SOLIDUS (BACKSLASH) \ 2 0 1B3C LEFT SQUARE BRACKET [ 2 0x1B3D TILDE ~ 2 0x1B3E RIGHT SQUARE BRACKET ] 2 0 1B VERTICAL BAR 2 0 1B EURO SIGN 2 0 1C 28 LATIN CAPITAL LETTER AE Æ 1 0 1D 29 LATIN SMALL LETTER AE æ 1 0 1E 30 LATIN SMALL LETTER SHARP S (German) ß 1 0 1F 31 LATIN CAPITAL LETTER E WITH ACUTE É SPACE EXCLAMATION MARK! QUOTATION MARK NUMBER SIGN # CURRENCY SIGN PERCENT SIGN % AMPERSAND & APOSTROPHE LEFT PARENTHESIS ( RIGHT PARENTHESIS ) 1 0 2A 42 ASTERISK * 1 0 2B 43 PLUS SIGN C 44 COMMA, 1 0 2D 45 HYPHEN-MINUS E 46 FULL STOP F 47 SOLIDUS (SLASH) / DIGIT ZERO DIGIT ONE DIGIT TWO DIGIT THREE DIGIT FOUR DIGIT FIVE DIGIT SIX DIGIT SEVEN DIGIT EIGHT DIGIT NINE A 58 COLON : 1 0 3B 59 SEMICOLON ; 1 0 3C 60 LESS-THAN SIGN < 1 0 3D 61 EQUALS SIGN = 1 0 3E 62 GREATER-THAN SIGN > 1 0 3F 63 QUESTION MARK? INVERTED EXCLAMATION MARK LATIN CAPITAL LETTER A A LATIN CAPITAL LETTER B B LATIN CAPITAL LETTER C C LATIN CAPITAL LETTER D D LATIN CAPITAL LETTER E E LATIN CAPITAL LETTER F F LATIN CAPITAL LETTER G G 1 Fon/Fax: +49 (0) /79 Seite 17 von 19

18 LATIN CAPITAL LETTER H H LATIN CAPITAL LETTER I I 1 0 4A 74 LATIN CAPITAL LETTER J J 1 0 4B 75 LATIN CAPITAL LETTER K K 1 0 4C 76 LATIN CAPITAL LETTER L L 1 0 4D 77 LATIN CAPITAL LETTER M M 1 0 4E 78 LATIN CAPITAL LETTER N N 1 0 4F 79 LATIN CAPITAL LETTER O O LATIN CAPITAL LETTER P P LATIN CAPITAL LETTER Q Q LATIN CAPITAL LETTER R R LATIN CAPITAL LETTER S S LATIN CAPITAL LETTER T T LATIN CAPITAL LETTER U U LATIN CAPITAL LETTER V V LATIN CAPITAL LETTER W W LATIN CAPITAL LETTER X X LATIN CAPITAL LETTER Y Y 1 0 5A 90 LATIN CAPITAL LETTER Z Z 1 0 5B 91 LATIN CAPITAL LETTER A WITH DIAERESIS Ä 1 0 5C 92 LATIN CAPITAL LETTER O WITH DIAERESIS Ö 1 0 5D 93 LATIN CAPITAL LETTER N WITH TILDE Ñ 1 0 5E 94 LATIN CAPITAL LETTER U WITH DIAERESIS Ü 1 0 5F 95 SECTION SIGN INVERTED QUESTION MARK LATIN SMALL LETTER A a LATIN SMALL LETTER B b LATIN SMALL LETTER C c LATIN SMALL LETTER D d LATIN SMALL LETTER E e LATIN SMALL LETTER F f LATIN SMALL LETTER G g LATIN SMALL LETTER H h LATIN SMALL LETTER I i 1 0 6A 106 LATIN SMALL LETTER J j 1 0 6B 107 LATIN SMALL LETTER K k 1 0 6C 108 LATIN SMALL LETTER L l 1 0 6D 109 LATIN SMALL LETTER M m 1 0 6E 110 LATIN SMALL LETTER N n 1 0 6F 111 LATIN SMALL LETTER O o LATIN SMALL LETTER P p LATIN SMALL LETTER Q q LATIN SMALL LETTER R r LATIN SMALL LETTER S s LATIN SMALL LETTER T t LATIN SMALL LETTER U u LATIN SMALL LETTER V v LATIN SMALL LETTER W w LATIN SMALL LETTER X x LATIN SMALL LETTER Y y 1 Fon/Fax: +49 (0) /79 Seite 18 von 19

19 0 7A 122 LATIN SMALL LETTER Z z 1 0 7B 123 LATIN SMALL LETTER A WITH DIAERESIS ä 1 0 7C 124 LATIN SMALL LETTER O WITH DIAERESIS ö 1 0 7D 125 LATIN SMALL LETTER N WITH TILDE ñ 1 0 7E 126 LATIN SMALL LETTER U WITH DIAERESIS ü 1 0 7F 127 LATIN SMALL LETTER A WITH GRAVE à 1 7. Versionshistorie Version Datum Änderung Verantwortlich Neues Layout, Grundlegende Überarbeitung, Korrektur von Tarifnamen und Beispielen Parameter Tarif hinzugefügt, Aktualisierung/Anpassung SH Mail2list und http2list aufgenommen HH GSM-Standard-Zeichensatz hinzugefügt HH Parameter dlr zur Übergabe des Status der DLR HH Löschen von zeitversetzten SMS HTTP/SMTP Single SH Ergänzung zu überlangen SMS HH Anpassung, neue Beispiele und Erläuterungen SH SSL für Gate2 und Gate3 HH Neue Gateway-URLs HH Parameter netid entfernt, Parameter useraccount hinzugefügt (Übergabe von Kostenstellen) Parameter getstatus=1 zur Abfrage von Statusreporten hinzugefügt msgtype=binary zum Versand von Binärnachrichten hinzugefügt Parameter getlimit=1 zur Abfrage des Restvolumens hinzugefügt Parameter test=1 für Schnittstellentest per http hinzugefügt HH Response per hinzugefügt HH msgtype=i hinzugefügt HH Schnittstellentest http, smtps hinzugefügt SH HH HH HH Fon/Fax: +49 (0) /79 Seite 19 von 19