Mit der Transaktions-API starten

Die Flexmail-Transaktions-API ermöglicht es Ihnen, ausgelöste Eins-zu-Eins-E-Mails aus Ihrer Anwendung heraus zu senden – Bestellbestätigungen, Passwortzurücksetzungen, Rechnungen und alles andere, was als Reaktion auf eine bestimmte Benutzeraktion ausgelöst wird. Sie können über HTTP (REST-API) oder SMTP senden und dabei für beide dieselben Konto-Anmeldedaten verwenden.

Das Transaktionsprodukt funktioniert unabhängig vom Flexmail-Marketingprodukt. Sie können es allein verwenden, ohne Kampagnen oder Kontaktlisten einzurichten.

Achtung Die Transaktions-API unterstützt nur einen Empfänger pro Nachricht. Sie kann nicht für Massen- oder Marketing-Versände verwendet werden. Lesen Sie „Marketing-E-Mail vs. Transaktions-E-Mail" für die vollständige Erklärung.

Voraussetzungen

Ein Flexmail-Konto. Sie benötigen eines, um die Transaktions-API zu nutzen, auch wenn Sie nur Transaktions-E-Mails senden und die Marketingfunktionen nicht nutzen.
Zugang zu den DNS-Einstellungen Ihrer Domain, um die E-Mail-Authentifizierung zu konfigurieren.
Entwicklerzugang zu Ihrer Anwendung oder Ihrem Sendesystem, um die API zu integrieren oder SMTP zu konfigurieren.

Schritt 1: Das Transaktionsprodukt aktivieren

Wenn Sie bereits ein Flexmail-Konto haben, aktivieren Sie das Transaktionsprodukt über das Dashboard-Widget. Die Testversion gibt Ihnen bis zu 1.000 Versände über 30 Tage kostenfrei. Sie können jederzeit während oder nach der Testphase auf ein kostenpflichtiges Transaktionsabonnement upgraden.

Wenn Sie noch kein Konto haben, registrieren Sie sich unter flexmail.be/en/signup. Ihre Marketing- und Transaktionsabonnements werden vom selben Konto aus verwaltet.

Achtung Sie benötigen kein Marketingabonnement, um das Transaktionsprodukt zu nutzen. Wenn Sie nur Transaktions-E-Mails senden möchten, können Sie das Transaktionsprodukt aktivieren und die Marketingfunktionen ungenutzt lassen.

Schritt 2: Ihre Absenderadresse verifizieren

Bevor Sie senden können, müssen Sie die E-Mail-Adresse verifizieren, die Sie im Von-Feld verwenden werden.

Gehen Sie zu Einstellungen, dann Absender hinzufügen oder entfernen.
Fügen Sie die E-Mail-Adresse hinzu, von der Sie senden möchten.
Flexmail sendet eine Verifizierungs-E-Mail an diese Adresse – klicken Sie auf den Link, um zu bestätigen. Dies beweist, dass Sie das Postfach besitzen, von dem Sie senden.

Screenshot of validation email

Schritt 3: E-Mail-Authentifizierung einrichten

Konfigurieren Sie SPF, DKIM, DMARC und einen benutzerdefinierten Return-Path für die Domain Ihrer Absenderadresse. Diese DNS-Einträge beweisen, dass Ihre E-Mails tatsächlich von Ihnen stammen – daran entscheiden Posteingangsanbieter wie Gmail, ob Ihre E-Mail im Posteingang zugestellt oder abgewiesen wird.

Detaillierte DNS-Konfigurationsanweisungen finden Sie in der Flexmail Email API-Dokumentation unter dem Abschnitt E-Mail-Authentifizierung.

Achtung E-Mail-Authentifizierung ist für Transaktions-E-Mails keine Option. Ohne korrekt konfigurierte SPF- und DKIM-Einträge schlagen Ihre Transaktions-E-Mails die Authentifizierungsprüfungen bei großen Posteingangsanbietern fehl und können abgewiesen oder in den Spam-Ordner verschoben werden.

Schritt 4: Ein persönliches Zugriffstoken erstellen

Die Transaktions-API verwendet HTTP-Basic-Authentifizierung. Ihre Konto-ID ist der Benutzername; ein persönliches Zugriffstoken ist das Passwort. Diese Anmeldedaten sind nur für die HTTP-API bestimmt – SMTP verwendet separate Anmeldedaten, die Flexmail auf Anfrage bereitstellt.

Gehen Sie zu Einstellungen, dann API, dann Persönliche Zugriffstoken.
Klicken Sie auf Neues Token erstellen und geben Sie ihm einen beschreibenden Namen.
Kopieren Sie das Token und bewahren Sie es sicher auf. Es wird nicht erneut angezeigt.

Schritt 5: Ihre Sendemethode wählen

Flexmail unterstützt zwei Möglichkeiten, Transaktions-E-Mails zu senden. Beide verwenden dieselbe Konto-ID und dasselbe persönliche Zugriffstoken.

HTTP-API

Die REST-API gibt Ihnen die größte Kontrolle. Sie können Nachrichten senden, Vorlagen verwalten, Webhooks verarbeiten und Lieferdaten programmatisch abrufen. Dies ist der empfohlene Ansatz für benutzerdefinierte Integrationen und Anwendungen.

Die vollständige Dokumentation finden Sie unter email-api.flexmail.eu/documentation. Der Abschnitt „Erste Schritte" enthält ein curl-Beispiel, das Sie sofort ausführen können, um Ihre Einrichtung zu verifizieren.

SMTP

SMTP-Einreichungen sind ohne zusätzliche Kosten im Transaktionsprodukt enthalten. Verwenden Sie SMTP, wenn Ihre Anwendung oder Plattform dies bereits unterstützt – zum Beispiel ein CMS, eine E-Commerce-Plattform oder ein Legacy-System, das E-Mails über ein SMTP-Relay sendet.

Lesen Sie „SMTP-Einreichungen für Transaktions-E-Mails" für die Verbindungseinstellungen und Einrichtungsanweisungen.

Schritt 6: In Ihre Anwendung integrieren

Mit einem bestätigten erfolgreichen Test-Versand sind Sie bereit, die API in Ihre Anwendung zu integrieren. Die vollständige Dokumentation umfasst:

Nachrichtenversand: alle Parameter für den Sende-Endpunkt
Vorlagen – Erstellen und Referenzieren von wiederverwendbaren E-Mail-Vorlagen. Lesen Sie „Transaktionale Vorlagen und Personalisierung" für einen praktischen Überblick.
Webhooks – Echtzeit-Ereignisbenachrichtigungen für Versände, Zustellungen, Bounces, Öffnungen und Klicks. Lesen Sie „Transaktions-Webhooks" für Einrichtung und Ereignisreferenz.

Support-Tipp Richten Sie die Webhook-Verarbeitung frühzeitig in Ihrer Integration ein. Zu wissen, wann eine Transaktions-E-Mail bounced, ermöglicht es Ihnen, sofort zu handeln – die Adresse in Ihrem System zu markieren, eine Follow-up-Benachrichtigung auszulösen oder Ihr Team zu benachrichtigen –, anstatt ein Zustellungsproblem Tage später zu entdecken.

API-Dokumentation und Support

Die vollständige API-Dokumentation ist unter email-api.flexmail.eu/documentation verfügbar.

Wenn Sie an irgendeinem Punkt nicht weiterkommen, ist das Flexmail-Support-Team unter support@flexmail.eu erreichbar. Fragen zur Transaktions-API werden von demselben Team bearbeitet, das die Marketing-Oberfläche unterstützt.

Nächste Schritte

Lesen Sie „Marketing-E-Mail vs. Transaktions-E-Mail", um zu verstehen, wann welcher Typ eingesetzt werden sollte.
Lesen Sie „SMTP-Einreichungen für Transaktions-E-Mails", wenn Sie über SMTP statt der HTTP-API senden möchten.
Lesen Sie „Transaktionale Vorlagen und Personalisierung", um wiederverwendbare E-Mail-Vorlagen einzurichten.
Lesen Sie „Transaktions-Webhooks", um Echtzeit-Lieferereignisse zu empfangen.
Lesen Sie „Fehlerbehebung bei Transaktions-E-Mails", wenn etwas nicht wie erwartet funktioniert.
Lesen Sie die vollständige API-Dokumentation unter email-api.flexmail.eu/documentation für alle Endpunktparameter.