README

Turn your Magento storefront into a conversion machine. IDEA89 adds an AI-powered shopping assistant that answers product questions, recommends what to buy, and surfaces promotions — in your brand voice.

5-minute install. No theme changes. No dev work.

What it does

Feature	Description
Smart product recommendations	AI understands natural language queries like "something waterproof under 100 pounds" and finds the right products from your catalogue
Real-time catalogue sync	Products, variants, prices, stock levels, and reviews are synced automatically. Out-of-stock items are never recommended
Brand voice	Configure your assistant's name, tone, and store context. It answers like a member of your team
Promotion awareness	Active cart price rules are synced so the assistant can surface relevant discounts
Built-in analytics	Track conversations, conversion rates, and top queries from the merchant dashboard
GDPR-ready	EU-hosted, no customer data used for AI training, PII redaction before model calls

How it works

Install the module via Composer
Enter your API key from the IDEA89 dashboard
The widget appears on your storefront immediately
Products sync automatically — the assistant is ready to sell

Your catalogue is indexed with AI embeddings for semantic search. When a shopper asks a question, the assistant searches your products, checks stock, and responds with relevant recommendations — complete with product cards, prices, and add-to-cart buttons.

Requirements

Magento 2.4.6 or later (Open Source or Commerce)
PHP 8.2 or 8.3
An IDEA89 account — start your free trial

Installation

composer require idea89/magento2-assistant
bin/magento module:enable Idea89_Assistant
bin/magento setup:upgrade
bin/magento cache:flush

That's it. No layout XML changes, no theme overrides, no frontend build step.

Configuration

Navigate to Stores > Configuration > IDEA89 > AI Shopping Assistant in Magento Admin.

General

Setting	Description
Enable Widget	Turn the chat widget on/off
API Key	Your API key from the IDEA89 dashboard (stored encrypted)
Assistant Name	Name shown in the widget header (e.g. "Aria", "Shop Helper")
Store Context	Describe what your store sells so the AI can answer general questions
Test Connection	Verify your API key works
Sync Now	Manually trigger a full catalogue sync

Widget Appearance

Setting	Description
Position	Bottom-right or bottom-left
Brand Colour	Hex code for the widget header (e.g. `#2563eb`)

Content Sync

Choose what gets synced to IDEA89:

Products — names, descriptions, prices, images, attributes, variants, stock, reviews
Categories — so the assistant knows your catalogue structure
CMS Pages — About Us, FAQs, policies — the assistant can answer "what's your return policy?"
Store Info — store name and context description

Advanced

Setting	Description
API URL	Override for self-hosted or enterprise deployments. Leave blank for default.

How syncing works

Trigger	What happens
Product saved	Changed product is queued and synced within 1 minute
Stock update	Stock changes are synced within 1 minute
Price rule saved	Active promotions are synced immediately
Nightly cron	Full catalogue re-sync as a safety net (configurable)
Manual sync	Click "Sync Now" in admin to push everything immediately

All syncs are idempotent — sending the same product twice is safe and expected.

The widget

The assistant appears as a floating chat widget on your storefront. It includes:

Conversational AI that understands your products
Product cards with images, prices, ratings, and add-to-cart buttons
Promotional banners for active cart price rules
Quick-reply chips for common questions
Mobile-responsive design
Dark/light theme support
No impact on your Magento theme or page speed (loaded asynchronously)

The widget is served from the IDEA89 CDN — no static content is added to your Magento deployment.

Pricing

Plan	Price	Conversations/mo
Free trial	£0 for 14 days	100 conversations
Starter	£49/mo	1,000
Growth	£149/mo	10,000
Pro	£349/mo	50,000

Save 10% with annual billing. All plans include the full feature set.

Start your free trial — no credit card required.

Uninstalling

bin/magento module:disable Idea89_Assistant
bin/magento setup:upgrade
composer remove idea89/magento2-assistant
bin/magento cache:flush

No database tables are created in your Magento instance. All data is stored on the IDEA89 platform.

Support

Documentation: idea89.com
Email: support@idea89.com
Dashboard: app.idea89.com

License

This module is licensed under the Open Software License 3.0 (OSL-3.0).

Built by 4K Technologies in the UK.

idea89 / magento2-assistant

Maintainers

Package info

Statistics

Security