SMTP-Einreichungen für Transaktions-E-Mails

Zusätzlich zur HTTP API unterstützt Flexmail den Versand von Transaktions-E-Mails über SMTP. Dies ist nützlich, wenn Ihre Anwendung oder Plattform bereits SMTP-Unterstützung integriert hat – ein CMS, eine E-Commerce-Plattform oder ein Legacy-System, das E-Mails über ein SMTP-Relay versendet.

SMTP-Einreichungen sind im Transaktionsprodukt ohne zusätzliche Kosten enthalten. Sie bieten dieselbe Zustellungszuverlässigkeit und Tracking-Funktionen wie die API, mit einigen Unterschieden bei den Standardeinstellungen und unterstützten Funktionen.

Hinweis

SMTP-Einreichungen sind standardmäßig nicht aktiviert. Sie müssen den Zugang explizit anfordern. Weitere Informationen finden Sie unter „Zugang anfordern" weiter unten.

Zugang anfordern

SMTP-Zugang wird nicht automatisch aktiviert, wenn Sie das Transaktionsprodukt aktivieren. Um SMTP-Zugangsdaten für Ihr Konto anzufordern, wenden Sie sich an den Flexmail-Support unter support@flexmail.eu und geben Sie Ihre Konto-ID in der Anfrage an. Ihr SMTP-Benutzername und Ihr Passwort werden als Teil der Zugangsdaten-Antwort bereitgestellt.

Hinweis

Ihre SMTP-Zugangsdaten sind von Ihrem persönlichen Zugriffstoken getrennt. Benutzername und Passwort für SMTP werden von Flexmail auf Anfrage bereitgestellt – verwenden Sie nicht Ihre Konto-ID und Ihr persönliches Zugriffstoken als SMTP-Zugangsdaten.

Verbindungseinstellungen

Sobald Ihr SMTP-Zugang gewährt wurde, verwenden Sie die folgenden Einstellungen:

Einstellung

Wert

Server

submission.flexmail.eu

Port

587

Verbindungssicherheit

STARTTLS

Benutzername

Wird von Flexmail auf Anfrage bereitgestellt

Passwort

Wird von Flexmail auf Anfrage bereitgestellt

Benutzerdefinierte Header

SMTP-Einreichungen unterstützen mehrere optionale benutzerdefinierte Header, die das Verhalten und das Tracking von Nachrichten steuern. Diese funktionieren ähnlich wie die in der HTTP API verfügbaren Optionen.

Header

Beschreibung

X-Flexmail-Tag

Fügen Sie ein Tag hinzu, um Nachrichten zu kategorisieren und Statistiken zu sammeln. Muss im snake_case-Format vorliegen (1–50 Zeichen, z. B. order_confirmation).

X-Flexmail-Metadata-{key}

Fügen Sie benutzerdefinierte Metadaten als Schlüssel/Wert-Paare hinzu. Ersetzen Sie {key} durch Ihren Feldnamen in snake_case. Der Wert muss 1–80 Zeichen lang sein.

X-Flexmail-Open-Tracking

Auf true setzen, um Öffnungs-Tracking zu aktivieren. Standardmäßig deaktiviert.

X-Flexmail-Link-Tracking

Auf true setzen, um Link-Tracking zu aktivieren. Standardmäßig deaktiviert.

Beispiel:

X-Flexmail-Tag: order_confirmation X-Flexmail-Metadata-order_id: 12345 X-Flexmail-Metadata-customer_id: C-789 X-Flexmail-Open-Tracking: true X-Flexmail-Link-Tracking: true

Hinweis

Öffnungs- und Link-Tracking sind sowohl für SMTP-Einreichungen als auch für die HTTP API standardmäßig deaktiviert. Fügen Sie die entsprechenden Header hinzu, wenn Sie Tracking aktivieren möchten.

Nachrichten-ID und Webhook-Korrelation

Der ursprüngliche Message-ID-Header Ihrer eingereichten E-Mail wird automatisch als Metadaten unter dem Schlüssel original_message_id gespeichert. Damit können Sie Webhook-Zustellungsereignisse mit den Nachrichten korrelieren, die Sie von Ihrem eigenen System gesendet haben.

SMTP vs. HTTP API

Die beiden Methoden weisen einige Unterschiede bei den Standardeinstellungen und Funktionen auf:

Funktion

HTTP API

SMTP-Einreichung

Öffnungs-Tracking

Standardmäßig deaktiviert

Link-Tracking

Standardmäßig deaktiviert

Ursprüngliche Message-ID

Nicht verfügbar

Als original_message_id-Metadaten gespeichert

Inline-Anhänge

Unterstützt

Nicht unterstützt

Nur-Text-E-Mails

Unterstützt

Nicht unterstützt

Unterstützte Funktionen

HTML-E-Mails mit oder ohne Nur-Text-Multipart.
Öffnungs- und Link-Tracking (über benutzerdefinierte Header).
CC- und BCC-Empfänger.
Anhänge – müssen base64-kodiert sein. Inline-Anhänge werden nicht unterstützt.
Rate-Limiting pro Empfänger, konsistent mit den API-Rate-Limits.

Anforderungen

Die Absenderadresse muss ein verifizierter Absender in Ihrem Flexmail-Konto sein.
Die Versanddomain muss mit SPF, DKIM und DMARC authentifiziert sein, und ein Return-Path muss konfiguriert sein. Diese Anforderungen gelten genauso wie für die HTTP API.

Fehlerbehandlung

Einreichungsfehler werden über einen NDR (Non-Delivery Report) gemeldet, der an die Envelope-Absenderadresse gesendet wird. Bounce-Ereignisse und alle anderen Nachrichtenereignisse sind ebenfalls über den Nachrichtendetails-Endpunkt und Webhooks verfügbar, auf dieselbe Weise wie bei API-Sendungen.

Nächste Schritte

Siehe „Erste Schritte mit der Transaktions-API" für den vollständigen Konto-Einrichtungsprozess.
Siehe „Transaktions-Webhooks", um Echtzeit-Zustellungs- und Tracking-Ereignisse zu empfangen.
Siehe „Transaktions-Fehlerbehebung", wenn Ihre SMTP-Verbindung oder Zustellbarkeit nicht wie erwartet funktioniert.