Die Mail API erlaubt es Ihnen, von Ihrem Mailaccount aus SMS oder RCS-Nachrichten über unser Gateway zu versenden. Details zur Verwendung finden Sie in den Artikeln Versand von SMS via Email und Versand von RCS via Email.
Mail-API-Adresse anlegen
Öffnen Sie Entwickler -> API-Zugang. Die Seite listet alle REST-API-Keys, Mail-API-Adressen und SMPP-Verbindungen nebeneinander. Klicken Sie oben rechts auf Neu erstellen und wählen Sie Mail API.
Im Dialog Mail-API-Adresse erstellen konfigurieren Sie:
- Email-Sender: Die Mail-Adresse, von der Sie senden. Mit einer Wildcard können Sie auch eine ganze Domain freigeben, z.B.
*@seven.io. - Key: Ein Passwort, das als
key=Parameter bei jeder per Email versendeten SMS mitgesendet wird. Erlaubt sind Buchstaben, Ziffern und- _ $. Über Regenerate erzeugen Sie einen neuen Wert. - Error Mail (optional): Adresse, die Zustellfehler erhält. Standardmäßig wird die Sender-Adresse verwendet.
Mit Speichern legen Sie die Adresse an.
Weitere Mail-API-Einstellungen
Öffnen Sie Entwickler -> Einstellungen und klappen Sie den Bereich Mail API auf, um das Verhalten für alle Mail-API-Adressen zu verfeinern.
Maximale Zeichenzahl
Begrenzt die Body-Länge, damit versehentliche Signaturen oder Footer Ihre SMS-Kosten nicht in die Höhe treiben. 0 deaktiviert das Limit. Für noch engere Kontrolle umschließen Sie Ihre Nachricht mit doppelten Rauten (##Dies ist Ihr Text##) - alles ausserhalb wird vor dem Versand entfernt.
Signatur entfernen
Filtert Quote-Blöcke (> wie diese) heraus, bevor versendet wird.
Benachrichtigung bei Fehler
Aktiviert Benachrichtigungen per Email und/oder per HTTP-Push, wenn ein Email-to-SMS-Versuch fehlschlägt.
Sender in SMS einfügen
Optional wird ein Teil des Email-Senders an den SMS-Text vorne angehängt:
- Vollständige Adresse: z.B.
einuser@domain.de - Lokaler Teil (vor @): z.B.
einuser - Nicht anhängen: nichts wird vorangestellt
Standardabsender und RCS
Wenn Sie einen festen Absendernamen für all Ihre SMS möchten, legen Sie einen Standardabsender fest (bis zu 11 alphanumerische Zeichen). Antworten sind nur möglich, wenn der Absender eine Rufnummer ist. RCS-Nachrichten nutzen immer den Absendernamen, den Sie bei der Registrierung des Agenten angelegt haben.
Dokumentation
Vollständige Referenz und Beispiele in der Mail-API-Dokumentation.