AI Search for Bagisto

Overview

Shoppers know what they want but not what it is called, so they give up on the search box. The AI Search Bar answers what they mean: type "something to make coffee without electricity" and it finds the French press and the moka pot, even though neither product is called that. Type "how long does delivery take" and it finds the page that says so.

The package puts the bar on your store without any code. It reads your catalogue through your own Bagisto, with the prices and stock your store shows, and we read your pages ourselves. There is no API key to create and nothing to paste.

Requirements

• Bagisto 2.1 or newer, on PHP 8.1 or newer.
• Your server has to be able to make outgoing HTTPS requests, because the package talks to us directly.

Installing the Package

With Composer, from your Bagisto folder:

composer require asyntai/bagisto-ai-search
php artisan migrate
php artisan optimize:clear

Laravel picks the service provider up on its own. Without Composer, download the package, copy the Search folder to packages/Asyntai/Search, and follow the three short steps in its README.

Then, in the admin:

1. Open AI Search in the left menu.
2. Press Connect Asyntai. A window opens where you sign in or create a free account.
3. Wait a few minutes while we read your store. The AI Search page tells you when the bar is live.

Choosing Where the Bar Appears

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

In place of my search box

The default. The bar finds the search box your theme shows, hides it, and takes exactly the same place, in the desktop header and in the mobile one. If a shopper presses Enter without picking a result, your usual Bagisto search page still opens, so nothing they already know stops working.

Only where my theme puts it

Nothing in your header changes. Put <div data-asyntai-search></div> in your theme wherever the bar should go, and the bar renders into it.

The Other Settings

• Search box to replace. Leave it empty and we find the box ourselves. Fill in a CSS selector only if we pick the wrong one, for example header form[role=search].
• Placeholder text. Leave it empty and each shopper sees it in their own language.
• Accent colour. Leave it empty to use the colour set in your Asyntai dashboard.
• Share my catalogue with Asyntai. On by default. Switch it off and the bar searches your pages only.

Press Save after you change any of these.

What the Bar Searches

Your CMS pages and category pages, as we read them from your store. And your products: name, description, categories, price and availability come from your own Bagisto through a read-only feed the package adds at /asyntai-search/feed. Every request to it carries a fresh timestamp and a signature made with a token only your store and Asyntai hold.

The price is the one your store shows a guest: a special price or a catalogue rule that a shopper sees, we see. It is sent in your base currency. Only enabled products that are visible on their own, in your default channel, are searched. A product you disable disappears from the results at the next sync.

Trying It Before Your Shoppers Do

The AI Search page has a Try your search bar button. 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 package runs the bar on any plan, including the free one. Your monthly reply allowance still applies, and searches and chat replies share it. The AI Search page shows how much of the month is left.

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 package checks this every ten minutes where your store runs the Laravel scheduler, and on ordinary page views where it does not, so the bar comes back by itself when your allowance resets. You do not have to update or reinstall anything.

If Something Does Not Work

• No bar appears. Open the AI Search page and read the line under the coloured dot. It says exactly why the bar is off.
• The bar replaced the wrong element. Fill in Search box to replace with a CSS selector for the right one.
• Could not reach Asyntai. Your server cannot make outgoing HTTPS requests. Ask your host to allow them.
• Products are missing. Check that they are enabled, visible individually, and assigned to your default channel. The feed sends what the store itself shows.
• Bagisto signed you out during the connect step. Log in again and press Connect once more.
• Your browser blocked the pop-up. The AI Search page offers a link that opens the sign-in page in a new tab instead. The connection finishes the same way.
• The menu entry is missing. Run php artisan optimize:clear once after installing, so Bagisto reads the new menu.

Disconnecting

Press Disconnect this store on the AI Search page. The bar stops at once, the feed stops answering, and your usual Bagisto search takes over. Removing the package and rolling back its migration removes everything it added, including its own database table.

Using the Chatbot as Well

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