[{"data":1,"prerenderedAt":686},["ShallowReactive",2],{"search-de":3,"content-de-guide\u002Ftransactional":4,"surround-de-\u002Fguide\u002Ftransactional":677},[],{"id":5,"title":6,"body":7,"description":669,"extension":670,"meta":671,"navigation":672,"path":673,"seo":674,"stem":675,"__hash__":676},"content_de\u002F1.guide\u002F17.transactional.md","Transaktionale E-Mails",{"type":8,"value":9,"toc":653},"minimark",[10,14,33,38,125,129,197,202,205,217,223,227,230,273,289,302,312,322,326,329,332,343,354,358,361,386,393,398,402,405,416,420,423,427,435,439,446,564,578,584,588,614,618,649],[11,12,13],"p",{},"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.",[15,16,19],"callout",{"type":17,"title":18},"info","Erfordert einen Zustellanbieter",[11,20,21,22,26,27,32],{},"Transaktionale E-Mails werden über einen Zustellanbieter versendet (den eingebauten MTA, Resend oder SES) und benötigen eine verifizierte Sendedomain. In einem reinen IMAP-Deployment ist das ",[23,24,25],"strong",{},"nicht"," verfügbar — ein verbundenes externes Postfach versendet persönliche 1:1-Antworten, keine transaktionale API-Mail. Siehe ",[28,29,31],"a",{"href":30},"\u002Fguide\u002Foperating-modes","Betriebsmodi",".",[34,35,37],"h2",{"id":36},"transaktionale-vs-marketing-e-mails","Transaktionale vs. Marketing-E-Mails",[39,40,41,56],"table",{},[42,43,44],"thead",{},[45,46,47,50,53],"tr",{},[48,49],"th",{},[48,51,52],{},"Transaktional",[48,54,55],{},"Marketing",[57,58,59,73,86,99,112],"tbody",{},[45,60,61,67,70],{},[62,63,64],"td",{},[23,65,66],{},"Ausgelöst durch",[62,68,69],{},"Ein Ereignis in Ihrer Anwendung",[62,71,72],{},"Sie selbst, über eine Kampagne",[45,74,75,80,83],{},[62,76,77],{},[23,78,79],{},"Gesendet an",[62,81,82],{},"Einen einzelnen Kontakt",[62,84,85],{},"Ein Thema oder Segment",[45,87,88,93,96],{},[62,89,90],{},[23,91,92],{},"Inhalt",[62,94,95],{},"Mit dynamischen Daten personalisiert",[62,97,98],{},"Gleicher Inhalt für alle Empfänger",[45,100,101,106,109],{},[62,102,103],{},[23,104,105],{},"Abmeldung",[62,107,108],{},"Nicht erforderlich (der Empfänger erwartet die E-Mail)",[62,110,111],{},"Muss einen Abmeldelink enthalten",[45,113,114,119,122],{},[62,115,116],{},[23,117,118],{},"Beispiele",[62,120,121],{},"Passwort-Reset, Bestellbestätigung, Willkommens-E-Mail",[62,123,124],{},"Newsletter, Produkt-Launch, Aktion",[34,126,128],{"id":127},"transaktionale-vorlagen-anlegen","Transaktionale Vorlagen anlegen",[130,131,132,139,145,160,171,174],"ol",{},[133,134,135,136,32],"li",{},"Öffnen Sie ",[23,137,138],{},"Mail > Transaktional",[133,140,141,142,32],{},"Klicken Sie auf ",[23,143,144],{},"Neue transaktionale E-Mail",[133,146,147,148,151,152,155,156,159],{},"Geben Sie im Dialog ",[23,149,150],{},"Transaktionale E-Mail erstellen"," einen ",[23,153,154],{},"Namen"," und einen ",[23,157,158],{},"Slug"," ein — der Slug ist eine kurze, eindeutige Kennung, die Sie beim Versand referenzieren (z. B. „welcome-email“ oder „password-reset“).",[133,161,141,162,165,166,170],{},[23,163,164],{},"Erstellen & bearbeiten",", um die Vorlage im ",[28,167,169],{"href":168},"\u002Fguide\u002Femail-editor","E-Mail-Editor"," zu öffnen.",[133,172,173],{},"Bauen Sie Ihren E-Mail-Inhalt und speichern Sie Ihre Arbeit.",[133,175,176,179,180,184,185,187,188,191,192,196],{},[23,177,178],{},"Veröffentlichen Sie die Vorlage."," Neue Vorlagen starten als ",[181,182,183],"em",{},"Entwurf",", und die Sende-API versendet einen Entwurf ",[23,186,25],{},". Nutzen Sie die Aktion ",[23,189,190],{},"Veröffentlichen"," im Editor, um sie versandfähig zu machen — eine nicht veröffentlichte oder leere Vorlage wird beim Versand abgewiesen (siehe ",[28,193,195],{"href":194},"#publishing-and-review","Veröffentlichung",").",[198,199,201],"h3",{"id":200},"slugs","Slugs",[11,203,204],{},"Der Slug ist der Weg, über den Ihre Anwendung erkennt, welche Vorlage versendet werden soll. Wählen Sie etwas Beschreibendes und Stabiles:",[206,207,208,211,214],"ul",{},[133,209,210],{},"„welcome-email“ — für die Registrierung neuer Nutzer",[133,212,213],{},"„password-reset“ — für die Passwortwiederherstellung",[133,215,216],{},"„order-confirmation“ — für Kaufbelege",[15,218,220],{"type":219},"tip",[11,221,222],{},"Behandeln Sie Slugs wie API-Kennungen — wählen Sie sie sorgfältig und ändern Sie sie nicht mehr, sobald sie im Einsatz sind, da Ihr Anwendungscode sie direkt referenziert.",[34,224,226],{"id":225},"veröffentlichung-und-prüfung","Veröffentlichung und Prüfung",[11,228,229],{},"Eine transaktionale Vorlage durchläuft drei Zustände:",[39,231,232,242],{},[42,233,234],{},[45,235,236,239],{},[48,237,238],{},"Status",[48,240,241],{},"Was er bedeutet",[57,243,244,253,263],{},[45,245,246,250],{},[62,247,248],{},[23,249,183],{},[62,251,252],{},"Die Voreinstellung für eine neue oder bearbeitete Vorlage. Nicht versandfähig.",[45,254,255,260],{},[62,256,257],{},[23,258,259],{},"Prüfung ausstehend",[62,261,262],{},"Der Inhaltsscanner hat die Vorlage beim Veröffentlichen markiert. Zurückgehalten, bis eine Administration sie freigibt; weiterhin nicht versandfähig.",[45,264,265,270],{},[62,266,267],{},[23,268,269],{},"Veröffentlicht",[62,271,272],{},"Live und über die API versandfähig.",[11,274,275,276,279,280,284,285,288],{},"Eine Vorlage ",[23,277,278],{},"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 (",[281,282,283],"code",{},"template_not_published","); eine veröffentlichte Vorlage ohne gerendertes HTML wird ebenfalls abgewiesen (",[281,286,287],{},"template_no_content","). Einen Entwurf zu veröffentlichen ist die mit Abstand häufigste Lösung, wenn ein transaktionaler Versand nicht rausgeht.",[11,290,291,292,294,295,297,298,301],{},"Wenn Sie im Editor auf ",[23,293,190],{}," klicken, prüft der Inhaltsscanner Betreff und HTML. Stuft er den Inhalt als verdächtig ein, landet die Vorlage in ",[23,296,259],{},", 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 ",[23,299,300],{},"Veröffentlichung zurücknehmen"," setzen Sie eine Live-Vorlage für Bearbeitungen zurück in den Entwurf.",[11,303,304,305,307,308,311],{},"Die Liste der transaktionalen Vorlagen und ihr Statusfilter bezeichnen genau diesen Zustand als ",[23,306,259],{},", während der Editor ihn ",[23,309,310],{},"Wartet auf Prüfung"," nennt — beides meint denselben zurückgehaltenen Status.",[15,313,316],{"type":314,"title":315},"warning","„Wartet auf Prüfung“ ist eine Admin-Schranke",[11,317,318,319,321],{},"Es gibt keine Aktion auf Autorenseite, um eine Vorlage aus ",[23,320,310],{}," herauszubewegen — nur eine Administration kann sie freigeben (oder ablehnen). Bis dahin behandelt die Sende-API sie genauso wie einen Entwurf.",[34,323,325],{"id":324},"variablen","Variablen",[11,327,328],{},"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.",[11,330,331],{},"Häufige Einsatzzwecke für Variablen:",[206,333,334,337,340],{},[133,335,336],{},"Kontaktfelder (Vorname, E-Mail)",[133,338,339],{},"Eigene Daten, die beim Versand übergeben werden (Bestellsumme, Sendungsverfolgungslink, Reset-URL)",[133,341,342],{},"Bedingte Inhalte auf Basis von Variablenwerten",[11,344,345,346,349,350,353],{},"Fügen Sie Variablen im Editor ein, indem Sie ",[281,347,348],{},"{{"," oder ",[281,351,352],{},"@"," tippen, um die Variablenauswahl zu öffnen — genau wie in Marketing-Vorlagen.",[34,355,357],{"id":356},"transaktionale-e-mails-versenden","Transaktionale E-Mails versenden",[11,359,360],{},"Transaktionale E-Mails werden über die API versendet. Ihre Anwendung führt einen API-Aufruf aus und gibt dabei an:",[206,362,363,374,380],{},[133,364,365,366,369,370,373],{},"Den zu verwendenden ",[23,367,368],{},"Vorlagen-Slug"," (oder dessen ",[281,371,372],{},"transactionalId",")",[133,375,376,377],{},"Die ",[23,378,379],{},"E-Mail-Adresse des Empfängers",[133,381,382,383],{},"Etwaige Vorlagenvariablen, übergeben als Objekt ",[281,384,385],{},"dataVariables",[11,387,388,389,32],{},"Details zum Endpunkt, das Anfrageformat und Codebeispiele finden Sie in der ",[28,390,392],{"href":391},"\u002Fapi\u002Ftransactional","API-Dokumentation",[15,394,395],{"type":17},[11,396,397],{},"Transaktionale E-Mails umgehen die Marketing-Abonnementeinstellungen. Ein Kontakt, der sich von Marketing-E-Mails abgemeldet hat, erhält weiterhin transaktionale E-Mails, da es sich um erwartete, durch eine Aktion ausgelöste Nachrichten handelt.",[34,399,401],{"id":400},"sendungen-überwachen","Sendungen überwachen",[11,403,404],{},"Verfolgen Sie die Zustellung Ihrer transaktionalen E-Mails im Dashboard:",[206,406,407,410,413],{},[133,408,409],{},"Sendestatus einzelner transaktionaler E-Mails einsehen",[133,411,412],{},"Zustell- und Bounce-Raten überwachen",[133,414,415],{},"Vorlagen erkennen, die Darstellungs- oder Zustellprobleme haben könnten",[34,417,419],{"id":418},"anhänge","Anhänge",[11,421,422],{},"Transaktionale E-Mails können Dateianhänge enthalten — nützlich für Rechnungen, Belege, Tickets oder jedes Dokument, das der Empfänger braucht.",[198,424,426],{"id":425},"anhänge-im-dashboard-hinzufügen","Anhänge im Dashboard hinzufügen",[11,428,429,430,434],{},"Nutzen Sie beim Konfigurieren einer transaktionalen Vorlage die Anhangsauswahl, um Dateien aus Ihrer ",[28,431,433],{"href":432},"\u002Fguide\u002Fmedia-library","Medienbibliothek"," zu wählen. Das ist praktisch für statische Anhänge, die sich nicht je Empfänger unterscheiden.",[198,436,438],{"id":437},"anhänge-über-die-api-hinzufügen","Anhänge über die API hinzufügen",[11,440,441,442,445],{},"Für dynamische Anhänge übergeben Sie in Ihrer API-Anfrage ein Array ",[281,443,444],{},"attachments",":",[447,448,453],"pre",{"className":449,"code":450,"language":451,"meta":452,"style":452},"language-json shiki shiki-themes github-light github-dark-dimmed","{\n  \"slug\": \"order-confirmation\",\n  \"email\": \"customer@example.com\",\n  \"attachments\": [\n    {\n      \"filename\": \"invoice.pdf\",\n      \"url\": \"https:\u002F\u002Fexample.com\u002Finvoices\u002F12345.pdf\",\n      \"contentType\": \"application\u002Fpdf\"\n    }\n  ]\n}\n","json","",[281,454,455,464,481,494,503,509,522,535,546,552,558],{"__ignoreMap":452},[456,457,460],"span",{"class":458,"line":459},"line",1,[456,461,463],{"class":462},"sYgZi","{\n",[456,465,467,471,474,478],{"class":458,"line":466},2,[456,468,470],{"class":469},"snmFh","  \"slug\"",[456,472,473],{"class":462},": ",[456,475,477],{"class":476},"s-HuK","\"order-confirmation\"",[456,479,480],{"class":462},",\n",[456,482,484,487,489,492],{"class":458,"line":483},3,[456,485,486],{"class":469},"  \"email\"",[456,488,473],{"class":462},[456,490,491],{"class":476},"\"customer@example.com\"",[456,493,480],{"class":462},[456,495,497,500],{"class":458,"line":496},4,[456,498,499],{"class":469},"  \"attachments\"",[456,501,502],{"class":462},": [\n",[456,504,506],{"class":458,"line":505},5,[456,507,508],{"class":462},"    {\n",[456,510,512,515,517,520],{"class":458,"line":511},6,[456,513,514],{"class":469},"      \"filename\"",[456,516,473],{"class":462},[456,518,519],{"class":476},"\"invoice.pdf\"",[456,521,480],{"class":462},[456,523,525,528,530,533],{"class":458,"line":524},7,[456,526,527],{"class":469},"      \"url\"",[456,529,473],{"class":462},[456,531,532],{"class":476},"\"https:\u002F\u002Fexample.com\u002Finvoices\u002F12345.pdf\"",[456,534,480],{"class":462},[456,536,538,541,543],{"class":458,"line":537},8,[456,539,540],{"class":469},"      \"contentType\"",[456,542,473],{"class":462},[456,544,545],{"class":476},"\"application\u002Fpdf\"\n",[456,547,549],{"class":458,"line":548},9,[456,550,551],{"class":462},"    }\n",[456,553,555],{"class":458,"line":554},10,[456,556,557],{"class":462},"  ]\n",[456,559,561],{"class":458,"line":560},11,[456,562,563],{"class":462},"}\n",[11,565,566,567,570,571,574,575,32],{},"Jeder Anhang kann den Dateiinhalt als Base64-String (",[281,568,569],{},"content",") oder als abzurufende URL (",[281,572,573],{},"url",") bereitstellen. Die vollständige Feldreferenz finden Sie in der Dokumentation zur ",[28,576,577],{"href":391},"Transaktions-API",[11,579,580,583],{},[23,581,582],{},"Limits:"," maximal 10 Anhänge, 10 MB Gesamtgröße.",[34,585,587],{"id":586},"bewährte-praktiken","Bewährte Praktiken",[206,589,590,596,602,608],{},[133,591,592,595],{},[23,593,594],{},"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.",[133,597,598,601],{},[23,599,600],{},"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.).",[133,603,604,607],{},[23,605,606],{},"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.",[133,609,610,613],{},[23,611,612],{},"Klare Absendernamen verwenden"," — transaktionale E-Mails sollten von einem wiedererkennbaren Absender kommen, damit Empfänger ihnen vertrauen und sie öffnen.",[34,615,617],{"id":616},"nächste-schritte","Nächste Schritte",[206,619,620,625,632,639,644],{},[133,621,622,624],{},[28,623,169],{"href":168}," — Ihre transaktionalen Vorlagen bauen",[133,626,627,631],{},[28,628,630],{"href":629},"\u002Fguide\u002Femail-templates","E-Mail-Vorlagen"," — das Vorlagensystem verstehen",[133,633,634,638],{},[28,635,637],{"href":636},"\u002Fguide\u002Fdeliverability","Zustellbarkeit"," — dafür sorgen, dass Ihre transaktionalen E-Mails Posteingänge erreichen",[133,640,641,643],{},[28,642,433],{"href":432}," — Anhänge und Bilder an einem Ort verwalten",[133,645,646,648],{},[28,647,392],{"href":391}," — transaktionalen Versand in Ihre App integrieren",[650,651,652],"style",{},"html pre.shiki code .sYgZi, html code.shiki .sYgZi{--shiki-default:#24292E;--shiki-dark:#ADBAC7}html pre.shiki code .snmFh, html code.shiki .snmFh{--shiki-default:#005CC5;--shiki-dark:#8DDB8C}html pre.shiki code .s-HuK, html code.shiki .s-HuK{--shiki-default:#032F62;--shiki-dark:#96D0FF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":452,"searchDepth":466,"depth":466,"links":654},[655,656,659,660,661,662,663,667,668],{"id":36,"depth":466,"text":37},{"id":127,"depth":466,"text":128,"children":657},[658],{"id":200,"depth":483,"text":201},{"id":225,"depth":466,"text":226},{"id":324,"depth":466,"text":325},{"id":356,"depth":466,"text":357},{"id":400,"depth":466,"text":401},{"id":418,"depth":466,"text":419,"children":664},[665,666],{"id":425,"depth":483,"text":426},{"id":437,"depth":483,"text":438},{"id":586,"depth":466,"text":587},{"id":616,"depth":466,"text":617},"Eins-zu-eins-E-Mails, die Ihre Anwendung als Reaktion auf eine Nutzeraktion auslöst — Passwort-Resets, Bestellbestätigungen, Willkommens-E-Mails und ähnliche Benachrichtigungen.","md",{},true,"\u002Fguide\u002Ftransactional",{"title":6,"description":669},"1.guide\u002F17.transactional","N4bJt8juyabqtnk2jfbPNyZ8qntAOXthwn6CDROKvOw",[678,682],{"title":679,"path":680,"stem":681,"children":-1},"Automationen","\u002Fguide\u002Fautomations","1.guide\u002F16.automations",{"title":683,"path":684,"stem":685,"children":-1},"Kampagne erstellen","\u002Fguide\u002Fcreate-campaign","1.guide\u002F18.create-campaign",1786915099739]