Dieses Handbuch zeigt Schritt für Schritt, wie du HTML-Newsletter aufbaust, einen KI-Anbieter anbindest, Empfänger auswählst und den Versand automatisierst.
Shopware 6.7, ein API-Key bei einem der unterstützten KI-Anbieter, ein funktionierender Mailversand und ein aktiver Worker für den zeitgesteuerten Versand.
Installation
Plugin im Admin hochladen, installieren und aktivieren, danach die Konfiguration öffnen.
Lizenz aktivieren
Das Plugin gehört zur Stone & Water Plugin-Suite und benötigt einen gültigen Lizenz-Token.
Absender und Pflichtlinks
In der Konfiguration werden Absendername und Absenderadresse hinterlegt, dazu die Links, die in jeden Newsletter gehören.
Absendername und -adresse
Voreinstellung für neue Newsletter.
Abmeldelink
Standard-URL für die Abmeldung.
Impressum, Datenschutz, AGB
Werden im Newsletter verlinkt.
Rechtlich relevant: Werbliche E-Mails brauchen ein Impressum und eine jederzeit erreichbare Abmeldemöglichkeit. Trage diese Links ein, bevor du den ersten Versand startest.
KI-Anbieter und Modell
Unterstützt werden OpenAI, Anthropic, Mistral und Google. Je Anbieter hinterlegst du einen API-Key und wählst ein Modell. Für abweichende Endpunkte lässt sich zusätzlich eine eigene Basis-URL setzen.
Systemanweisung und Feinsteuerung
Über die Systemanweisung legst du dauerhaft fest, wie die KI schreiben soll - Tonalität, Ansprache, inhaltliche Leitplanken. Zwei weitere Werte steuern das Verhalten:
Temperatur
Niedrige Werte liefern gleichmäßigere, vorhersehbarere Texte, höhere mehr Variation.
Maximale Ausgabelänge
Begrenzt die Länge der erzeugten Texte.
Inhalte erzeugen lassen
Betreff und Inhalt lassen sich von der KI erzeugen. Produkte und Kategorien können dabei einbezogen werden, sodass der Newsletter auf dein tatsächliches Sortiment Bezug nimmt.
Vor dem Versand lesen: Erzeugte Texte sind ein Entwurf, kein fertiger Newsletter. Preise, Verfügbarkeiten und Aussagen zu Produkten solltest du prüfen, bevor der Versand startet - eine E-Mail lässt sich nicht zurückholen.
Woher die Empfänger kommen
Das Plugin bedient sich aus zwei Quellen: den Newsletter-Abonnenten von Shopware und den Kunden des Shops. Beide lassen sich kombinieren und filtern.
Filter nach Kundengruppe und Bestellungen
Kundengruppen
Auswahl einer oder mehrerer Gruppen.
Bestellzeitraum
Kunden, die zwischen zwei Daten bestellt haben.
Mindestbestellwert
Grenzt auf Kunden ab einem bestimmten Umsatz ein.
Vor dem Versand wird die Empfängerzahl ermittelt, sodass du siehst, wie groß der Verteiler tatsächlich ist.
Nur eingewilligte Abonnenten
Fest eingebaut: Aus den Newsletter-Abonnenten werden ausschließlich Einträge mit dem Status optIn oder direct berücksichtigt. Nicht bestätigte oder abgemeldete Adressen bleiben außen vor - unabhängig von den gewählten Filtern.
Der Weg vom Entwurf zum Versand
Ein Newsletter durchläuft mehrere Zustände: Entwurf, geplant, im Versand, versendet. Fehlgeschlagene Empfänger werden getrennt gezählt, sodass ein einzelner Fehler nicht den gesamten Versand stoppt.
Beim Start wird der Verteiler festgeschrieben: Alle Empfänger werden in Paketen als offene Einträge gespeichert und danach abgearbeitet. Ein Versand ist damit unterbrechbar und kann später fortgesetzt werden.
Versandtempo und Chargen
Über die Einstellung „Mails pro Minute" begrenzt du das Tempo. Das Plugin zählt die im laufenden Zeitfenster verschickten Mails und wartet, bevor es weitermacht.
Warum das wichtig ist: Mailserver und Provider drosseln oder blockieren Absender, die plötzlich große Mengen verschicken. Ein moderates Tempo schützt deine Zustellbarkeit mehr, als ein schneller Versand nützt. Frage im Zweifel bei deinem Mailprovider nach dem erlaubten Durchsatz.
Automatischer Versand
Der Scheduled Task staw_newsletter_direct.send arbeitet laufende Versände selbstständig ab, in einem Intervall von fünf Minuten. Ohne aktiven Worker läuft er nicht.
Ohne Angabe einer ID werden alle laufenden Versände abgearbeitet. Über --chunk steuerst du, wie viele Empfänger pro Charge verarbeitet werden. Für große Verteiler ist die Konsole der robustere Weg, weil kein HTTP-Timeout dazwischenkommt.
Öffnungen, Klicks und Abmeldungen
Das Plugin erfasst, wie oft ein Newsletter geöffnet und welche Links geklickt wurden, dazu die Abmeldungen. Die Öffnungsmessung läuft über eine kleine Bilddatei, die Klickmessung über umgeleitete Links.
Zur Aussagekraft: Öffnungsraten sind systembedingt ungenau, weil viele Mailprogramme Bilder blockieren oder vorab laden. Klicks sind das belastbarere Signal.
Im Browser ansehen
Jeder Newsletter hat eine eigene Adresse, unter der er sich im Browser öffnen lässt - für Empfänger, deren Mailprogramm die Darstellung nicht sauber hinbekommt.
Problemlösung
Der Versand startet nicht
Meist fehlt der aktive Worker. Alternativ den Konsolenbefehl nutzen.
Es werden weniger Empfänger erreicht als erwartet
Berücksichtigt werden nur Abonnenten mit bestätigter Einwilligung. Prüfe außerdem die gesetzten Filter für Kundengruppe, Zeitraum und Mindestbestellwert.
Der Versand ist sehr langsam
Das ist in der Regel die eingestellte Begrenzung pro Minute - und die ist gewollt.
Die KI liefert keinen Text
Prüfe API-Key, Modell und gegebenenfalls die Basis-URL. Fehler des Anbieters werden zurückgemeldet.
Öffnungen werden kaum gezählt
Normal, wenn Empfänger Bilder blockieren. Die Klickzahlen sind dann der bessere Maßstab.
Support
Bei Fragen zu Verteilern, Zustellbarkeit oder zur Einrichtung helfen wir gern. Schreib uns über die Kontaktseite oder an info@stoneandwater.online.
Alle Einstellungen
Jede Einstellung des Plugins mit Standardwert und Erklärung, in derselben Reihenfolge wie im Administrationsbereich. Die Texte stammen direkt aus dem Plugin (Version 1.0.87).
Einstellungen
Hinterlegte Rechtstexte (AGB, Datenschutz, Impressum) werden im Newsletter-Footer verlinkt.
Max. E-Mails pro MinuteStandard: 200
Begrenzt die Anzahl pro Versand-Durchlauf (Drosselung, gilt auch für den Cron).
Standard-AbsendernameStandard: leer
Sind Standard-Absender hinterlegt, werden sie bei neuen Newslettern automatisch vorausgefüllt.
Standard-Absender-E-MailStandard: leer
Sind Standard-Absender hinterlegt, werden sie bei neuen Newslettern automatisch vorausgefüllt.
Standard-Weiterleitung nach AbmeldungStandard: leer
Wird verwendet, wenn am Newsletter keine eigene URL hinterlegt ist.
AGB-URLStandard: leer
Wird im Footer jeder Newsletter-Mail verlinkt. Leer bleibt der Link weg.
Datenschutz-URLStandard: leer
Wird im Footer jeder Newsletter-Mail verlinkt. Leer bleibt der Link weg.
Impressum-URLStandard: leer
Wird im Footer jeder Newsletter-Mail verlinkt. Leer bleibt der Link weg.
KI / API-Zugang
AnbieterStandard: OpenAI
Der KI-Dienst, der Newsletter-Texte entwirft.
ModellStandard: je nach Anbieter
Das Modell des gewählten Anbieters.
API-SchlüsselStandard: leer
Zugangsschlüssel des gewählten Anbieters.
Basis-URL (optional)Standard: leer
Nur für eigene/kompatible Endpunkte. Leer lassen für Standard.
Newsletter anlegen
BetreffStandard: leer
Betreffzeile der Newsletter-Mail.
BeschreibungStandard: leer
Kurze Beschreibung des Newsletters für die Übersicht in der Verwaltung.
Absendername dieses Newsletters. Bei neuen Newslettern mit dem Standard-Absendernamen vorausgefüllt.
Absender-E-MailStandard: Standard-Absender-E-Mail
Absenderadresse dieses Newsletters. Bei neuen Newslettern mit der Standard-Absenderadresse vorausgefüllt.
AusrichtungStandard: Linksbündig
Ausrichtung des Inhalts in der Mail: linksbündig, zentriert oder rechtsbündig.
Weiterleitungs-URL nach AbmeldungStandard: leer
Wohin Empfänger nach der Abmeldung weitergeleitet werden. Leer greift die Standard-Weiterleitung aus den Einstellungen.
Abmeldelink automatisch anhängenStandard: an
Fügt am Ende jeder Newsletter-Mail automatisch einen Abmeldetext mit Abmeldelink ein. Dann ist kein manueller Platzhalter nötig. Ist im HTML bereits ein Abmeldelink vorhanden, wird nichts doppelt eingefügt.
Empfänger-Selektion
EmpfängerquelleStandard: Kunden
Woher die Empfänger stammen: aus den Kundenkonten oder aus den Newsletter-Abonnenten. Abonnenten zählen nur mit bestätigter oder direkter Anmeldung.
VerkaufskanäleStandard: alle
Begrenzt die Empfänger auf die gewählten Verkaufskanäle. Ohne Auswahl gelten alle.
KundengruppenStandard: alle
Begrenzt die Empfänger auf die gewählten Kundengruppen. Ohne Auswahl gelten alle.
LänderStandard: alle
Begrenzt die Empfänger auf Kunden aus den gewählten Ländern. Ohne Auswahl gelten alle.
StatusStandard: Alle
Nach Kontostatus filtern: alle, nur aktive oder nur inaktive Kundenkonten.
Registriert abStandard: leer
Nur Kunden, die sich ab diesem Tag registriert haben.
Registriert bisStandard: leer
Nur Kunden, die sich bis einschliesslich zu diesem Tag registriert haben.
Nur Newsletter-AbonnentenStandard: aus
Beschränkt Kunden auf die, die zusätzlich als Newsletter-Abonnenten eingetragen sind.
BestellverhaltenStandard: Egal
Egal, nur Kunden mit Bestellung oder nur Kunden ohne Bestellung.
Letzte Bestellung abStandard: leer
Berücksichtigt Bestellungen ab diesem Tag.
Letzte Bestellung bisStandard: leer
Berücksichtigt Bestellungen bis zu diesem Tag.
Mindest-Bestellwert (Euro)Standard: leer
Nur Kunden mit mindestens einer Bestellung ab diesem Gesamtbetrag, im gewählten Bestellzeitraum. Es zählt die einzelne Bestellung, nicht der Umsatz über alle Bestellungen.
Über den Store oder direkt bei uns.
Zwei Wege, derselbe Funktionsumfang - such dir aus, was besser zu deinem Setup passt.
Direkt über Stone & Water
Ab sofort möglich
Monatlich9,99 €
Bester PreisJährlich101,90 €15 % günstiger
Alle Preise netto zzgl. USt.
Lade die kostenlose Plugin Suite herunter und spiele sie im Admin ein, ganz ohne SSH. Darüber installierst und aktualisierst du das Plugin mit einem Klick. Die Lizenz kaufst du direkt bei uns, mit Rechnung von uns und Support direkt vom Entwickler.
Das Plugin wird im offiziellen Shopware Community Store gelistet. Installation und automatische Updates laufen dann über den Plugin Manager im Backend, die Abrechnung über deinen Shopware-Account. Sobald verfügbar, verlinken wir es hier.
Newsletter mit KI?
Zurück zum KI Newsletter.
Alle Funktionen und Preise findest du auf der Produktseite. Bei Einrichtung und Anbindung helfen wir gern.