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.
Every setting of the plugin with its default value and explanation, in the same order as in the administration. The texts come straight from the plugin (version 1.0.87).
Configured legal pages (terms, privacy, imprint) are linked in the newsletter footer.
Limits the number per send run (throttle, also applies to cron).
If default sender values are set, they pre-fill new newsletters automatically.
If default sender values are set, they pre-fill new newsletters automatically.
Used when a newsletter has no own URL set.
Linked in the footer of every newsletter mail. Left empty, the link is omitted.
Linked in the footer of every newsletter mail. Left empty, the link is omitted.
Linked in the footer of every newsletter mail. Left empty, the link is omitted.
The AI service that drafts newsletter texts.
The model of the chosen provider.
Access key of the chosen provider.
Only for custom/compatible endpoints. Leave empty for default.
Subject line of the newsletter mail.
Short description of the newsletter for the overview in the administration.
Sender name of this newsletter. Prefilled with the default sender name for new newsletters.
Sender address of this newsletter. Prefilled with the default sender address for new newsletters.
Alignment of the content in the mail: left, centred or right.
Where recipients are sent after unsubscribing. Left empty, the default redirect from the settings applies.
Automatically adds an unsubscribe text with link at the end of every newsletter email, so no manual placeholder is needed. If the HTML already contains an unsubscribe link, nothing is added twice.
Where recipients come from: customer accounts or newsletter subscribers. Subscribers only count with a confirmed or direct sign-up.
Limits recipients to the selected sales channels. Without a selection all apply.
Limits recipients to the selected customer groups. Without a selection all apply.
Limits recipients to customers from the selected countries. Without a selection all apply.
Filter by account status: all, active only or inactive only.
Only customers who registered on or after this day.
Only customers who registered up to and including this day.
Restricts customers to those who are also registered as newsletter subscribers.
Any, only customers with an order, or only customers without an order.
Considers orders from this day on.
Considers orders up to this day.
Only customers with at least one order of this total or more, within the selected order period. The individual order counts, not the revenue across all orders.
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.