Transaktionale E-Mails

Transaktionale E-Mails sind Eins-zu-eins-Nachrichten, die von Ihrer Anwendung ausgelöst werden — etwa Passwort-Resets, Bestellbestätigungen, Willkommens-E-Mails oder Kontobenachrichtigungen. Anders als Marketing-Kampagnen, die an ein Thema oder Segment gehen, werden transaktionale E-Mails an einen bestimmten Kontakt als Reaktion auf eine von ihm ausgeführte Aktion versendet.

Transaktionale vs. Marketing-E-Mails

Transaktionale Vorlagen anlegen

1. Öffnen Sie Mail > Transaktional.
2. Klicken Sie auf Neue transaktionale E-Mail.
3. Geben Sie im Dialog Transaktionale E-Mail erstellen einen Namen und einen Slug ein — der Slug ist eine kurze, eindeutige Kennung, die Sie beim Versand referenzieren (z. B. „welcome-email“ oder „password-reset“).
4. Klicken Sie auf Erstellen & bearbeiten, um die Vorlage im E-Mail-Editor zu öffnen.
5. Bauen Sie Ihren E-Mail-Inhalt und speichern Sie Ihre Arbeit.
6. Veröffentlichen Sie die Vorlage. Neue Vorlagen starten als Entwurf, und die Sende-API versendet einen Entwurf nicht. Nutzen Sie die Aktion Veröffentlichen im Editor, um sie versandfähig zu machen — eine nicht veröffentlichte oder leere Vorlage wird beim Versand abgewiesen (siehe Veröffentlichung).

Slugs

Der Slug ist der Weg, über den Ihre Anwendung erkennt, welche Vorlage versendet werden soll. Wählen Sie etwas Beschreibendes und Stabiles:

• „welcome-email“ — für die Registrierung neuer Nutzer
• „password-reset“ — für die Passwortwiederherstellung
• „order-confirmation“ — für Kaufbelege

Veröffentlichung und Prüfung

Eine transaktionale Vorlage durchläuft drei Zustände:

Eine Vorlage muss veröffentlicht sein, bevor die API sie versendet. Rufen Sie den Sende-Endpunkt mit einer nicht veröffentlichten Vorlage auf, wird die Anfrage abgewiesen (template_not_published); eine veröffentlichte Vorlage ohne gerendertes HTML wird ebenfalls abgewiesen (template_no_content). Einen Entwurf zu veröffentlichen ist die mit Abstand häufigste Lösung, wenn ein transaktionaler Versand nicht rausgeht.

Wenn Sie im Editor auf Veröffentlichen klicken, prüft der Inhaltsscanner Betreff und HTML. Stuft er den Inhalt als verdächtig ein, landet die Vorlage in Prüfung ausstehend, statt live zu gehen — sie bleibt unversendbar, bis eine Administration sie freigibt. Schwer beanstandete Inhalte werden vollständig blockiert und lassen sich gar nicht veröffentlichen. Mit Veröffentlichung zurücknehmen setzen Sie eine Live-Vorlage für Bearbeitungen zurück in den Entwurf.

Die Liste der transaktionalen Vorlagen und ihr Statusfilter bezeichnen genau diesen Zustand als Prüfung ausstehend, während der Editor ihn Wartet auf Prüfung nennt — beides meint denselben zurückgehaltenen Status.

Variablen

Transaktionale Vorlagen können dynamische Variablen enthalten, die mit Daten befüllt werden, die Sie beim Versand mitgeben. So bringen Sie Bestelldetails, Kontoinformationen oder beliebige für das auslösende Ereignis spezifische Daten unter.

Häufige Einsatzzwecke für Variablen:

• Kontaktfelder (Vorname, E-Mail)
• Eigene Daten, die beim Versand übergeben werden (Bestellsumme, Sendungsverfolgungslink, Reset-URL)
• Bedingte Inhalte auf Basis von Variablenwerten

Fügen Sie Variablen im Editor ein, indem Sie {{ oder @ tippen, um die Variablenauswahl zu öffnen — genau wie in Marketing-Vorlagen.

Transaktionale E-Mails versenden

Transaktionale E-Mails werden über die API versendet. Ihre Anwendung führt einen API-Aufruf aus und gibt dabei an:

• Den zu verwendenden Vorlagen-Slug (oder dessen transactionalId)
• Die E-Mail-Adresse des Empfängers
• Etwaige Vorlagenvariablen, übergeben als Objekt dataVariables

Details zum Endpunkt, das Anfrageformat und Codebeispiele finden Sie in der API-Dokumentation.

Sendungen überwachen

Verfolgen Sie die Zustellung Ihrer transaktionalen E-Mails im Dashboard:

• Sendestatus einzelner transaktionaler E-Mails einsehen
• Zustell- und Bounce-Raten überwachen
• Vorlagen erkennen, die Darstellungs- oder Zustellprobleme haben könnten

Anhänge

Transaktionale E-Mails können Dateianhänge enthalten — nützlich für Rechnungen, Belege, Tickets oder jedes Dokument, das der Empfänger braucht.

Anhänge im Dashboard hinzufügen

Nutzen Sie beim Konfigurieren einer transaktionalen Vorlage die Anhangsauswahl, um Dateien aus Ihrer Medienbibliothek zu wählen. Das ist praktisch für statische Anhänge, die sich nicht je Empfänger unterscheiden.

Anhänge über die API hinzufügen

Für dynamische Anhänge übergeben Sie in Ihrer API-Anfrage ein Array attachments:

{
  "slug": "order-confirmation",
  "email": "customer@example.com",
  "attachments": [
    {
      "filename": "invoice.pdf",
      "url": "https://example.com/invoices/12345.pdf",
      "contentType": "application/pdf"
    }
  ]
}

Jeder Anhang kann den Dateiinhalt als Base64-String (content) oder als abzurufende URL (url) bereitstellen. Die vollständige Feldreferenz finden Sie in der Dokumentation zur Transaktions-API.

Limits: maximal 10 Anhänge, 10 MB Gesamtgröße.

Bewährte Praktiken

• Transaktionale E-Mails fokussiert halten — nehmen Sie nur die Informationen auf, die der Empfänger braucht. Eine E-Mail zum Passwort-Reset sollte den Reset-Link enthalten, keine Werbespalte.
• Mit echten Daten testen — versenden Sie Test-E-Mails mit realistischen Variablenwerten, um sicherzugehen, dass Ihre Vorlage mit unterschiedlichen Daten korrekt umgeht (lange Namen, fehlende Felder usw.).
• Fehlerbehandlung einrichten — Ihre Anwendung sollte API-Fehler sauber abfangen. Schlägt der Versand einer transaktionalen E-Mail fehl, protokollieren Sie den Fehler und erwägen Sie eine Wiederholungsstrategie.
• Klare Absendernamen verwenden — transaktionale E-Mails sollten von einem wiedererkennbaren Absender kommen, damit Empfänger ihnen vertrauen und sie öffnen.

Nächste Schritte

• E-Mail-Editor — Ihre transaktionalen Vorlagen bauen
• E-Mail-Vorlagen — das Vorlagensystem verstehen
• Zustellbarkeit — dafür sorgen, dass Ihre transaktionalen E-Mails Posteingänge erreichen
• Medienbibliothek — Anhänge und Bilder an einem Ort verwalten
• API-Dokumentation — transaktionalen Versand in Ihre App integrieren