AI Search for Magento and Adobe Commerce

Overview

Magento's own search matches the words a shopper types against the words in your product names and attributes. A shopper who types "something warm for cold mornings" gets nothing, because no product is called that.

The AI Search Bar answers what they mean. It reads your catalogue and your pages, and it shows matching products with their picture, their price and whether they are in stock.

It works on Magento Open Source and Adobe Commerce, 2.4 and later, with Luma, Hyvä and most other themes.

What You Install

One extension, Asyntai_Search. It does two things:

• It puts the bar on your storefront, in place of the search box your theme already shows.
• It shares your catalogue with us through a read-only integration on your own store.

Install it with Composer:

composer require asyntai/magento-ai-search
bin/magento module:enable Asyntai_Search
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush

Or install it from the Adobe Commerce Marketplace, or unpack the zip into app/code/Asyntai/Search and run the same four bin/magento commands.

Connecting Your Store

1. In your admin, open Asyntai AI Search in the left menu.
2. Press Connect to Asyntai. A window opens where you sign in or create a free account.
3. Finish there. The settings screen notices by itself and reloads.
4. Wait a few minutes while we read your catalogue. The screen tells you how many products we have, and the bar switches on by itself.

There is no key to copy. Your server has to be able to make outgoing HTTPS requests, because the extension talks to us directly. Most hosts allow this.

How the Catalogue Reaches Us

When you press Connect, the extension creates a Magento integration named Asyntai AI Search under System, Extensions, Integrations. It is granted read access to products, stock and CMS pages, and nothing else. There is no access to orders, customers or settings.

Its access token is handed to us once, server to server, during the connect handshake. It never passes through your browser. You can see the integration in your admin at any time, and pressing Disconnect deletes it, which revokes the token.

Reading your own numbers is what lets the bar show the price your store charges and whether an item is in stock, instead of a number copied off a page.

The one setting Magento needs

Since Magento 2.4.4, an integration token is refused until the store allows it. If the settings screen tells you the catalogue is not shared, switch on Stores, Configuration, Services, OAuth, Consumer Settings, Allow OAuth Access Tokens to be used as standalone Bearer tokens, then press Connect again. The extension reports this; it never changes the setting for you, because it is your store's security setting.

The bar still searches your pages either way. The setting only decides whether it also carries live prices and stock.

Where the Bar Appears

There is one setting, Where the bar goes, with two answers.

In place of the search box in my theme

The bar finds the search box your theme already shows, hides it, and takes the same place. Nothing in your theme has to be edited. Luma and Hyvä are handled for you. If you use another theme and the bar lands in the wrong place, put a CSS selector for the right element in Search box to replace.

Pressing Enter without picking a result still opens your usual Magento search results page.

Only where I place it myself

Add an empty element to a CMS block, a page or your theme where the bar should appear:

<div data-asyntai-search></div>

Your theme styles the space around it, so the bar sits in the layout like anything else you put there.

The Other Settings

• Accent colour. Leave it empty to use the colour set in your Asyntai dashboard.
• Placeholder text. Leave it empty and each shopper sees it in their own language.

Trying It Before Your Shoppers Do

The settings screen has a Try your search bar link. It opens your real search bar, on your real catalogue, in a new tab. Searches you run there do not count against your monthly allowance.

Plans and Limits

A store connected through this extension runs the bar on any plan, including the free one. Your monthly reply allowance still applies, and searches and chat replies share it.

When the allowance runs out, the bar removes itself and your theme's own search box comes straight back. Your shoppers keep being able to search. They are never left typing into a box that answers nothing.

The extension checks this through Magento cron, so the bar comes back by itself when your allowance resets. You do not have to update or reinstall anything.

Caching and Content Security Policy

The extension works with full page cache and with Varnish. Whenever the bar switches on or off, or you save its settings, the cached pages are refreshed for you.

It ships a CSP whitelist for asyntai.com and widget.asyntai.com, so a store that enforces its content security policy needs no extra configuration.

Keeping Your Catalogue Current

We re-read your whole catalogue every day. New products, price changes and sold-out items reach the search bar within a day.

Our chat assistant goes further. Before it answers about a product, it reads that product's price and stock from your store again, in the moment. If you run the chatbot as well, its answers carry today's numbers.

If Something Does Not Work

• No bar appears. Open the settings screen and read the line beside the coloured dot. It says exactly why the bar is off. Press Check again to ask us now.
• We could not reach Asyntai. Your server cannot make outgoing HTTPS requests. Ask your host to allow them.
• The catalogue is not shared. Switch on the Bearer token setting described above, then press Connect again.
• We could not read your catalogue. Your store has to be reachable from the internet. A store behind a password or a firewall cannot be read.
• The bar replaced the wrong element. Put a CSS selector for the right one in Search box to replace.
• Menu entry missing after install. Run bin/magento setup:upgrade and bin/magento cache:flush, then sign in to the admin again.

Disconnecting

Press Disconnect on the settings screen. The bar stops at once, the integration and its token are deleted, and your usual Magento search takes over. Disabling the module with bin/magento module:disable Asyntai_Search removes the bar as well.

Using the Chatbot as Well

This extension adds the search bar only. To add the chat assistant too, install our separate Magento chatbot extension. The two work side by side on the same pages and share the same knowledge base.