E-Mails & E-Mail Einstellungen - WEBSALE Dokumentation

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`)

{
  "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	Name der zu verwendenden E-Mail-Vorlage (Dateiname, ggf. mit Unterpfad innerhalb von `mails/`). Darüber werden Inhalt und Layout der E-Mail gesteuert. Das Verzeichnis `mails/` wird vom System automatisch vorangestellt - siehe Hinweis unten.
`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.

"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). 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
Bewertungserinnerungs-E-Mail — Erinnerung zur Abgabe einer Produktbewertung nach dem Kauf. Konfiguration im Admin Interface unter Marketing → Kundenbewertungen.	general.productRating → `reminderEmail`
Benachrichtigung über neue Produktbewertung (Händler) — E-Mail an den Händler zur Information über eine neu abgegebene Produktbewertung.	actions.productRatingAdd
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
Bestätigungs-/Verify-E-Mail bei E-Mail-Adressänderung — Bestätigungs-/Verify-E-Mail an die neue Adresse (Bestätigungslink).	actions.emailUpdate
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
Bestätigung zum Löschen des Kundenkontos — Bestätigungs-E-Mail, dass das Kundenkonto gelöscht worden ist.	actions.accountDelete
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
Registrierungsbestätigung (Verifizierungsmail) — E-Mail zur Verifizierung der Registrierung bzw. Bestätigung der E-Mail-Adresse nach dem Anlegen eines Kundenkontos.	actions.accountRegister
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 → `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
Wieder-verfügbar-Benachrichtigung (Back in Stock) — E-Mail an den Kunden, sobald ein zuvor nicht verfügbarer Artikel wieder lieferbar ist.	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
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

Hinweis: Einige System-E-Mails sind rechtlich bzw. funktional notwendig und können daher ggf. nicht deaktiviert werden.

​Konfiguration eines E-Mail-Abschnitts

​Beispielkonfiguration (aus actions.checkoutConfirm)

​Parameterübersicht

​E-Mail-Template-Verzeichnis

​E-Mail-Benachrichtigungen im Überblick

Konfiguration eines E-Mail-Abschnitts

Beispielkonfiguration (aus `actions.checkoutConfirm`)

Parameterübersicht

E-Mail-Template-Verzeichnis

E-Mail-Benachrichtigungen im Überblick