> ## Documentation Index > Fetch the complete documentation index at: https://dokumentation.websale.de/llms.txt > Use this file to discover all available pages before exploring further. # E-Mails & E-Mail Einstellungen > Überblick aller vom Shop versendeten E-Mails und das einheitliche Konfigurationsprinzip (Template, Betreff, Absenderadresse, Absendername) je E-Mail-Typ. Das WEBSALE Shopsystem versendet eine Vielzahl von E-Mails zu unterschiedlichen Zwecken, zum Beispiel im Checkout, im Kundenkonto, bei Formularanfragen oder für Benachrichtigungen. Diese Seite gibt einen Überblick über alle vom Shopsystem versendeten E-Mails und beschreibt das einheitliche Konfigurationsprinzip, nach dem die einzelnen E-Mail-Typen angepasst werden können (z. B. Template, Betreff und Absenderdaten). *** ## Konfiguration eines E-Mail-Abschnitts Die Konfiguration einzelner E-Mail-Abschnitte folgt in WEBSALE einem einheitlichen Muster: Unabhängig davon, ob die E-Mail in `actions`, `inquiry`, `messages` etc. definiert ist, werden in der Regel Template, Betreff sowie Absenderdaten über dieselben Grundparameter gesteuert (z. B. `template`, `subject`, `fromAddress`, `fromName`). Im folgenden Abschnitt wird dieses Schema beschrieben und gezeigt, wie ein E-Mail-Abschnitt aufgebaut und konfiguriert wird. #### Beispielkonfiguration (aus `actions.checkoutConfirm`) ```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}} { "customerEmail": { "template": "order_confirmation_customer.htm", "subject": "Ihre Bestellung bei Mein Onlineshop", "fromAddress": "noreply@meinshop.de", "fromName": "Mein Onlineshop", "merchantEmail": "bestellungen@meinshop.de", "attachments": [ { "name": "AGB.pdf", "file": "/files/agb.pdf" } ] } } ``` #### Parameterübersicht | **Parameter** | **Typ** | **Beschreibung** | | ------------------------- | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `active` / `enabled` | bool | Aktiviert/deaktiviert den Versand der E-Mail, sofern der Parameter in der jeweiligen E-Mail-Konfiguration vorhanden ist. Bei bestimmten E-Mails (z. B. rechtlich notwendigen Systemmails wie Bestelleingangsbestätigungen) ist keine Deaktivierung vorgesehen, dort sind die Parameter `enabled` oder `active` nicht zulässig. | | `attachments` | array (object) | Liste von Dateianhängen, die mit der E-Mail versendet werden sollen. Je Anhang sind `name` und `file` anzugeben. Optionale Angabe. Nicht in jedem E-Mail-Abschnitt verfügbar. | | `fromAddress` | string | Absenderadresse, die im E-Mail-Versand versendet wird (z. B. `noreply@mein-shop.de`). | | `fromName` | string | Anzeigename des Absenders in der E-Mail (z. B. „Mein Onlineshop"). | | `mail` | string | Empfängeradresse, an die die E-Mail versendet wird. Bei bestimmten E-Mails ist dieser Parameter nicht vorgesehen, da der Versand dynamisch an eine im Shop angegebene E-Mail-Adresse erfolgt. | | `merchantEmail` | string | Optionale Möglichkeit, eine zusätzliche Benachrichtigung/Kopie an eine definierte Händleradresse zu senden. Dieser Parameter ist nur bei bestimmten E-Mails vorgesehen und nicht bei allen E-Mails konfigurierbar. | | `template` | string | Dateiname der zu verwendenden E-Mail-Vorlage aus dem Verzeichnis `templates/mails/`, angegeben **ohne** das Präfix `mails/`. Steuert Inhalt und Layout der E-Mail. Siehe Abschnitt [E-Mail-Template-Verzeichnis](#e-mail-template-verzeichnis). | | `subject` / `mailSubject` | string | Betreffzeile der E-Mail, wie sie im Posteingang des Kunden angezeigt wird. | *** ## E-Mail-Template-Verzeichnis Alle E-Mail-Templates liegen im Verzeichnis `templates/mails/`. Dieses Verzeichnis ist fest vorgegeben und wird beim `template`-Parameter automatisch vorangestellt. Geben Sie deshalb nur den Dateinamen an, ohne das Präfix `mails/`. Beispiel: Die Vorlage `templates/mails/password_forgotten.htm` wird so referenziert. ```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}} "email": { "template": "password_forgotten.htm", "subject": "Passwort zurücksetzen", "fromAddress": "noreply@meinshop.de", "fromName": "Mein Onlineshop" } ``` Der Grund für die Angabe ohne Präfix: Da `mails/` automatisch ergänzt wird, führt ein zusätzlich angegebenes `mails/` dazu, dass die Vorlage nicht gefunden wird. Die E-Mail wird in diesem Fall nicht versendet. Das Verzeichnis `mails` kann nicht umbenannt oder verschoben werden. Es ist ein festes Spezial-Verzeichnis der Template-Struktur (siehe [Template Theme](/frontend/die-basics/template-theme)). Eigene Unterordner innerhalb von `mails` werden für den `template`-Parameter nicht unterstützt. Eine Vorlage, die in einem Unterordner liegt (zum Beispiel `templates/mails/login/password_forgotten.htm`), ist über den `template`-Parameter nicht ansprechbar. Legen Sie Mail-Templates daher direkt in `mails/` ab. *** ## E-Mail-Benachrichtigungen im Überblick Im Folgenden findet sich eine Übersicht der E-Mails, die vom Shopsystem versendet werden. Diese E-Mails können nach dem oben beschriebenen Schema konfiguriert werden (z. B. Absender, Betreff und Template). | **E-Mail** | **Konfiguration** | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | | **Bestelleingangsbestätigungs-E-Mail an den Käufer** — Bestätigung des Bestelleingangs an den Kunden. Auslöser: Bestellabschluss / Kunde. Optional kann diese E-Mail zusätzlich als Kopie an eine konfigurierte Händleradresse (`merchantEmail`) versendet werden. | [actions.checkoutConfirm](/konfiguration/actions-fehlertexte-e-mails/actions-warenkorb-checkout#2-3-actions-checkoutconfirm-bestellung-abschließen) | | **Bewertungserinnerungs-E-Mail** — Erinnerung zur Abgabe einer Bewertung nach dem Kauf. | | | **Benachrichtigung über neue Produktbewertung (Händler)** — E-Mail an den Händler zur Information über eine neu abgegebene Produktbewertung. | [actions.productRatingAdd](/konfiguration/actions-fehlertexte-e-mails/actions-produkte#3-1-actions-productratingadd-produkt-bewerten) | | **Double-OptIn-E-Mail bei E-Mail-Adressänderung** — Optionale Double-Opt-In-E-Mail, bevor die neue E-Mail-Adresse übernommen wird. | [actions.emailUpdate](/konfiguration/actions-fehlertexte-e-mails/actions-benutzerkonto#6-1-actions-emailupdate-e-mail-adresse-ändern) | | **Bestätigungs-/Verify-E-Mail bei E-Mail-Adressänderung** — Bestätigungs-/Verify-E-Mail an die neue Adresse (Bestätigungslink). | [actions.emailUpdate](/konfiguration/actions-fehlertexte-e-mails/actions-benutzerkonto#6-1-actions-emailupdate-e-mail-adresse-ändern) | | **Double-OptIn-E-Mail bei Kundenkonto löschen** — Optionale Double-Opt-In-E-Mail zur Bestätigung des Löschwunsches vor Ausführung. | [actions.accountDelete](/konfiguration/actions-fehlertexte-e-mails/actions-benutzerkonto#2-1-actions-accountdelete-kontolöschung) | | **Bestätigung zum Löschen des Kundenkontos** — Bestätigungs-E-Mail, dass das Kundenkonto gelöscht worden ist. | [actions.accountDelete](/konfiguration/actions-fehlertexte-e-mails/actions-benutzerkonto#2-1-actions-accountdelete-kontolöschung) | | **Eingangsbestätigung Formular (Anfragender)** — Bestätigung, dass die Anfrage eingegangen ist (z. B. Kontaktformular). Optional kann diese E-Mail zusätzlich als Kopie an eine konfigurierte Händleradresse (`merchantEmail`) versendet werden. | [inquiry.form](/konfiguration/inquiry-formulare#inquiry-formulare) | | **Registrierungsbestätigung (Verifizierungsmail)** — E-Mail zur Verifizierung der Registrierung bzw. Bestätigung der E-Mail-Adresse nach dem Anlegen eines Kundenkontos. | [actions.accountRegister](/konfiguration/actions-fehlertexte-e-mails/actions-benutzerkonto#2-3-actions-accountregister-benutzer-registrieren) | | **Dublette bei Registrierung gefunden** — Information an ein bereits vorhandenes (Dubletten-)Konto, wenn bei einer Registrierung eine Dublette erkannt wird. Im E-Mail-Template ist über `$wsRequestVariables.email` die bei der Registrierung angegebene Adresse ausgebbar (z. B. damit der Account-Admin ein Subaccount für den Nutzer anlegen kann). | [accounts.account](/konfiguration/accounts-benutzerkonten) → `duplicate.foundEmail` | | **Ereignisgesteuerte/individuelle Benachrichtigungen** — Zusätzliche E-Mails können definiert werden, die beim Aufruf bestimmter Shopseiten oder beim Ausführen definierter Aktionen versendet werden. | [messages.emails](/konfiguration/messages-ereignisgesteuerte-e-mails#2-messages-emails-ereignisgesteuerte-e-mails) | | **Wieder-verfügbar-Benachrichtigung (Back in Stock)** — E-Mail an den Kunden, sobald ein zuvor nicht verfügbarer Artikel wieder lieferbar ist. | [content.inventory](/konfiguration/content-katalog-kategorien-produkte#beispielkonfiguration-content-inventory) | | **Lagerbestandsmitteilung (Bestandswarnung)** — E-Mail an den Händler mit einer Übersicht über Artikel mit niedrigem Bestand (bis zur konfigurierten Anzahl), versendet an eine definierte Empfängeradresse. | [content.inventory](/konfiguration/content-katalog-kategorien-produkte#beispielkonfiguration-content-inventory) | | **Zahlung fehlgeschlagen (Kunde)** — E-Mail an den Kunden mit Hinweis, dass die Zahlung zur Bestellung fehlgeschlagen ist. Optional kann diese E-Mail zusätzlich als Kopie an eine konfigurierte Händleradresse (`merchantEmail`) versendet werden. | [actions.checkoutConfirm](/konfiguration/actions-fehlertexte-e-mails/actions-warenkorb-checkout#2-3-actions-checkoutconfirm-bestellung-abschließen) | Hinweis: Einige System-E-Mails sind rechtlich bzw. funktional notwendig und können daher ggf. nicht deaktiviert werden.