E-Mail-Vorlagen

Auris sendet Transaktions-E-Mails für Authentifizierungs- und Kontoereignisse: E-Mail-Verifizierung, Passwort-Resets, Magic-Link-Logins, Einladungen, Sicherheitswarnungen und mehr. Die Konsole enthält einen Vorlageneditor, mit dem du Betreff, Inhalt und Design jedes E-Mail-Typs anpassen kannst — pro Sprache — ohne Code zu schreiben.

Den Editor erreichst du über Konsole -> Einstellungen -> E-Mail-Vorlagen.

Vorlagentypen

Auris enthält dreizehn transaktionale E-Mail-Vorlagen, jede wird durch ein bestimmtes Ereignis ausgelöst:

Vorlagentyp	Auslöser
`verification`	Ein neuer Benutzer registriert sich und muss seine E-Mail-Adresse verifizieren
`password_reset`	Ein Benutzer fordert einen Passwort-Reset an
`invitation`	Ein Benutzer wird eingeladen, einem Tenant beizutreten
`mfa_code`	Die E-Mail-basierte Zwei-Faktor-Authentifizierung sendet einen Verifizierungscode
`magic_link`	Ein Benutzer fordert einen passwortlosen Login per Magic Link an
`login_alert`	Eine neue Anmeldung wird auf dem Konto erkannt
`welcome`	Ein Benutzer verifiziert erfolgreich seine E-Mail-Adresse
`password_changed`	Das Passwort eines Benutzers wird geändert (Bestätigungshinweis)
`account_locked`	Ein Konto wird nach zu vielen fehlgeschlagenen Anmeldeversuchen gesperrt
`suspicious_login`	Eine Anmeldung von einem ungewöhnlichen Ort, Gerät oder einer ungewöhnlichen IP wird erkannt
`email_changed`	Die primäre E-Mail wird geändert (an die alte Adresse gesendet)
`license_issued`	Ein Lizenzschlüssel wird für einen Kunden ausgestellt
`ciba`	Eine Anwendung fordert die Anmeldebestätigung über den CIBA-Flow (Backchannel) an

Jede Vorlage kann unabhängig bearbeitet werden, in jeder Sprache. Änderungen gelten für alle Anwendungen des Tenants.

Solange du eine Vorlage nicht angepasst hast, verwendet Auris eine Standardvorlage, die mit deinem Tenant-Branding gerendert wird (Firmenname, Logo, Primärfarbe — siehe Branding). Das Anpassen einer Vorlage ersetzt das Standard-HTML für diesen Typ und diese Sprache vollständig.

Die magic_link-E-Mail enthält zwei Schaltflächen: einen primären Anmelde-Link, der den Benutzer auf dem Gerät anmeldet, das die E-Mail öffnet, und einen sekundären Bestätigungs-Link, der die Sitzung auf dem Gerät bestätigt, von dem der Login-Flow gestartet wurde.

Den Vorlageneditor verwenden

Wähle einen Vorlagentyp

Öffne Einstellungen -> E-Mail-Vorlagen und klicke auf die Vorlage, die du anpassen möchtest.

Wähle einen Bearbeitungsmodus

Der Editor bietet drei Modi:

Theme-Editor — passe Identität (Logo, Markenname, Footer-Text), Farben, Typografie, Button-Stil, Layout und den Inhalt an, ohne das vollständige HTML anzufassen.
Visueller Builder — setze die E-Mail aus Blöcken auf einer Arbeitsfläche zusammen.
Code-Editor — bearbeite HTML und CSS direkt. Eine Snippet-Bibliothek liefert fertige Ausgangspunkte.

Bearbeite Betreff und Inhalt

Sowohl der Betreff als auch der Inhalt unterstützen {{variable}}-Platzhalter. Im Inhalt kannst du auf eine Variable klicken, um sie an der Cursorposition einzufügen — der Editor listet genau die Variablen auf, die für den gewählten Vorlagentyp verfügbar sind.

Verwalte Sprachen

Jede Vorlage kann eine eigene Version pro Sprache haben. Fünf Sprachen bringen integrierte Standardvorlagen mit: Englisch, Italienisch, Französisch, Deutsch und Spanisch. Über die Sprachauswahl kannst du jeden weiteren Locale-Code hinzufügen (zum Beispiel pt-BR); Sprachen ohne integrierten Standard fallen auf Englisch zurück, bis du eine eigene Version speicherst.

Beim Versand löst Auris die Vorlage in dieser Reihenfolge auf: eigene Vorlage in der Sprache des Benutzers -> eigene Vorlage auf Englisch -> integrierter Standard in der Sprache des Benutzers -> integrierter Standard auf Englisch.

Sieh dir die Vorschau an

Die Live-Vorschau rendert deine Vorlage mit Beispieldaten, während du sie bearbeitest. Nutze den Geräteumschalter für Desktop-, Tablet- und Mobil-Layouts oder öffne die Vollbildvorschau.

Sende eine Test-E-Mail

Klicke auf Test senden. Auris rendert die Vorlage mit Beispieldaten und sendet sie an deine eigene E-Mail-Adresse (den authentifizierten Administrator). Der Betreff erhält das Präfix [TEST], damit die Mail leicht von echten Transaktions-E-Mails zu unterscheiden ist.

Speichere die Vorlage

Klicke auf Speichern, um deine Änderungen zu übernehmen. Die Vorlage gilt sofort für alle zukünftigen E-Mails dieses Typs und dieser Sprache. Mit Auf Standard zurücksetzen löschst du die eigene Version der aktuellen Sprache und kehrst zur integrierten Vorlage zurück.

E-Mail-Clients unterstützen HTML und CSS uneinheitlich. Verwende Inline-CSS und Tabellenlayouts für komplexe Strukturen und sende Test-E-Mails an echte Clients, bevor du Produktionsvorlagen speicherst. Gespeichertes HTML wird serverseitig bereinigt (Skripte, Event-Handler und eingebettete Frames werden entfernt) und ist auf 500 KB begrenzt.

Vorlagenvariablen

Globale Variablen

Diese Datumsvariablen werden automatisch in jedes Rendering injiziert:

Variable	Beschreibung	Beispielwert
`{{year}}`	Aktuelles Jahr	`2026`
`{{month}}`	Aktueller Monat (zweistellig)	`07`
`{{day}}`	Aktueller Tag (zweistellig)	`23`
`{{date}}`	Aktuelles Datum im Format `YYYY-MM-DD`	`2026-07-23`

Variablen pro Vorlage

Jeder Vorlagentyp hat sein eigenes Variablen-Set:

Vorlage	Variablen
`verification`	`email`, `link`, `expiresIn`
`password_reset`	`email`, `link`, `expiresIn`
`invitation`	`email`, `orgName`, `role`, `inviterEmail`, `link`, `expiresIn`
`mfa_code`	`email`, `code`, `expiresIn`
`magic_link`	`email`, `link`, `approveLink`, `expiresIn`, `tenantName`
`login_alert`	`email`, `device`, `ipAddress`, `location`, `time`
`welcome`	`email`, `name`, `orgName`, `dashboardLink`
`password_changed`	`email`, `name`, `time`, `ipAddress`
`account_locked`	`email`, `name`, `lockDuration`, `attempts`, `ipAddress`, `time`
`suspicious_login`	`email`, `name`, `device`, `ipAddress`, `location`, `time`, `reason`
`email_changed`	`email`, `name`, `newEmail`, `time`
`license_issued`	`key`, `jwtToken`, `product`, `expiresAt`, `features`
`ciba`	`email`, `appName`, `bindingMessage`, `approveUrl`, `denyUrl`

Vorlagensyntax

{{variable}} — wird durch den Wert ersetzt, aus Sicherheitsgründen HTML-escaped. Im Betreff (reiner Text, kein HTML) werden Werte ohne Escaping eingefügt.
{{{variable}}} — Raw-Interpolation ohne HTML-Escaping. Nur für vertrauenswürdige, serverseitig erzeugte HTML-Fragmente.
{{#if variable}}...{{/if}} — der eingeschlossene Inhalt bleibt nur erhalten, wenn die Variable einen nicht-leeren Wert hat. Nützlich für optionale Elemente wie den approveLink-Button in magic_link.

Es gibt keine Punktnotation ({{user.name}} wird nicht unterstützt) und keine Schleifen. Variablennamen unterscheiden Groß- und Kleinschreibung.

Unbekannte Platzhalter bleiben unverändert in der Ausgabe. Wenn eine gesendete E-Mail wörtliches {{text}} enthält, prüfe den Variablennamen anhand der Tabelle oben.

E-Mail-Versand und Footer

Auris versendet E-Mails über die SMTP-Konfiguration deines Tenants, wenn eine vorhanden und aktiv ist; andernfalls wird der Standardabsender der Plattform verwendet. SMTP-Einstellungen, ein Verbindungstest und die Footer-Optionen befinden sich unter Konsole -> Einstellungen -> 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.

Diese Schalter gelten für die Standardvorlagen (nicht angepasste); eine eigene Vorlage ersetzt das gesamte HTML, Footer inklusive. Details unter Branding.

API-Referenz

E-Mail-Vorlagen können auch programmatisch über die REST-API verwaltet werden. Vollständige Requests und Responses findest du in der E-Mail-Vorlagen-API.

GET/api/email-templates

GET/api/email-templates/{type}

PUT/api/email-templates/{type}

DELETE/api/email-templates/{type}

POST/api/email-templates/{type}/preview

POST/api/email-templates/{type}/test

Berechtigungen

Berechtigung	Beschreibung
`manage:security`	Erforderlich zum Auflisten, Ansehen, Bearbeiten, Löschen, Vorschauen und Testen von E-Mail-Vorlagen.