messages - Ereignisgesteuerte E-Mails

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.

---

messages* - Grundstruktur

Nachfolgend der Grundaufbau des Knotens messages

{
  "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.

Beispielkonfiguration messages.emails.additionalMail

{
  "id": "order_confirmation",
  "sender": "[e-mail]",
  "subject": "Bestellbestätigung",
  "recipient": "[e-mail]",
  "template": "order_confirmation.htm"
}

Parameterübersicht

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)