This manual walks you through setting up the AI-powered pre-sales chat, connecting an AI provider and tailoring the advice to your catalog.
Shopware 6.7 and an API key with one of the four supported AI providers: OpenAI, Anthropic (Claude), Mistral or Google Gemini. Automatic log cleanup requires a running worker.
Install it in the admin under Extensions, My Extensions, Upload - or place the plugin folder in custom/plugins/StawKiProductAdvisor and install it from the console:
In the admin under Marketing, AI Product Advisor: activate it, choose the provider and store the API key. Each provider keeps its own key and model, so you can switch providers without losing keys. Every setting can be configured per sales channel.
The product advisor is a pre-sales chat in the storefront. It answers customer questions and recommends matching products. The reply is streamed via server-sent events, so it appears progressively rather than all at once, optionally with a typing effect.
Every query first searches the catalog. The AI may then only recommend from those matches. That rules out invented products which do not exist in the shop - the most common complaint about AI chats in retail.
A fast preliminary call extracts search terms plus price and property constraints such as colour, material or size from the customer question. If that call fails, a local fallback takes over. The timeout is 10 seconds so the chat never hangs. The model used for this extraction can be chosen separately from the answering model.
Recommended products appear directly in the chat as a quickview. For variant articles a configurator is built in: the selection resolves the matching variant, so the cart and product links point at that exact variant rather than the parent article.
Optionally the chat opens by itself after a configurable delay. The button can also pulse to draw attention. Both can be switched off.
For every recommendation the plugin records clicks, cart adds and cart value. That makes it possible to quantify what the advisor actually contributes to revenue rather than only showing conversation counts.
The statistics view in the admin shows the most frequent search terms and the most recommended products. The raw data can be exported as CSV for further processing.
What gets transmitted is the customer message text including the session conversation so far, plus a compact excerpt of matching catalog products, meaning name, number, price and properties. Order, account and payment data are not transmitted.
E-mail addresses and phone numbers are removed automatically before anything goes to the provider. On top of that you can enable a consent gate that requires confirmation before the first message.
With logging enabled the plugin stores anonymised queries without e-mail or phone number. You set the retention period in days and a daily task deletes older entries. The task needs an active worker.
Check whether the advisor is active in that sales channel - settings apply per channel. Then clear the cache.
Usually a valid API key for the chosen provider is missing, or the model is not enabled for that key. Smart search times out after 10 seconds and falls back to local search.
The advisor can only recommend what the catalog search finds. Check product names and properties, and sharpen the persona.
The cleanup task only runs with an active worker.
If you have questions about setup, choosing a provider or data protection, we are happy to help. 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.
See every feature on the product page. We are happy to help with setup and fine-tuning.