Product catalogue and recommendations

Build a product catalogue your AI can recommend from — add items by hand or upload your price list, attach photos, and keep it in sync with one upload.

Last updated
On this page
On this page

The Product tile in Flow Agents → AI Knowledge Hub holds your catalogue — the names, prices and details of everything you sell. Once it’s filled, your flow agents recommend real products with real prices whenever a customer asks — “do you have…”, “how much is…”, “which one is cheapest?” — in whatever language the customer writes, even when they misspell the product name.

Adding products one by one

Open the Product tile and click Add entry. Each product has:

  • Product name — what the item is called, e.g. Widget Pro 2024.
  • Description — a short description of what it is.
  • Price type, Price and Currency — Exact price for a single price, or Price range when the price depends on size, material or specification (see below).
  • Year — the model year, e.g. 2025. Optional; when a customer names only a brand, the newest year is recommended first (see below).
  • Remarks — specs and attributes, e.g. Color: Red, Aluminium.
  • Photos & files — pictures of the item, or a spec sheet. Drop them in or click to upload, and drag them to set the order.

Put the details that tell similar items apart — colour, size, storage — in the name or remarks, and the model year in Year. That’s what lets the AI pick the exact variant when a customer is specific, and ask which one they mean when they aren’t.

Pricing a product as a range

Price range on a product entry

Some products don’t have one price — a tailored dress costs more in the larger sizes, a cabinet depends on the material. Set Price type to Price range and enter the Minimum price and the Maximum price in the selected currency. The maximum must be above the minimum; until it is, the form shows Must be above the minimum price. and Save stays off. Put what the price depends on in Remarks, e.g. Sizes S–XL; larger sizes cost more.

A range shows in the Product table with both ends, e.g. MYR 179.00 – MYR 219.00. When a customer asks, the agent quotes the range rather than one number — “priced from MYR 179.00 to MYR 219.00; larger sizes cost more” — and a customer who names a budget is offered the products whose price, or price range, fits it.

To go back to a single price, set Price type to Exact price and save: the maximum is cleared and the price you entered stays.

Recommending the newest model first

When a customer names only a brand or a family — “do you have iPhone?”, “any Samsung?” — the agent leads with the matching products whose Year is the most recent, then the rest in their usual order. Fill the year in on your current models and they come up first; you don’t need to fill it in on every product.

Two things stay exactly as they are: a customer who names an exact model gets that model, and a customer who asks for the cheapest option gets the cheapest.

Importing your price list

For a bigger catalogue, click Data integration → Upload CSV/Excel and upload the file you already have — a CSV or Excel (.xlsx) price list exported from your POS or maintained in a spreadsheet. You don’t need to reformat it first:

  1. Choose file — or click Download example CSV if you’re starting from scratch.

  2. Match the columns. Each column from your file is matched to a product field — Product name, SKU / item code, Price, Maximum price (price range), Currency, Year, Description, Remarks. The matching is guessed for you; anything unmatched is set to Add to remarks so no data is lost, and columns you don’t want can be set to Skip this column.

Matching file columns to product fields

  1. Preview changes. Before anything happens, you see exactly what the upload will do.

Previewing what an upload will change

  1. Apply changes. The import runs in the background — a notification tells you when it’s done, e.g. Product import finished: 24 added, 3 updated.

Prices can stay in your file’s own format (e.g. RM 3,299.00) — they’re tidied up on import.

Keeping the catalogue in sync

When prices change or new items arrive, just upload the latest version of the same file:

  • Products already in the catalogue are updated in place.
  • Products not in the file are left untouched — an upload only adds and updates.
  • Nothing changes until you click Apply changes.
  • A file without a Year or Maximum price (price range) column leaves the years and price ranges you’ve set untouched.

Two tips for reliable syncing:

  • Include a SKU / item code column. The SKU is how a re-upload recognises a product you’ve renamed. Without SKUs, products are matched by their exact name.
  • Keep names unique (or use SKUs). If two rows share a name and have no SKU, only the first row is imported — the preview flags the rest under row(s) can’t be imported, with the row number, so you can fix the file.

Products from Shopify

When your Shopify store is connected (see Connecting Shopify), its products appear in the Product table next to the ones you add yourself. Only products that are active in your store come across.

In the table, each product from your store:

  • carries a Shopify badge — hover over it to see what the sync keeps up to date;
  • shows its store photo, like any product photo;
  • shows its price as a range, e.g. MYR 35.00 – MYR 80.00, when its variants have different prices, with the first few variants listed underneath — each with its price and stock (… in stock, Out of stock or Stock not tracked) — then +… more;
  • has a link icon that opens the product page in your online store. A product that is not published to your online store shows a crossed-out link instead, since there is no link to send.

Open a product to see every variant under Variants (from your store), or click Open in your online store to go to its page.

What a sync changes and what it keeps:

  • The name, description, price, variants and store photo are overwritten at every sync — change them in Shopify.
  • Photos you add yourself stay.
  • Descriptions come across in full, with their headings and lists kept as separate lines.
  • A Shopify product can’t be deleted here — delete it, or set it to draft, in Shopify, and it leaves the catalogue at the next sync.

When your AI agent recommends a Shopify product, it sends the photo, quotes the price and stock of the variant the customer asks about, and can share the link to the product in your online store.

Products from your website

If your online shop has a page for each product, you can bring every product in from your website instead of typing them one by one. No AI is used: each field is read from the product page itself.

  1. Above the Product table, click Data integration → Your website.
  2. Under Website address, enter your shop’s address.
  3. Under One product page, paste the address of any one product page. Every page whose address starts the same way (for example /item/) becomes a product.
  4. Click Read website.

Adding a website and one of its product pages

Nothing is added yet. The pages are read in the background, and you check a preview before anything is imported.

Checking the fields before you import

When the pages are read, the website shows Ready to import with how many products are new, updated or unchanged. How each field is filled shows what was read from your example page.

Ready to import, with how each field is filled

  1. Check each field. Automatic uses the product details the page carries for search engines. If a field shows the wrong text, pick the part of the page that shows the right one and click Save and read again.
  2. Click Import … products. Photos follow a few minutes later.

After the import:

  • Products you already have with the same name or product code are updated, not added twice. Each product from your website carries a Website badge.
  • Your website is checked every day. Price, photo and availability follow the product page; a name, description or remarks you edit here is kept.
  • A product whose page leaves your website is removed. One you edited stays as your own product.
  • If most product pages stop matching (your website’s layout changed), nothing is changed until you check the fields again.
  • Your plan includes a set number of products. When an import would go past it, the preview says how many new products won’t be added.
  • Stop importing keeps your products; they are just no longer updated from your website.

Switching a product off

Every row in the Product table has an On switch. Switch a product off when it is out of stock, discontinued for a season, or needs a price check before the AI agent should mention it again.

A product switched off in the catalogue

While a product is off:

  • The AI agent leaves it out of recommendations, catalogue answers and order taking.
  • The row stays in your table, greyed out, with its description, price and photos intact.
  • A price-list upload or store sync never switches it back on. New products, typed in or imported, start switched on.

Switch it back on and the product is available again straight away.

Recommending products in a flow

You don’t have to change your flow at all — once the catalogue exists, agents answer product questions whenever customers ask them, then carry on with the flow.

When an agent answers this way, the photos attached to the products it recommends are sent right after its reply — only for the products it actually named, so a customer asking about one item doesn’t receive your whole catalogue.

To recommend at a specific moment — say, right after asking what the customer is looking for — open the flow designer, select the step, and set Tool type to Product in the step’s Tool section. That step then recommends live from your product catalogue: real names and prices, based on what the customer needs. Optionally, set Search from variable to a variable that holds what the customer wants (e.g. product_need); leave it blank to search from the customer’s latest message. If the variable holds a yes/no answer rather than a product, the step searches the customer’s latest message instead. A step set up this way sends the product details as text.

Note: an OpenAI API key (added under Settings → Integrations → AI Providers) is required for the AI to search and use your catalogue.

Showing only the products that match

A product search always returns the closest products in your catalogue, even when none of them is what the customer asked for. To leave those out, open the step’s Tool section and set Which products to use:

  • Closest products from the search (the default): the step uses the closest matches, even when some aren’t what the customer asked for.
  • Only matching — hand off if none: the step keeps only the products that are what the customer asked for, including the right fit or model. A side mirror made for another car model, for example, is left out. Each product is checked against what the customer said and the answers they already gave, such as their car model.

Which products to use on a product step

When no product matches, the customer is told the item couldn’t be found in your catalogue and that a teammate will check it. The conversation goes to your team, with a private note saying what the customer asked for. The same happens if your catalogue can’t be searched at that moment.

AI Task steps that use the product tool have the same option, as Only matching products. The task then works only with the matching products, and a later step that shows the same search does too. If none match, the task gets “No matching products found.” so the next branch in your flow can decide what happens, for example hand the customer to your team.

You can also ask the flow designer. “Only show products that actually fit what the customer asked for” turns it on for the steps that pick and show products; “Show the closest products again” turns it off. Flows the designer builds use the closest products unless you ask. If your flow opens in the chat designer, choose Switch to classic view to open a step’s settings.