Transaktions-E-Mails senden und personalisieren

Jeder Transaktions-API-Aufruf enthält das vollständige HTML Ihrer E-Mail direkt im Request-Body. Dies gibt Ihnen vollständige Kontrolle über den Inhalt und die Struktur jeder Nachricht, die Ihre Anwendung sendet.

So funktioniert es

Sie übergeben das HTML (und optional Klartext) direkt im API-Request-Body. Ihre Anwendung erstellt den E-Mail-Inhalt dynamisch und fügt ihn in jeden Request ein.

Personalisierung

Mit Personalisierung können Sie dynamische Werte in Ihre E-Mail einfügen – den Vornamen des Empfängers, eine Bestellnummer, einen Produktnamen, einen Preis. Sie definieren Platzhalter in Ihrem HTML und übergeben die entsprechenden Werte im API-Aufruf.

Die genaue Platzhalter-Syntax und die API-Parameter zur Übergabe von Variablenwerten sind in der Flexmail-E-Mail-API-Dokumentation unter email-api.flexmail.eu/documentation im Abschnitt Personalisierung dokumentiert.

Häufige Personalisierungsvariablen

Typische Variablen, die in Transaktions-E-Mails verwendet werden:

  • Empfängername (Vorname, vollständiger Name)
  • Bestell- oder Referenznummer
  • Produktnamen und Mengen
  • Preise und Gesamtsummen
  • Daten und Fristen
  • Bestätigungs- oder Zurücksetzungslinks
  • Kontospezifische URLs oder Codes

Personalisierung testen

Testen Sie Ihre E-Mail vor dem Live-Gang mit realistischen Variablenwerten, um sicherzustellen, dass alle Platzhalter korrekt aufgelöst werden. Die API-Dokumentation enthält Anleitungen zum Senden von Testnachrichten mit benutzerdefinierten Variablenwerten.

Prüfen Sie insbesondere, dass:

  • Alle Platzhalter ersetzt werden – kein rohe Variablen-Syntax erscheint in der zugestellten E-Mail.
  • Fallback-Werte korrekt angezeigt werden, wenn eine optionale Variable nicht übergeben wird.
  • Links nach der Variablensubstitution zu den richtigen URLs führen.

Wichtig

Wenn eine erforderliche Variable in Ihrem API-Aufruf fehlt und kein Fallback definiert ist, kann der Platzhalter buchstäblich in der zugestellten E-Mail erscheinen. Testen Sie immer mit demselben Variablensatz, den Ihre Anwendung in der Produktion senden wird.

Nächste Schritte

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.