Skip to main content

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.

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
ParameterBeschreibung
emailsKonfiguriert 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": "shop@example.com",
  "subject": "Bestellbestätigung",
  "recipient": "customer@example.com",
  "template": "order_confirmation.htm"
}

Parameterübersicht

ParameterTypBeschreibung
idstringEindeutige 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.
recipientstringEmpfängeradresse der E-Mail.
senderstringAbsenderadresse der E-Mail.
subjectstringBetreffzeile der E-Mail.
templatestringPfad / Name der zu verwendenden E-Mail-Vorlage. (z.B. order_confirmation.htm)