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 erstellt werden.

Inhaltsverzeichnis

1 1. messages* - Grundstruktur
2 2. messages.emails - Ereignisgesteuerte E-Mails

1. `messages*` - Grundstruktur

Nachfolgend der Grundaufbau des Knotens messages:

{
  "messages": {
    "emails": {...}
  }
}

Parameterbeschreibung:

Parameter	Beschreibung

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

2. `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.

Beispielkonfiguration `messages.emails.additionalMail`

{
  "id": "order_confirmation",
  "sender": "shop@example.com",
  "subject": "Bestellbestätigung",
  "recipient": "customer@example.com",
  "template": "order_confirmation.htm"
}

Parameterübersicht

Parameter	Typ	Beschreibung

Parameter	Typ	Beschreibung
`id`	`string`	Eindeutige Kennung der E-Mail-Konfiguration (z.B. `order_confirmation`). Frei wählbar. 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`)

messages - Ereignisgesteuerte E-Mails

Inhaltsverzeichnis

1. messages* - Grundstruktur

2. messages.emails - Ereignisgesteuerte E-Mails

Beispielkonfiguration messages.emails.additionalMail

Parameterübersicht

1. `messages*` - Grundstruktur

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

Beispielkonfiguration `messages.emails.additionalMail`