E-Mail-Vorlagen anpassen

Auris sendet Transaktions-E-Mails an kritischen Punkten im Benutzerlebenszyklus: E-Mail-Verifizierung, Passwort-Resets, Magic-Link-Logins, Einladungen, Sicherheitswarnungen und mehr. Standardmäßig verwenden diese E-Mails eine schlichte Vorlage, die mit deinem Tenant-Branding gerendert wird (Firmenname, Logo, Primärfarbe). Durch Anpassung erhältst du die volle Kontrolle über das HTML, sodass jeder Berührungspunkt — von der ersten Verifizierungs-E-Mail bis zu einer Warnung über eine verdächtige Anmeldung Monate später — zu deinem Produkt passt.

Diese Anleitung führt dich durch das Bearbeiten von Vorlagen in der Konsole, die Verwendung dynamischer Variablen und bedingter Blöcke, Vorschau und Test von Änderungen, die Sprachverwaltung und die programmatische Verwaltung über die API.

Vorlagentypen

Auris enthält dreizehn E-Mail-Vorlagentypen. Jeder wird automatisch zum passenden Zeitpunkt ausgelöst.

Jede Vorlage lässt sich unabhängig anpassen, und unabhängig pro Sprache.

Schritt 1: Öffne den Vorlageneditor

1. Öffne die Auris-Konsole und gehe zu Einstellungen, dann E-Mail-Vorlagen
2. Du siehst alle dreizehn Vorlagentypen mit ihrem aktuellen Status (Standard oder angepasst)
3. Klicke auf den Vorlagentyp, den du bearbeiten möchtest

Schritt 2: Wähle einen Bearbeitungsmodus

Der Editor bietet drei Modi:

• Theme-Editor — passe Identität (Logo, Markenname, Footer-Text), Farben, Typografie, Buttons, Layout und Inhalt über visuelle Panels an.
• Visueller Builder — setze die E-Mail aus Blöcken auf einer Arbeitsfläche zusammen.
• Code-Editor — bearbeite rohes HTML und CSS. Eine Snippet-Bibliothek liefert fertige Ausgangspunkte.

Egal welchen Modus du nutzt: das Ergebnis ist ein vollständiges HTML-Dokument, gespeichert pro Vorlagentyp und Sprache. Die meisten E-Mail-Clients haben eingeschränkte CSS-Unterstützung — Inline-Styles und Tabellenlayouts sind der zuverlässigste Ansatz.

Schritt 3: Nutze Vorlagenvariablen

Variablen verwenden die Syntax {{variablenName}}. Beim Versand ersetzt Auris jeden Platzhalter durch den tatsächlichen Wert für diesen Benutzer und dieses Ereignis. Im Inhalt werden Werte automatisch HTML-escaped; im Betreff werden sie als reiner Text eingefügt.

Globale Variablen (in allen Vorlagen verfügbar)

Typspezifische Variablen

Bedingungen und Raw-Interpolation

• {{#if variable}}...{{/if}} behält den eingeschlossenen Inhalt nur, wenn die Variable einen nicht-leeren Wert hat. Andernfalls wird der Block — samt Markup — entfernt.
• {{{variable}}} fügt den Rohwert ohne HTML-Escaping ein. Nur für vertrauenswürdige, serverseitig erzeugte HTML-Fragmente verwenden.

Beispiel für eine magic_link-Vorlage:

<h1>Anmelden bei {{tenantName}}</h1>
<p><a href="{{link}}">Auf diesem Gerät anmelden</a></p>
{{#if approveLink}}
<p><a href="{{approveLink}}">Auf dem Gerät bestätigen, auf dem du die Anmeldung gestartet hast</a></p>
{{/if}}
<p>Dieser Link läuft in {{expiresIn}} ab.</p>

Schritt 4: Verwalte Sprachen

Integrierte Standardvorlagen gibt es in fünf Sprachen: Englisch (en), Italienisch (it), Französisch (fr), Deutsch (de) und Spanisch (es). Eigene Vorlagen können für jeden Locale-Code (zum Beispiel pt-BR) über die Sprachauswahl des Editors gespeichert werden.

Beim Versand löst Auris die Vorlage in dieser Reihenfolge auf:

1. Eigene Vorlage in der Sprache des Empfängers
2. Eigene Vorlage auf Englisch
3. Integrierter Standard in der Sprache des Empfängers
4. Integrierter Standard auf Englisch

Du kannst also nur die Sprachen anpassen, die dir wichtig sind — der Rest funktioniert weiter mit den Standards.

Schritt 5: Vorschau

Die Live-Vorschau rendert die Vorlage mit realistischen Beispieldaten, während du sie bearbeitest (zum Beispiel [email protected] für {{email}} und 24 hours für {{expiresIn}}). Nutze den Geräteumschalter für Desktop-, Tablet- und Mobilbreiten oder öffne die Vollbildvorschau.

Schritt 6: Sende eine Test-E-Mail

Klicke im Editor auf Test senden. Auris rendert die Vorlage mit Beispieldaten und sendet sie an deine eigene E-Mail-Adresse (den authentifizierten Administrator), mit dem Betreff-Präfix [TEST]. Über die API kannst du optional mit dem Feld recipientEmail einen anderen Empfänger angeben.

Prüfe die E-Mail in deinem Posteingang:

• Logo und Bilder werden korrekt geladen
• Der Aktions-Button ist klickbar und richtig gestylt
• Das Layout stimmt auf Desktop und Mobilgeräten
• Alle Platzhalter wurden ersetzt (kein wörtliches {{text}} übrig)
• Die E-Mail landet nicht im Spam-Ordner

Schritt 7: Speichern

Klicke auf Speichern, um zu veröffentlichen. Änderungen gelten sofort für alle zukünftigen E-Mails dieses Typs und dieser Sprache — kein Deployment, kein Neustart. Gespeichertes HTML wird serverseitig bereinigt (Skripte, Event-Handler, eingebettete Frames werden entfernt) und muss unter 500 KB bleiben.

Um zur Standardvorlage der aktuellen Sprache zurückzukehren, klicke auf Auf Standard zurücksetzen. Das löscht die eigene Version und stellt die integrierte, mit dem Tenant-Branding gerenderte Vorlage wieder her.

E-Mail-Versand

Auris versendet E-Mails über die SMTP-Konfiguration deines Tenants, wenn eine vorhanden und aktiv ist; andernfalls wird der Standardabsender der Plattform verwendet. SMTP (Host, Port, Zugangsdaten, Absenderadresse), einen Verbindungstest und die Footer-Optionen konfigurierst du unter Einstellungen, dann E-Mail:

• White-Label-E-Mails entfernt den Hinweis “Powered by Altovar” aus dem Footer der Standardvorlagen.
• Footer ausblenden lässt den Footer-Bereich komplett weg.

Für die Zustellbarkeit konfiguriere die DNS-Einträge SPF, DKIM und DMARC für deine Absenderdomain — dein E-Mail-Anbieter liefert die genauen Werte.

Programmatische Vorlagenverwaltung

Alle in der Konsole verfügbaren Operationen lassen sich auch über die E-Mail-Vorlagen-API ausführen. Alle Endpunkte erfordern die Berechtigung manage:security und den Header x-tenant.

Alle Vorlagen auflisten

curl https://auth.deinedomain.com/api/email-templates \
  -H "Authorization: Bearer $AURIS_ACCESS_TOKEN" \
  -H "x-tenant: dein-realm"

Liefert jeden Typ mit label, description, variables, hasCustomTemplate, customLocales, plus availableLocales (die fünf integrierten Sprachen).

Eine Vorlage abrufen (mit Standard-Baseline)

curl "https://auth.deinedomain.com/api/email-templates/verification?locale=de" \
  -H "Authorization: Bearer $AURIS_ACCESS_TOKEN" \
  -H "x-tenant: dein-realm"

Liefert die eigenen subject/htmlBody für diese Sprache (oder null), zusammen mit defaultSubject/defaultHtmlBody, gerendert mit deinem Tenant-Branding.

Eine Vorlage aktualisieren

curl -X PUT https://auth.deinedomain.com/api/email-templates/verification \
  -H "Authorization: Bearer $AURIS_ACCESS_TOKEN" \
  -H "x-tenant: dein-realm" \
  -H "Content-Type: application/json" \
  -d '{
    "subject": "Bestätige deine E-Mail",
    "htmlBody": "<!DOCTYPE html><html><body><p>Hallo {{email}},</p><p><a href=\"{{link}}\">Bestätige deine Adresse</a> — läuft in {{expiresIn}} ab.</p></body></html>",
    "locale": "de"
  }'

Eine Vorlage vorschauen

curl -X POST https://auth.deinedomain.com/api/email-templates/verification/preview \
  -H "Authorization: Bearer $AURIS_ACCESS_TOKEN" \
  -H "x-tenant: dein-realm" \
  -H "Content-Type: application/json" \
  -d '{ "subject": "Bestätige deine E-Mail", "htmlBody": "<p>Hallo {{email}}</p>" }'

Liefert { "subject": ..., "html": ..., "variables": { ... } } mit Beispielwerten gerendert. Es wird nichts gesendet.

Eine Test-E-Mail senden

curl -X POST https://auth.deinedomain.com/api/email-templates/verification/test \
  -H "Authorization: Bearer $AURIS_ACCESS_TOKEN" \
  -H "x-tenant: dein-realm" \
  -H "Content-Type: application/json" \
  -d '{ "subject": "Bestätige deine E-Mail", "htmlBody": "<p>Hallo {{email}}</p>", "recipientEmail": "[email protected]" }'

recipientEmail ist optional — ohne dieses Feld geht der Test an dein eigenes Postfach (das des authentifizierten Administrators). Die Antwort ist { "success": true, "sentTo": "..." }.

Löschen (auf Standard zurücksetzen)

curl -X DELETE "https://auth.deinedomain.com/api/email-templates/verification?locale=de" \
  -H "Authorization: Bearer $AURIS_ACCESS_TOKEN" \
  -H "x-tenant: dein-realm"

Mit ?locale= wird nur die eigene Version dieser Sprache gelöscht. Ohne werden alle Sprachen des Typs gelöscht.

Best Practices

Halte Vorlagen einfach. Die HTML-Unterstützung von E-Mail-Clients ist notorisch uneinheitlich. Nutze Inline-Styles, Tabellenlayouts und Systemschriften für maximale Kompatibilität.

Füge immer die Aktions-URL als Text hinzu. Unter jedem Aktions-Button die rohe URL als Text angeben. Manche Clients rendern HTML-Buttons nicht korrekt, und manche Benutzer prüfen URLs lieber vor dem Klicken. Auris leitet außerdem automatisch einen text/plain-Teil aus deinem HTML ab und erhält dabei die Link-Ziele.

Nutze {{expiresIn}}, um Erwartungen zu setzen. Sag dem Benutzer immer, wie lange ein Link oder Code gültig ist.

Behalte den bedingten Bestätigungs-Button in magic_link. Umschließe den sekundären Button mit {{#if approveLink}}...{{/if}} — die Variable ist leer für Flows ohne geräteübergreifende Bestätigung, und die Bedingung entfernt den Button sauber.

Keine sensiblen Daten. Niemals Passwörter oder vollständige API-Schlüssel in E-Mails aufnehmen. E-Mails können unbegrenzt in Postfächern liegen bleiben.

Versioniere deine Vorlagen. Wenn du Vorlagen über die API verwaltest, halte den HTML-Quelltext in deinem Repository: Änderungshistorie, Review und Rollback inklusive.

Fehlerbehebung

Verwandte Anleitungen

• E-Mail-Vorlagen (Konsole) — Editor-Referenz und Vorlagenkatalog
• E-Mail-Vorlagen-API — Vollständige Endpunkt-Referenz
• Branding — Tenant-Branding auf Standard-E-Mails
• Magic-Link-Login — Der Flow hinter der magic_link-Vorlage