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

# messages - Ereignisgesteuerte E-Mails

> Der messages-Knoten konfiguriert ereignisgesteuerte, benutzerdefinierte E-Mails an Shop-Verantwortliche, Lieferanten oder Hersteller via Template-Trigger.

export const KonfigDeeplink = ({node}) => <>
    Die Einstellung kann über folgenden Link direkt im Admin-Interface geöffnet werden:{" "}
    <code>{`https://<shop-domain>/admin/config/${node}`}</code>{" "}
    (<a href="/konfiguration/konfigurations-deeplinks">Deeplink-Übersicht</a>)
  </>;

Der Knoten `messages` dient zur Konfiguration benutzerdefinierter E-Mail-Benachrichtigungen, die automatisch ausgelöst werden, sobald im Shop bestimmte Ereignisse oder Zustände eintreten.

Neben den standardmäßig versendeten System-E-Mails (z. B. Bestellbestätigung, Versandinformation oder Lagerbestandswarnung) können hier individuelle E-Mails definiert werden, die gezielt an bestimmte Empfängergruppen gesendet werden – etwa an Shop-Verantwortliche, Lieferanten oder Hersteller.

**Wichtig:** Nicht die E-Mail selbst wird im Template integriert, sondern der Trigger für ihren Versand.

Im Template wird per Template-Engine die Bedingung geprüft (z. B. „keine Suchergebnisse gefunden"). Wenn diese erfüllt ist, wird die passende Nachricht über ihre ID (z. B. `order_confirmation`) zum Versand angestoßen.

Diese Funktion ermöglicht es, auch shopindividuelle Ereignisse abzubilden, die für den Betrieb oder die Logistik eines bestimmten Shops relevant sind.

Neue E-Mails können aktuell nur über die [REST API Konfiguration](/schnittstellen/admin-interface-api/api-referenz-konfiguration) erstellt werden.

***

## `messages*` - Grundstruktur

Nachfolgend der Grundaufbau des Knotens `messages`

```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{
  "messages": {
    "emails": {...}
  }
}
```

#### Parameterbeschreibung

| **Parameter** | **Beschreibung**                          |
| ------------- | ----------------------------------------- |
| `emails`      | Konfiguriert System-E-Mails für den Shop. |

***

## `messages.emails` - Ereignisgesteuerte E-Mails

Konfiguriert System-E-Mails für den Shop. Jede Konfiguration ist über eine eindeutige ID adressierbar und das Template kann je Subshop unterschiedlich gepflegt werden.

<KonfigDeeplink node="messages.emails" />

#### Beispielkonfiguration `messages.emails.additionalMail`

```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{
  "id": "order_confirmation",
  "sender": "shop@example.com",
  "subject": "Bestellbestätigung",
  "recipient": "customer@example.com",
  "template": "order_confirmation.htm"
}
```

#### Parameterübersicht

| **Parameter** | **Typ**  | **Beschreibung**                                                                                                                                                                 |
| ------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`          | `string` | Eindeutige Kennung der E-Mail-Konfiguration (z.B. `order_confirmation`).<br />Frei wählbar. <br />Die ID wird vom Template verwendet, um die zugehörige Konfiguration zu finden. |
| `recipient`   | `string` | Empfängeradresse der E-Mail.                                                                                                                                                     |
| `sender`      | `string` | Absenderadresse der E-Mail.                                                                                                                                                      |
| `subject`     | `string` | Betreffzeile der E-Mail.                                                                                                                                                         |
| `template`    | `string` | Pfad / Name der zu verwendenden E-Mail-Vorlage. (z.B. `order_confirmation.htm`)                                                                                                  |