OpenAI, Anthropic, Gemini, Mistral
Select the provider and enter the API key. For OpenAI-compatible services you can set a custom base URL.
AI Newsletter manual.
This manual shows step by step how to build HTML newsletters, connect an AI provider, select recipients and automate sending.
Installation
Up and running in minutes.
Installation and activation run entirely through the Shopware backend - no code changes required.
1 · Requirements
Requires Shopware 6.7 and PHP 8.2 or newer. As always, back up the database before larger changes.
2 · Upload the plugin
Upload the ZIP provided by Stone & Water under Extensions › My extensions › Upload plugin.
3 · Activate
Activate the plugin in the list, then run bin/console cache:clear or clear the cache in the backend.
4 · Open
You will then find the AI Newsletter in the backend in a dedicated menu item (under Marketing or Extensions › Stone & Water).
Connect AI
Provider, key and model.
The newsletter uses your own AI account. Provider, API key and model are stored in the admin - so you keep cost and data flow in your hands.
Freely selectable
Store the model you want - depending on provider and budget.
Verify instantly
One click on “Test connection” checks whether key and model work.
Create a newsletter
Build the content.
The newsletter is composed as HTML - with AI writing support and products straight from the catalog.
Subject & content
Set the subject and HTML content. On request, AI suggests subject lines and copy.
Products & categories
Insert individual products or whole categories - image, name and price come from Shopware.
Personalisation
Placeholders for salutation, first and last name are replaced per recipient.
Test send & preview
Before the real send, send a test mail to yourself and check the web view.
Select recipients
Narrow the audience.
Instead of sending to everyone, you target - and the recipient count is calculated live before you send.
Customers or subscribers
Choose registered customers or the Shopware newsletter subscribers as the base.
Group, country, behaviour
Narrow by sales channel, customer group, country, registration period, ordering behaviour and minimum order value.
Before sending
The exact recipient count is shown before the newsletter goes out.
Sending & automation
Immediate or scheduled.
Sending is rate-limited and runs in batches - gentle on mail servers and deliverability.
Send now
Trigger the newsletter directly from the backend.
Scheduled via cron
A scheduled task (minimum five-minute interval) and a console command send on a timer in the background - ideal for a cron job.
Tracking
Opens (tracking pixel) and clicks (per link) are recorded and evaluated.
Unsubscribe
Every mail carries an unsubscribe link and a List-Unsubscribe header - compliant and one click away.
FAQ
Frequently asked questions.
Answered briefly - for anything else, just get in touch.
Do I need a third-party tool like Mailchimp?
No. The entire send runs inside Shopware on your own data.
Do I need my own AI account?
For the AI writing feature, yes - you store your own API key. Without an AI key you can still write copy yourself.
Is customer data sent to third parties?
Not for sending. Only if you use the AI writing feature do the prompts you enter go to your chosen AI provider.