AI Newsletter Marketing Agent manual.

From setup to reporting: build the personas, choose the occasions, set the minimum score, approve messages and let the autopilot earn its autonomy.

System requirements

Shopware 6.7, PHP 8.2 or newer, working mail delivery and your own API key with the AI provider of your choice. Signal capture (basket, viewed products) needs an active storefront.

Privacy: Only anonymised features and aggregate values go to the model. Names, addresses and order histories never leave the shop.

Installation

Upload the ZIP in the admin under Extensions, install and activate it, then enter the licence key from plugins.staw.io. The check needs a domain configured in the sales channel.

Setup in six steps

The assistant walks you through: store the AI access, enable signal capture, build the personas, choose the occasions, define mail template and writing rules, set the minimum score.

The first persona build can take a while with large customer bases and can also be started from the console.

The persona

Ten extractors condense the raw data per customer into a feature set: order rhythm with trend, preferred weekday and time of day, basket size, price band, strongest categories with a 180-day half-life, discount profile, return rate, viewed but not bought, and open basket items.

Everything is derived and recalculable at any time - no second data set anyone has to maintain.

The fifteen occasions

For every customer the agent scores all permitted occasions and picks the highest. Among them: replenishment for consumables, abandoned basket, reactivation, matching add-on after a purchase, repeated interest, birthday, new arrivals in a strong category and unredeemed vouchers.

Some occasions have prerequisites: replenishment and add-ons need product profiles, basket and interest need signal capture, birthday needs a date of birth in the account.

Minimum score

If the best occasion stays below your threshold, nothing is sent to that customer. This is the key dial: it decides how often you write at all.

Recommendation: start high and lower it slowly. A threshold that is too low produces exactly the arbitrariness the plugin is meant to avoid.

Approval and autopilot

Every message first lands as a draft in the approval queue - with reasoning, score, text preview, HTML preview and subject check. From there: accept, reject or send a test mail to any address.

The autopilot only starts once an occasion has collected enough manually approved messages; automatically sent ones do not count. A value of zero switches it off entirely.

Template and writing rules

The template defines the look, the writing rules the tone. Both apply to all occasions, so your brand stays recognisable although the wording is produced per occasion.

The subject check runs without a model call and rates length, promotional trigger words, exclamation marks, percentages, capitals and emojis.

Sendings and campaigns

Besides the occasion-based individual mails there are thematic sendings to groups, vouchers per occasion, recommendations and suggestions for sendings. The automation level decides how much of that runs without asking.

Reporting

The overall report shows opens, clicks, orders and revenue per occasion with a daily curve; attribution is last touch within a configurable window.

The newsletter report gives open and click rate per newsletter, attributed revenue and above all the product source - whether revenue came from due consumables or from filler.

The per-customer diagnosis shows all occasions side by side with score, reasoning and verdict, answering the most common question: why does this customer get no mail.

Sales channels

If you run several channels, the selector in the header limits personas, group counts, metrics and reporting to one channel. Sendings themselves target groups; the group decides the recipients.

Deliverability and SMTP

Sender and SMTP can be configured per sales channel. For good delivery rates SPF, DKIM and DMARC need to be set up correctly - the plugin cannot rescue the best mail if the domain is not authenticated.

Troubleshooting

Nothing is sent: usually the minimum score is too high or prerequisites like product profiles or signal capture are missing. The per-customer diagnosis says so in plain words.
No personas: start the build first. With large data sets run it from the console and wait for it to finish.
Model errors: check the API key and whether the selected model is enabled on your provider account.

Support

Questions come straight to us - support is from the developer. You can also request a feature through the Plugin Suite in the admin.

Availability

Directly from Stone & Water

Available now

Monthly49.99 €
Half-yearly249.99 €17 % cheaper
Best priceYearly449.99 €25 % cheaper

All prices net, plus VAT.

You buy the licence directly from us and receive an invoice from us. Installation by upload in the admin without SSH, updates through our licence platform, support straight from the developer.

Get in touch +49 2555 9997342

Shopware Store

In preparation

The plugin will be listed in the official Shopware Community Store. Installation and automatic updates then run through the plugin manager in the backend, billing through your Shopware account. We will link it here as soon as it is available.