Schnittstellen-Beschreibung:
Falls Sie nicht unser normales
Web-Interface oder unsere
HTTP(s)-Schnittstelle nutzen möchten, so steht Ihnen
dieses E-Mail to SMS Gateway zur Verfügung, um SMS Nachrichten einfach per E-Mail
aus Ihren Anwendungen heraus zu generieren.
Beim Versand von SMS per E-Mail müssen Sie zunächst ein normales Versandkonto
bei uns eröffnen. Mit den Zugangsdaten, die Sie dort erhalten, können Sie dann automatisch auch unsere
E-Mail to SMS Schnittstelle verwenden.
Ihre E-Mails müssen dabei ein vorgegebenes Format einhalten:
Beispiel E-Mail to SMS:
So muss der Message-Body der E-Mail aufgebaut sein:
(verwenden Sie text/plain, keine HTML-Mails! Betreff der Mail spielt keine Rolle.)
<user>ihr_username</user>
<pass>ihr_password</pass>
<text>
Hier steht Ihr Text für den Versand als SMS-Nachricht
</text>
<to>
01791234567 (Format für Versand innerhalb Deutschlands)
+491791234568 (Format für Versand mit internationaler Schreibweise nach Deutschland)
00491791234569 (Format für Versand mit internationaler Schreibweise nach Deutschland)
.... (hier stehen insgesamt bis zu 1.000 Empfänger)
</to>
{ weitere optionale Parameter: }
<from>absender</from> (Gewünschte Absenderkennung, Hinweise unten beachten!)
<multisms>2</multisms> (Versand von verketteten Massen-SMS, mehr Info: siehe unten)
<test>1</test> (Aktiviert den Testmodus. Es werden keine kostenpflichtigen SMS verschickt)
<reply>1</reply> (Aktiviert automatische Versandprotokolle per E-Mail an den Absender)
Basis-Funktion SMS-Versand:
Fügen Sie bitte an den Stellen
ihr_username und
ihr_password Ihre von uns erhaltenen Zugangsdaten ein.
Geben Sie als
text maximal 160 Zeichen ein und listen Sie unter
to bis zu 1.000 Empfänger in einem der
oben genannten Rufnummern-Formate auf. Der Versand nach Deutschland und ganz Europa funktioniert problemlos. Auch
die allermeisten Länder international erreichen Sie über uns in Sekundenschnelle.
Eine entsprechend formatierte E-Mail senden Sie dann bitte als plain-text an die Adresse:
mail@sms-gw.topconcepts.de.
Das war's schon - so einfach ist es - in wenigen Sekunden wird die SMS-Nachricht an den Empfänger zugestellt!
Hinweis: Während Sie testen und implementieren empfehlen sich u.U. die optionalen Parameter
reply und
test - siehe unten.
Optionale Parameter für den SMS-Versand:
Als Parameter
from können Sie eine beliebige Telefonnummer verwenden ODER eine alphanumerische Kennung,
die dann allerdings nur maximal 11 Zeichen lang sein darf. Wichtig: Der Parameter
from wird NUR unterstützt,
wenn Sie vorher die
Zusatzvereinbarung unterschrieben an uns gesendet haben.
Wird der
from Parameter nicht von Ihnen gesetzt (oder die Zusatzvereinbarung liegt noch nicht vor), wird solange
automatisch Ihre zur Anmeldung benutzte Handynummer als Absender eingetragen.
Mit
multisms (gültige Werte liegen zwischen 2-10) können Sie mehrere SMS zu einer Riesen-SMS verketten.
Ihr Nachrichten-Text darf dann statt normalerweise nur 160 Zeichen insgesamt "multisms*153 Zeichen" lang sein, also maximal
1530 Zeichen. Wird das rechnerische Maximum überschritten, oder werden ohne Verwendung von
multisms mehr als 160 Zeichen
eingetragen, dann wird der Rest Ihres Textes ohne Kommentar abgeschnitten und verworfen. Denken Sie daran, dass der Preis für
den Versand einer Riesen-SMS sich aus "SMS-Einzelversandpreis * multisms" errechnet, da technisch gesehen eine Riesen-SMS
aus mehreren Einzel-SMS zusammengesetzt wird.
Mit dem Parameter
test können Sie die Schnittstelle nach Herzenslust testen. Alle Funktionen und Status-Meldungen
sind exakt wie im echten Betrieb - mit dem einzigen Unterschied, dass noch keine kostenpflichtigen SMS verschickt werden.
Es empfiehlt sich den Test-Modus zusammen mit dem Parameter
reply zu verwenden, damit Sie sehen können, ob Ihre
Tests erfolgreich verlaufen.
Verwenden Sie den optionalen Parameter
reply, um ein automatisches Versendeprotokoll zu erhalten. Dies empfiehlt
sich auf jeden Fall, solange Sie testen. An den Absender der E-Mail geht dabei automatisch eine Nachricht, die
Aufschluss über den Versandstatus gibt.
Viel Spaß und Erfolg beim Ausprobieren!