Versand von SMS via Email

Mit der Mail API verschicken Sie SMS direkt aus Ihrem Mailprogramm oder aus jeder Anwendung, die E-Mails versenden kann. Voraussetzung ist eine Mail-API-Konfiguration. Wie Sie sie anlegen, beschreibt der Artikel Einrichtung der Mail API.

Adresse

Jede Konfiguration hat eine feste Adresse, die Sie im Dashboard unter Entwickler -> API-Zugänge finden:

TOKEN@gateway.seven.io
PREFIX.TOKEN@gateway.seven.io

Den Token erzeugt seven, er bleibt fest. Den Prefix wählen Sie pro Mail frei: Alles vor dem letzten Punkt der Adresse ist der Prefix und wird über das Muster für den Adress-Prefix ausgewertet.

Ist das Muster für den Adress-Prefix {{to}}, geht eine Mail an 4917612345678.a1b2c3d4e5f6g7h8@gateway.seven.io an die Rufnummer 4917612345678. Statt einer Rufnummer können Sie auch einen Kontakt oder eine Gruppe aus Ihrem Adressbuch angeben.

Haben Sie in der Konfiguration die Option Adresse ohne Token zusätzlich erlauben aktiviert, genügt der Prefix allein: 4917612345678@gateway.seven.io.

Empfänger, Text und Absender

Wo in der Mail der Empfänger, der Nachrichtentext und der Absender stehen, legen Sie mit den Mustern der Konfiguration fest:

• Empfänger: über {{to}} im Prefix, im Betreff oder im Body. Fängt kein Muster den Empfänger, geht die SMS an den festen Empfänger aus der Konfiguration.
• Text: in der Standardeinstellung (Muster Body {{text}}) wird der gesamte Mailtext zur SMS. Mit Literaltext im Muster grenzen Sie den Text ab, z.B. (({{text}})), damit Signaturen nicht mitgeschickt werden.
• Absender: über {{from}} in einem Muster oder über den Absender der Nachricht aus der Konfiguration. Ist beides leer, gilt der Standardabsender Ihres Kontos.

Weitere Optionen wie den Versandzeitpunkt ({{delay}}), ein Label ({{label}}) oder eine Flash-SMS ({{flash}}) steuern Sie ebenfalls über Variablen in den Mustern. Steuerparameter im Betreff wie from= oder key= werden bei Konfigurationen mit fester Adresse nicht ausgewertet. Die vollständige Liste der Variablen finden Sie in der Mail-API-Dokumentation.

Ein Beispiel: Ein Monitoring-Tool schickt seine Meldung im Betreff an a1b2c3d4e5f6g7h8@gateway.seven.io. In der Konfiguration ist das Muster Betreff {{text}}, das Muster Body leer und als Empfänger fest Ihre Bereitschaftsnummer eingetragen. Aus dem Betreff CPU-Last kritisch auf srv-07 wird dann eine SMS mit genau diesem Text an die Bereitschaftsnummer.

Absenderadresse

Senden Sie immer von einem der erlaubten Absender der Konfiguration. Mails von anderen Adressen werden nicht verarbeitet. Ist für die Konfiguration die DMARC-Prüfung aktiv, muss Ihre Mail diese außerdem bestehen. Abgelehnte Mails sehen Sie mit Code 904 im Debugger.

Klassisches Format (Legacy-Konfigurationen)

Konfigurationen, die vor Einführung der festen Adresse angelegt wurden, sind im Dashboard mit Legacy gekennzeichnet und funktionieren unverändert weiter. Hier steuern Sie den Versand über Empfängerzeile und Betreff:

• Empfänger: Rufnummer vor @gateway.seven.io, z.B. 01761234567890@gateway.seven.io.
• Betreff: Befehle im Format parameter=wert, getrennt durch Leerzeichen, z.B. from=Blumenladen key=123456789. Werte mit Leerzeichen setzen Sie in Anführungszeichen: from="Blumen Haus". Ein to= im Betreff überschreibt die Empfängerzeile, so erreichen Sie z.B. auch Gruppen.
• Text: der Mailtext. Wenn Sie ihn in doppelte Rauten einfassen (##Dies ist Ihr Text##), wird nur der Teil dazwischen versendet.

Alle Parameter des klassischen Formats finden Sie in der Mail-API-Dokumentation.