KI Newsletter Handbuch.

Dieses Handbuch zeigt Schritt für Schritt, wie du HTML-Newsletter aufbaust, einen KI-Anbieter anbindest, Empfänger auswählst und den Versand automatisierst.

Systemvoraussetzungen

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.

Versand per Konsole

bin/console staw:newsletter:send bin/console staw:newsletter:send <newsletter-id> --chunk=200

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.

Ü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 €
Halbjährlich49,99 €17 % günstiger
Bester PreisJährlich89,99 €25 % günstiger

Alle Preise netto zzgl. USt.

Du kaufst die Lizenz direkt bei uns und bekommst eine Rechnung von uns. Installation per Upload im Admin ohne SSH, Updates über unsere Lizenzplattform, Support direkt vom Entwickler.

Direkt anfragen +49 2555 9997342

Shopware Store

In Vorbereitung

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.