Übersicht der E-Mail-Dienste

Ein E-Mail-Dienst ist die Verbindung zwischen Frontmail und einem E-Mail-Anbieter. Frontmail verschickt in Ihrem Namen nie E-Mails über die eigene Infrastruktur – es rendert Ihre Vorlage und übergibt die Nachricht an Ihren Anbieter. Zustellbarkeit, Absenderreputation und die Preise des Anbieters bleiben so unter Ihrer Kontrolle.

Unterstützte Anbieter

Anbieter	Typ	Geeignet für	Zustell-Webhooks
SMTP (Seznam, Zoho, eigener Server)	`smtp`	Bestehende Postfächer, eigene Mailserver	–
Mailgun	`mailgun`	Transaktionale E-Mails, Region EU oder US	✓
Amazon SES	`ses`	Hohe Volumen zu niedrigen Kosten, AWS-Nutzer	✓ (über SNS)
Postmark	`postmark`	Schnelle Zustellung transaktionaler E-Mails	✓
Mailjet	`mailjet`	Transaktionale E-Mails mit Sitz in der EU	✓
Brevo	`brevo`	Sitz in der EU, großzügiger kostenloser Tarif	✓
Resend	`resend`	Entwicklerfreundliche API	✓
Gmail (OAuth)	`gmail`	Private Postfächer und Google-Workspace-Postfächer	–
Outlook / Microsoft 365 (OAuth)	`outlook`	Postfächer bei Outlook.com und Microsoft 365	–

Persönliche Dienste (SMTP-Postfächer, Gmail, Outlook) sind schnell eingerichtet und senden aus Ihrem echten Postfach, haben aber niedrige Tageslimits und keine Zustellverfolgung. Transaktionale Anbieter erfordern eine DNS-Einrichtung, skalieren dafür, liefern Ereignisse zu Zustellung, Bounces und Öffnungen und bieten eine bessere Zustellbarkeit.

Dienst hinzufügen

Inhaber, Admins und Entwickler verwalten Dienste unter E-Mail-Dienste.

Klicken Sie auf Dienst hinzufügen und wählen Sie den Anbieter.
Bei Gmail und Outlook klicken Sie auf Gmail verbinden / Outlook / Microsoft 365 verbinden und erlauben den Zugriff im Fenster des Anbieters. Bei allen anderen geben Sie die Zugangsdaten ein und klicken auf Prüfen & speichern – Frontmail prüft sie vor dem Speichern beim Anbieter (ohne eine E-Mail zu senden). Wenn Sie das später prüfen möchten, nutzen Sie Ohne Prüfung speichern. Die Zugangsdaten werden mit AWS KMS verschlüsselt (Envelope Encryption, AES-256-GCM) und nie wieder angezeigt – Sie können sie nur ersetzen.
Auf der Seite des Dienstes führt Verbindung testen dieselbe Prüfung jederzeit erneut aus.
Richten Sie optional die Webhook-URL ein, die auf der Seite des Dienstes angezeigt wird (siehe unten).
Ihr erster Dienst wird automatisch zum Standarddienst; mit Als Standard festlegen ändern Sie das. Vorlagen ohne explizit gewählten Dienst – und API-Aufrufe ohne service_id – verwenden ihn. Wenn Sie einen Dienst löschen, den Vorlagen nutzen, wechseln diese auf den Standarddienst.

Standardabsender (From)

Jeder Dienst kann eine Standard-Absenderadresse und einen Standard-Absendernamen haben (im Formular beim Hinzufügen und auf der Seite des Dienstes unter Einstellungen). Die Absenderadresse jeder E-Mail wird in dieser Reihenfolge bestimmt:

Absenderadresse / Absendername in den Einstellungen der Vorlage (darf Parameter enthalten),
Standard-Absenderadresse / Standard-Absendername des Dienstes,
bei Gmail und Outlook das verbundene Konto; bei SMTP der Benutzername, sofern er eine E-Mail-Adresse ist.

Solange die Absenderadresse der Vorlage leer ist, zeigt der Vorlageneditor an, welcher Absender verwendet wird. Eine Änderung nur des Standardabsenders löst keinen erneuten Verbindungstest aus. Ergibt keiner der Schritte eine Adresse, schlagen Testversände mit sender_not_configured fehl und echte Versände endgültig (der Credit wird erstattet).

Ersatzdienst (Failover)

Jede Vorlage hat einen primären Dienst und optional einen Ersatzdienst; beide wählen Sie im Vorlageneditor unter Einstellungen → Zustellung (Dienst und Ersatzdienst). Der Versand versucht es zuerst über den primären Dienst. Schlägt dieser mit einem Authentifizierungsfehler oder einem dauerhaften Fehler fehl, wird dieselbe Nachricht sofort über den Ersatzdienst gesendet. Die Zeitleiste der Nachricht zeigt ein failover-Ereignis, und im Verlauf sehen Sie, welcher Dienst sie tatsächlich gesendet hat.

Vorübergehende Fehler (Timeouts, Drosselung, 5xx) lösen kein Failover aus – sie werden zunächst beim primären Dienst wiederholt, weil sie sich meist von selbst erledigen.

Umgang mit Fehlern des Anbieters

Frontmail ordnet jeden Fehler des Anbieters einer von drei Gruppen zu:

Klasse	Beispiele	Was Frontmail tut
Authentifizierung	ungültiger oder widerrufener API-Schlüssel, abgelaufenes OAuth-Token (Google `invalid_grant`), SMTP `535`	Markiert den Dienst als unhealthy (Gestört), benachrichtigt Inhaber und Admins per E-Mail und zeigt ein Banner im Dashboard. Sendet über den Ersatzdienst, falls vorhanden; andernfalls wird der Credit erstattet und die Nachricht bleibt als `held_service_error` erhalten.
Dauerhaft	ungültiger Empfänger, nicht verifizierter Absender oder nicht verifizierte Domain, Nachricht aufgrund von Richtlinien abgelehnt	Versucht den Ersatzdienst, falls vorhanden; andernfalls wird die Nachricht `failed` und der Credit erstattet. Hard Bounces setzen die Adresse auf die Sperrliste.
Vorübergehend	Timeout, Verbindungsabbruch, `5xx` des Anbieters, Drosselung `429`, SMTP `421`/`450`/`451`	Wiederholt mit exponentiellem Backoff (unter Beachtung der Rate Limits des Anbieters). Schlagen alle Versuche fehl, wird die Nachricht `failed` und der Credit erstattet.

Jede Anbieter-Anleitung listet die häufigen Fehler und ihre Einordnung auf.

Wegen eines Dienstfehlers zurückgehaltene Nachrichten

Nachrichten im Status held_service_error warten zusammen mit den wegen fehlender Credits zurückgehaltenen Nachrichten in der Warteschlange zurückgehaltener E-Mails und sind mit dem Grund Dienstfehler gekennzeichnet. Sobald der Dienst wieder funktioniert – nachdem Sie die Zugangsdaten aktualisiert, OAuth neu verbunden haben oder eine Statusprüfung erfolgreich war –, werden sie automatisch freigegeben: Es wird erneut ein Credit reserviert und sie werden in der ursprünglichen Reihenfolge gesendet. Sie können sie auch manuell freigeben oder verwerfen. Sie laufen wie andere zurückgehaltene Nachrichten ab (Free 3 Tage, kostenpflichtige Tarife 14 Tage), und Sie erhalten vorher eine E-Mail.

Statusprüfungen

Täglich: Frontmail prüft jeden Dienst (dieselbe Prüfung wie Verbindung testen).
Sofort nach einem Authentifizierungsfehler beim Senden.
Beim Speichern: immer wenn Sie Zugangsdaten bearbeiten oder OAuth neu verbinden.

Ein Dienst ist healthy (Funktioniert), unhealthy (Gestört) oder unknown (Nicht geprüft). Fällt ein Dienst aus, erhalten Inhaber und Admins eine E-Mail, und das Dashboard zeigt das Banner Ein E-Mail-Dienst funktioniert nicht mit der Schaltfläche Dienst reparieren, bis er sich erholt hat; sobald er wieder funktioniert und seine zurückgehaltenen Nachrichten freigegeben sind, erhalten Sie eine weitere E-Mail.

Zustell-Webhooks

Transaktionale Anbieter können melden, was mit einer Nachricht geschah, nachdem sie sie angenommen haben. Kopieren Sie die Webhook-URL von der Seite des Dienstes (dort sind auch die zu aktivierenden Ereignisse aufgeführt) in die Konsole Ihres Anbieters:

https://api.frontmail.dev/webhooks/providers/<type>/<token>

<type> ist der Anbietertyp aus der Tabelle oben (z. B. mailgun), <token> ist ein zufälliges, für den Dienst eindeutiges Token – behandeln Sie die gesamte URL als Geheimnis. Wo der Anbieter es unterstützt, prüft Frontmail zusätzlich dessen Signatur.

Die Ereignisse werden auf Nachrichtenstatus und Statistiken abgebildet:

Ereignis des Anbieters	Frontmail
delivered	Status `delivered`
hard bounce	Status `bounced` + Adresse auf die Sperrliste gesetzt
soft bounce	nur Ereignis (der Anbieter versucht es erneut)
spam complaint	Status `complained` + Adresse auf die Sperrliste gesetzt
open / click	Ereignisse `opened` / `clicked` in der Zeitleiste und in den Statistiken

Ohne Webhooks endet eine Nachricht im Status sent – das heißt, der Anbieter hat sie angenommen.