> ## 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.

# Benutzerdefinierte E-Mails

Zusätzlich zu den regulären E-Mails, die jeder Shop verschicken kann, wenn typische Situationen eintreten, beispielsweise beim Erreichen eines bestimmten Lagerbestands eines Produkts, ist es manchmal sinnvoll, automatische Mails an den Shop-Verantwortlichen zu schicken in Situationen, die nur für einzelne Shops bedeutsam sind.

So kann es beispielsweise hilfreich sein, wenn der Shop Produkte von verschiedenen Herstellern führt und diesen Herstellern jeweils Mails schickt, wenn Käufer im Shop Produkte der Hersteller bestellen. Die betreffenden Hersteller versetzt das in die Lage, ihren Lagerbestand der betreffenden Produkte zu prüfen und die Lieferung vorzubereiten, um ausliefern zu können, sobald die Bestellung platziert wird.

Grundsätzlich erlaubt WEBSALE V8s, für solche Anforderungen benutzerdefinierte E-Mails vorzubereiten, also vom Shopbetreiber konfigurierte, die an zuvor definierte Empfänger versendet werden. Ausgelöst wird der Versand, wenn ein Käufer eine bestimmte Seite aufruft, beispielsweise durch Klick auf eine bestimmte Produktansichts-Seite, oder wenn ein bestimmter Shop-Zustand erreicht wird, beispielsweise ein eingeloggter Kunde, oder nicht erreicht wird, beispielsweise eine Suche nach Produkt A ohne Treffer. Den letztgenannten Fall greifen wir unten in den Integrationsbeispielen auf.

## Funktionsweise

Der Shop versendet automatisch eine E-Mail an eine statisch hinterlegte Empfängeradresse, wenn eine bestimmte Seite angeklickt oder ein bestimmter Zustand des Shops erreicht oder nicht erreicht wird.

Die E-Mail kann nicht an dynamische Empfänger verschickt werden, also beispielsweise nicht an einen Shop-Kunden, da die Empfänger-Adresse statisch in der Shopkonfiguration `shop.config` hinterlegt werden muss.

## Integration

### Schritt 1: Freischaltung

Für diese Funktion ist keine Freischaltung seitens WEBSALE nötig.

### Schritt 2: Shopkonfiguration anpassen

Legen Sie in Ihrer Shopkonfiguration `shop.config` einen Abschnitt `GenericEmails` an, falls noch nicht vorhanden, sowie einen Unterabschnitt `+Entry`. Die Unterabschnitte `+Entry` können für verschiedene E-Mails bis zu 20 Mal wiederholt werden. Konfigurieren Sie die folgenden Parameter:

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<GenericEmails>
   ...
   <+Entry>
      Address          = info@mein-shop.de
      Subject-Txt      = Betreff xY
      SenderAddress    = absender@mein-shop.de
      SenderName       = Mein Shop
      Template         = mail_xY.htm
      ID               = beispiel_id
   </+Entry>
   ...
</GenericEmails>
```

Referenz: [Abschnitt GenericEmails](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/e-mails.md#genericemails)

### Schritt 3: Shop-Templates anpassen

Passen Sie nun die gewünschten Shop-Templates an, um den Versand der E-Mail zu steuern. Benutzen Sie hierfür das Tag `WS-SendGenericEmail()`. Tragen Sie im Argument des Tags die Zeichenfolge ein, die Sie in Schritt 2 als Wert des Parameters `ID` angegeben haben.

**Beispiel 1, Suchergebnisseite.** Die E-Mail wird versandt, wenn der Käufer eine Suche ausgeführt und die Suchergebnisseite erreicht hat.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<body>
   ...
   ~WS-SendGenericEmail(Search)~
   ...
</body>
```

Inhalt der Mail kann sein: "Ein Kunde hat die Suche-Seite des Shops besucht."

**Beispiel 2, Suchergebnisseite ohne Treffer.** Die E-Mail wird versandt, wenn der Käufer eine Suche ausgeführt und die Suchergebnisseite erreicht hat, dabei jedoch kein Ergebnis erzielt wurde. Das ist die Kombination aus dem Erreichen der Seite und einem bestimmten Zustand.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<body>
   ...
   {!WS-SearchResults}
      ~WS-SendGenericEmail(Search)~
   {/!WS-SearchResults}
   ...
</body>
```

Inhalt der Mail kann sein: "Ein Kunde hat die Suche-Seite des Shops besucht, zu seiner Suche wurden jedoch keine Treffer gefunden."

**Beispiel 3, zwei Mails für zwei Zustände derselben Seite.** Mail 1 mit der ID `SuccessSearch` wird versandt, wenn der Käufer etwas gefunden hat, Mail 2 mit der ID `EmptySearch`, wenn die Suche erfolglos blieb. Das ist die Kombination aus dem Erreichen der Seite und unterschiedlichen Zuständen. Voraussetzung ist, dass in der Shopkonfiguration `shop.config` zwei Abschnitte mit den entsprechenden IDs angelegt wurden.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<body>
   ...
   {WS-SearchResults}
      <!-- Suchergebnisseite mit Ergebnis -->
      ~WS-SendGenericEmail(SuccessSearch)~
   {/WS-SearchResults}

   {!WS-SearchResults}
      <!-- Suchergebnisseite ohne Ergebnis -->
      ~WS-SendGenericEmail(EmptySearch)~
   {/!WS-SearchResults}
   ...
</body>
```

Inhalt von Mail 1 mit der ID `SuccessSearch` kann sein: "Ein Kunde hat die Suche-Seite des Shops besucht, und zu seiner Suche wurden Treffer gefunden."

Inhalt von Mail 2 mit der ID `EmptySearch` kann sein: "Ein Kunde hat die Suche-Seite des Shops besucht, seine Suche brachte jedoch keine Treffer."

**Beispiel 4, leere Kategorie.** Auf der Produktübersichtsseite (`ws_category.htm`) wird die E-Mail versandt, wenn die Kategorie keine Produkte enthält.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<body>
   ...
   {CAT-Data}
      ~DC-FPCategoryHasProducts_set(yes)~
   {/CAT-Data}

   {!DC-FPCategoryHasProducts(yes)}
      ~DC-FPCatIndex_set($CAT-Index$)~
      ~DC-FPCatName_set($CAT-Name$)~
      ~WS-SendGenericEmail(EmptyCategory)~
   {/!DC-FPCategoryHasProducts(yes)}
   ...
</body>
```

Inhalt der Mail kann sein: "Die Kategorie mit dem Namen `~DC-FPCatName~` und dem Kategorieindex `~DC-FPCatIndex~` ist leer, sie enthält keine Produkte."

Referenz: [WS-SendGenericEmail()](https://dokumentation.websale.de/v8s/referenz/tags/ws/merkzettel-vergleich-upload-und-externe-dienste.md#die-tags-im-uberblick)

### Schritt 4: E-Mail-Template anlegen

Legen Sie ein Template an und speichern Sie es unter dem gleichen Namen, der im Abschnitt `GenericEmails` als Wert des Parameters `Template` angegeben ist, in Ihrem Templateverzeichnis, beispielsweise `benutzer/templates/translation`.

Der Inhalt des Templates ist abhängig davon, wie der Versand gesteuert wird.

Haben Sie alle Schritte durchgeführt, ist die Funktion vollständig integriert und kann getestet und eingesetzt werden.


## Related topics

- [messages - Ereignisgesteuerte E-Mails](https://dokumentation.websale.de/konfiguration/messages-ereignisgesteuerte-e-mails.md)
- [Konfigurations-Deeplinks](https://dokumentation.websale.de/admin-interface/konfigurations-deeplinks.md)
- [E-Mail-Benachrichtigungen: Übersicht](https://dokumentation.websale.de/v8s/e-mails/e-mail-benachrichtigungen-ueberblick.md)
- [E-Mails](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/e-mails.md)
- [E-Mails & E-Mail Einstellungen](https://dokumentation.websale.de/konfiguration/e-mails-e-mail-einstellungen.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.