PHPackages idea89/magento2-assistant - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. idea89/magento2-assistant ActiveMagento2-module[Utility & Helpers](/categories/utility) idea89/magento2-assistant ========================= AI shopping assistant for Magento 2 — answers product questions, recommends what to buy, surfaces promotions. 5-minute install. 1.1.3(1w ago)012↑1150%OSL-3.0PHPPHP ~8.1.0||~8.2.0||~8.3.0||~8.4.0||~8.5.0CI passing Since May 23Pushed 1w agoCompare [ Source](https://github.com/idea89hq/magento-module)[ Packagist](https://packagist.org/packages/idea89/magento2-assistant)[ Docs](https://idea89.com)[ RSS](/packages/idea89-magento2-assistant/feed)WikiDiscussions master Synced 1w ago READMEChangelog (4)Dependencies (6)Versions (6)Used By (0) IDEA89 — AI Shopping Assistant for Magento 2 ============================================ [](#idea89--ai-shopping-assistant-for-magento-2) 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.** [![Packagist Version](https://camo.githubusercontent.com/d5ba1cdb3a04292796903bc022376d278e47436ea377ea9f35a6bb94c39302e4/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6964656138392f6d6167656e746f322d617373697374616e74)](https://packagist.org/packages/idea89/magento2-assistant)[![Packagist Downloads](https://camo.githubusercontent.com/a03ed58cc7d861345e3602d84c4b6903eac45a4b2b8ce943e0e339bec1a812b6/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6964656138392f6d6167656e746f322d617373697374616e74)](https://packagist.org/packages/idea89/magento2-assistant)[![Magento 2](https://camo.githubusercontent.com/bc0d28e839a5710418ba5b18cf519a2523a9be4515402e1467ca2a7e588b89b7/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4d6167656e746f2d322e342e362b2d6f72616e6765)](https://magento.com)[![PHP](https://camo.githubusercontent.com/c1d0c01c7e7509eda446d0ed0a92ba08a6e6b5e6d631c94707e30d1c8313d714/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e31254532253830253933382e352d626c7565)](https://php.net)[![License](https://camo.githubusercontent.com/4d1146bec36601d996d15973752a44327ec2e9408582aeb5b0efe6a0faec3fab/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4f534c2d2d332e302d677265656e)](LICENSE) [![Coding Standard](https://github.com/idea89hq/magento-module/actions/workflows/coding-standard.yml/badge.svg)](https://github.com/idea89hq/magento-module/actions/workflows/coding-standard.yml)[![CodeQL](https://github.com/idea89hq/magento-module/actions/workflows/codeql.yml/badge.svg)](https://github.com/idea89hq/magento-module/actions/workflows/codeql.yml)[![Security Policy](https://camo.githubusercontent.com/73544cdec0138d77cdc3b9dcfe15fc4c48160021911c07a8095abcc7ab4a22e3/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f73656375726974792d706f6c6963792d626c7565)](SECURITY.md) --- What it does ------------ [](#what-it-does) FeatureDescription**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**In-chat order tracking** *(new in v1.1.1)*When a shopper asks "where is my order?" the assistant surfaces a compact order card right in the chat with status, items, and a carrier tracking link. Logged-in customers see their last 3 orders; guests verify with order number + email**Store Locator** *(new in v1.1.0)*Physical showroom finder with map, postcode search, hours, photos, and directions — in chat and on a dedicated `/store-finder` page (URL configurable)**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 callsHow it works ------------ [](#how-it-works) 1. Install the module via Composer 2. Enter your API key from the [IDEA89 dashboard](https://app.idea89.com) 3. The widget appears on your storefront immediately 4. 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 ------------ [](#requirements) - Magento 2.4.6 or later (Open Source, Adobe Commerce, or Adobe Commerce Cloud) - PHP 8.1, 8.2, 8.3, 8.4, or 8.5 — practically, whichever your Magento install supports: MagentoPHP range2.4.68.1, 8.22.4.78.1, 8.2, 8.32.4.88.2, 8.3, 8.42.4.98.4, 8.5 (8.3 upgrade-only) - An IDEA89 account — [start your free trial](https://app.idea89.com/sign-up) Installation ------------ [](#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 ------------- [](#configuration) Navigate to **Stores > Configuration > IDEA89 > AI Shopping Assistant** in Magento Admin. ### General [](#general) SettingDescription**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 [](#widget-appearance) SettingDescription**Position**Bottom-right or bottom-left**Brand Colour**Hex code for the widget header (e.g. `#2563eb`)### Content Sync [](#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 ### Store Locator *(Pro plan and above)* [](#store-locator-pro-plan-and-above) Settings live under **Stores → Configuration → IDEA89 → Store Locator**. Twelve fields covering page behaviour and content: SettingDefaultNotes**Enable Store Finder Page**YesMaster toggle for the locator page and CMS widget**URL Path**`store-finder`Pick any slug — `showrooms`, `branches`, `find-a-shop`. Save fails with a clear error if it collides with an existing CMS page, product, category, or module**Page Layout**Use dashboard settingFullwidth (edge-to-edge map) or Boxed (max-width card)**SEO Page Title** + **Meta Description**(sensible defaults)Standard SEO control over the page head**Hero Eyebrow / Title / Subhead**(sensible defaults)Override the in-page copy without theme edits**Help Section Heading / Body / CTA Label / CTA URL**"Contact us" → `/contact`The help section below the mapThe page also lives as a CMS widget — drop **IDEA89 Store Locator** into any CMS page or static block from the widget picker. Locations themselves are managed in the [IDEA89 dashboard](https://app.idea89.com) → Locator. The chat assistant uses them automatically when a shopper asks "where is your nearest store?" ### Order Tracking *(every plan)* [](#order-tracking-every-plan) Settings live under **Stores → Configuration → IDEA89 → Order Tracking**. Five fields: SettingDefaultNotes**Enable Order Tracking**YesMaster toggle. When **No**, the chat assistant won't surface an order card, and the order endpoints respond with `feature_disabled`**Contact Support URL**`/contact`Where the "Contact support" button on the order card sends shoppers — relative path, absolute URL, or `mailto:`**Contact Support Button Label**"Contact support"Match your tone — "Talk to us", "Email the team"**Max Recent Orders Shown**3How many recent orders to show a logged-in customer (1–10)**Show Carrier Tracking Button**YesWhen **Yes**, surfaces a "Track parcel" button when a carrier tracking link is availableAll fields support per-store-view scope. Online-only retailer? Set **Enable Order Tracking = No** on that store-view and the card never surfaces. See **[docs/order-tracking-guide.md](docs/order-tracking-guide.md)** for the full guide — privacy model, supported carriers, troubleshooting, and the order-card JSON shape. ### Advanced [](#advanced) SettingDescription**API URL**Override for self-hosted or enterprise deployments. Leave blank for default.How syncing works ----------------- [](#how-syncing-works) TriggerWhat 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 immediatelyAll syncs are idempotent — sending the same product twice is safe and expected. The widget ---------- [](#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 ------- [](#pricing) PlanPriceConversations/mo**Free trial**£0 for 14 days (all Pro features)100 conversations**Starter**£49/mo1,000**Growth**£149/mo10,000**Pro**£349/mo50,000Save 10% with annual billing. All plans include the full feature set. [Start your free trial](https://app.idea89.com/sign-up) — no credit card required. Uninstalling ------------ [](#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 ------- [](#support) - **Documentation:** [idea89.com](https://idea89.com) - **Email:** - **Dashboard:** [app.idea89.com](https://app.idea89.com) License ------- [](#license) This module is licensed under the [Open Software License 3.0 (OSL-3.0)](https://opensource.org/licenses/OSL-3.0). Copyright 2026 4K Technologies Ltd. --- Built by [4K Technologies](https://4ktechnologies.co.uk) in the UK. ### Health Score 44 — FairBetter than 90% of packages Maintenance98 Actively maintained with recent releases Popularity8 Limited adoption so far Community6 Small or concentrated contributor base Maturity55 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~2 days Total 5 Last Release 10d ago PHP version history (3 changes)1.0.0PHP >=8.2 1.1.2PHP ~8.1.0||~8.2.0||~8.3.0||~8.4.0 1.1.3PHP ~8.1.0||~8.2.0||~8.3.0||~8.4.0||~8.5.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/4c944623152ccbbdac3565fe25cfd52cb495e735974ea3b56e5c9cf54001423b?d=identicon)[idea89hq](/maintainers/idea89hq) --- Top Contributors [![idea89hq](https://avatars.githubusercontent.com/u/287297456?v=4)](https://github.com/idea89hq "idea89hq (10 commits)") --- Tags aiconversionecommercechatbotmagento2product recommendationsshopping-assistantidea89 ### Embed Badge ![Health badge](/badges/idea89-magento2-assistant/health.svg) ``` [![Health](https://phpackages.com/badges/idea89-magento2-assistant/health.svg)](https://phpackages.com/packages/idea89-magento2-assistant) ``` ### Alternatives [run-as-root/magento2-prometheus-exporter Magento2 Prometheus Exporter 68353.9k](/packages/run-as-root-magento2-prometheus-exporter)[mollie/magento2 Mollie Payment Module for Magento 2 1131.8M12](/packages/mollie-magento2)[loki/magento2-components Core module for defining Alpine.js components with advanced AJAX features 1010.0k22](/packages/loki-magento2-components)[customgento/module-cookiebot-m2 This Magento 2 module integrates Cookiebot into your store. 2468.3k](/packages/customgento-module-cookiebot-m2)[mage-os/module-inventory-reservations-grid Add a grid with the list of inventory reservations. 1512.6k](/packages/mage-os-module-inventory-reservations-grid)[opengento/module-category-import-export This module add the capability to import and export the categories from the back-office. 1310.2k1](/packages/opengento-module-category-import-export) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)