Die meisten Versender transaktionaler E-Mails rendern nur reines HTML. POST /api/v1/send im Vorlagenmodus rendert stattdessen eines Ihrer eigenen Studio-Projekte, komplett mit Fallback-Engine und interaktiven Blöcken. Eine Quittung oder Bestätigung, die Ihr Backend auslöst, kann einen Bewertungs-Block oder einen Produkt-Upsell tragen, genau wie ein Marketing-Versand.
Eine Quittung ist eine der E-Mails mit der höchsten Öffnungsrate, die ein Unternehmen versendet — und fast immer die schlichteste, weil sie meist von der transaktionalen Bibliothek erzeugt wird, die am einfachsten anzubinden war, nicht von etwas mit einem angeschlossenen Designsystem.
Gestalten Sie sie einmal, lösen Sie sie von Ihrem Backend aus
Bauen Sie die Quittung oder Bestätigung als normales Studio-Projekt, mit welchen Blöcken auch immer sinnvoll sind — eine Bewertung für CSAT nach dem Kauf, ein Zubehör-Produkt-Upsell. Ihr Backend ruft dann die Send API im Vorlagenmodus auf, mit der Projekt-ID und einem mergeData-Objekt, das für die dynamischen Werte dieser bestimmten Bestellung einsteht.
Kennzeichnen Sie sie korrekt als transaktional
Wenn Sie type auf "transactional" setzen, umgeht das die Abmeldungs-Sperrung — eine Quittung muss weiterhin jemanden erreichen, der sich vom Marketing abgemeldet hat —, aber nie die Bounce-Sperrung, da eine tatsächlich ungültige Adresse unabhängig vom E-Mail-Typ nicht weiter beliefert werden sollte.
Sie ist authentifiziert wie jede andere API-Integration
Ein pro Inhaber benannter API-Schlüssel, Bearer-authentifiziert, wird im Bereich Entwickler des Dashboards geprägt und widerrufen. Ein Idempotency-Key-Header verhindert, dass eine wiederholte Anfrage die Quittung zweimal versendet.
Was nicht übernommen wird
Der Freiform-Modus (kein projectId, nur rohes html/text) überspringt die Rendering-Pipeline vollständig — keine Merge-Tags, keine Fallback-Engine, unverändert versendet wie angegeben. Das ist die richtige Wahl für etwas wie einen einmaligen OTP-Code; der Vorlagenmodus lohnt sich, sobald die E-Mail selbst von einem interaktiven Block profitiert.
Erste Schritte
Bauen Sie die transaktionale Vorlage als Studio-Projekt mit den gewünschten interaktiven Blöcken, prägen Sie einen API-Schlüssel unter Entwickler, und rufen Sie POST /api/v1/send im Vorlagenmodus mit Ihrem mergeData und type: "transactional" auf.