Email2SMS-API

Email2SMS API - Ausführliche Spezifikationen
Version 2.0, gültig ab 19.10.2009
smstrade Email2SMS API - Spezifikationen
Um leicht automatisiert SMS-Nachrichten zu versenden, steht zusätzlich zum HTTP-Gateway eine
E-Mail-Schnittstelle zur Verfügung, die im folgenden dokumentiert wird.
Inhaltsverzeichnis
1. E-Mail-Schnittstelle
1.1 Empfänger-Rufnummer
1.2 Nachrichtentext
1.3 Weitere Parameter
.............................................................................
.............................................................................
.............................................................................
2
2
3
2. Beispiele
2.1 Variante 1
.............................................................................
2.2 Variante 2 - Einzelversand .............................................................................
2.3 Variante 2 - Massenversand ............................................................................
4
5
6
Seite 1 von 6
© CM Telecom Germany GmbH, Herriotstraβe 1, 60528 Frankfurt am Main, Deutschland
Email2SMS API - Ausführliche Spezifikationen
Version 2.0, gültig ab 19.10.2009
1. E-Mail-Schnittstelle
Die E-Mail-Schnittstelle bietet eine einfache Möglichkeit SMS-Text-Nachrichten zu versenden, indem
eine E-Mail mit bestimmtem Inhalt an das smstrade Email2SMS Gateway übermittelt wird. Bei
syntaktischen Fehlern wird eine Fehler-Mail an den Absender zurückgeschickt.
1.1 Empfänger-Rufnummer
Für die Angabe des Empfängers gibt es 2 Varianten:
Variante 1
E-Mail Adresse
[email protected]
[email protected]
[email protected]
Handynummer
01701234657
01701234657
01701234657
Variante 2
E-Mail Adresse
Handynummer
[email protected] Wird im Nachrichtenbody übergeben
1.2 Nachrichtentext
Der Text der SMS-Nachricht wird aus dem Betreff der E-Mail ausgelesen.
Es gelten folgende Richtlinien:
• Maximale Länge: 1530 Zeichen
• Bei einer Länge von mehr als 160 Zeichen werden SMS automatisch verkettet
Die E-Mail-Nachricht sollte UTF-8-encodiert an die Schnittstelle übermittelt werden.
MIME-Header, wie von Mozilla Thunderbird verwendet, werden automatisch dekodiert.
Absätze in der SMS Nachricht können Sie mit \n erzeugen.
Seite 2 von 6
© CM Telecom Germany GmbH, Herriotstraβe 1, 60528 Frankfurt am Main, Deutschland
Email2SMS API - Ausführliche Spezifikationen
Version 2.0, gültig ab 19.10.2009
1.3 Weitere Parameter
Im Inhalt bzw. Body der E-Mail-Nachricht befinden sich die Steuer-Befehle für den SMS Versand. Die
einzelnen Teile können durch ein Rautezeichen getrennt werden (#).
Wichtig: Die Nachricht muss als Text-Nachricht und darf nicht als HTML-Nachricht verfasst sein!
E-Mail-Clients wie Microsoft Outlook oder Mozilla Thunderbird haben eine Menü-Option, um die
Nachricht als "Text“ bzw. "Nur Text" zu versenden. Genauere Informationen entnehmen Sie bitte der
Dokumentation zu Ihrem Mailprogramm.
Der Body der Nachricht muss folgendes Format haben:
Variante 1 (Versand über [email protected])
#Key#Route #From#
Variante 2 (Versand über [email protected])
#Key#To#Route #From#
key
Parameter
Beschreibung
Ihr persönlicher Identifikationskey
Beispielwerte
abcdefghijklmnop
to
Ihren Gateway Key finden Sie im
Kundencenter unter dem Punkt "HTTP
Schnittstelle".
Empfänger der SMS getrennt durch Komma
00491701234567,00491711234567
from
Die Rufnummern der NachrichtenEmpfänger mit Landesvorwahl. Deutsche
Nummern können auch ohne Landescode
übergeben werden.
Absenderkennung
route
Bei Gold und Direct SMS können Sie eine
eigene individuelle Absenderkennung
angeben. Diese darf 11 alpha-numerische
Zeichen oder bis zu 16 numerische Zeichen
beinhalten.
Versandroute
Jede SMS kann über eine der smstrade
Routen versendet werden. Weitere
Informationen über die Routen entnehmen
Sie bitte der Routenübersicht im
Kundencenter.
SMSTRADE
00491701234567
basic
gold
direct
Seite 3 von 6
© CM Telecom Germany GmbH, Herriotstraβe 1, 60528 Frankfurt am Main, Deutschland
Email2SMS API - Ausführliche Spezifikationen
Version 2.0, gültig ab 19.10.2009
2. Beispiele
2.1 Variante 1
Versand über [email protected]
Seite 4 von 6
© CM Telecom Germany GmbH, Herriotstraβe 1, 60528 Frankfurt am Main, Deutschland
Email2SMS API - Ausführliche Spezifikationen
Version 2.0, gültig ab 19.10.2009
2.2 Variante 2 - Einzelversand
Versand über [email protected]
Seite 5 von 6
© CM Telecom Germany GmbH, Herriotstraβe 1, 60528 Frankfurt am Main, Deutschland
Email2SMS API - Ausführliche Spezifikationen
Version 2.0, gültig ab 19.10.2009
2.3 Variante 2 - Massenversand
Versand über [email protected]
Seite 6 von 6
© CM Telecom Germany GmbH, Herriotstraβe 1, 60528 Frankfurt am Main, Deutschland