This manual shows step by step how to build HTML newsletters, connect an AI provider, select recipients and automate sending.
Shopware 6.7, an API key with one of the supported AI providers, working mail delivery and an active worker for scheduled sending.
Upload the plugin in the admin, install and activate it, then open the configuration.
The plugin is part of the Stone & Water plugin suite and needs a valid licence token.
The configuration holds the sender name and address plus the links that belong in every newsletter.
OpenAI, Anthropic, Mistral and Google are supported. For each provider you store an API key and pick a model. A custom base URL can be set for alternative endpoints.
The system instruction permanently defines how the AI should write - tone, form of address, editorial guard rails. Two further values shape the behaviour:
Subject line and body can be generated by the AI. Products and categories can be included so the newsletter refers to your actual range.
The plugin draws on two sources: Shopware's newsletter subscribers and the shop's customers. Both can be combined and filtered.
The recipient count is calculated before sending, so you can see how large the list really is.
optIn or direct are used. Unconfirmed or unsubscribed addresses are excluded regardless of the filters you set.A newsletter moves through several states: draft, scheduled, sending, sent. Failed recipients are counted separately so a single failure does not stop the whole send.
At the start the recipient list is fixed: all recipients are stored in batches as open entries and then worked through. A send can therefore be interrupted and continued later.
The mails per minute setting limits the pace. The plugin counts what has been sent in the current window and waits before continuing.
The scheduled task staw_newsletter_direct.send works through ongoing sends on its own, at a five minute interval. Without an active worker it does not run.
Without an ID, all ongoing sends are processed. The --chunk option controls how many recipients are handled per batch. For large lists the console is the more robust route because no HTTP timeout gets in the way.
The plugin records how often a newsletter was opened and which links were clicked, plus unsubscribes. Opens are measured with a small image, clicks through redirected links.
Every newsletter has its own address where it can be opened in a browser - for recipients whose mail client does not render it properly.
Usually there is no active worker. Alternatively use the console command.
Only subscribers with confirmed consent are included. Also check the filters for customer group, period and minimum order value.
That is normally the configured per-minute limit - and it is intentional.
Check the API key, the model and, if used, the base URL. Provider errors are reported back.
Normal when recipients block images. Click figures are the better yardstick then.
We are happy to help with lists, deliverability or setup. Get in touch via the contact page or write to info@stoneandwater.online.
Two routes, the same feature set - pick whichever suits your setup.
All prices net, plus VAT.
You buy the licence directly from us and get an invoice from us. Install by upload in the admin without SSH, updates through our licensing platform, support straight from the developer.
The plugin will be listed in the official Shopware Community Store. Installation and automatic updates then run through the plugin manager, billing through your Shopware account. We will link it here as soon as it is live.
Every feature and all prices are on the product page. We are happy to help with setup and integration.