Connecting a catalog
Requires the Grow plan or higher.
A product catalog lets your chatbot search and recommend real products from your store. Promptly pulls products from your existing product API, embeds them for hybrid search, and exposes them to the bot as a search tool. This page covers creating a catalog and completing Step 1 — Connect API of the setup wizard.
Create a catalog
- Go to Dashboard → Product Catalogs.
- Click New Catalog.
- In the Create Catalog dialog, enter a Name (required).
- Optionally fill in When should AI use this catalog? — one or two sentences telling the bot what this catalog holds (for example, "Real estate listings in Serbia"). This is optional but improves AI accuracy when you run more than one catalog.
- Click Create Catalog. Promptly creates the catalog and opens the 4-step Setup Wizard.
Each catalog appears as a card on the list page showing its status (Active, Syncing, Not configured, or Idle), product count, and last sync time, with Manage, Sync Now, and Delete actions. Deleting is a soft-delete — you can Restore a catalog within 30 days.
🖼️ [Image] — The Product Catalogs list with catalog cards and the New Catalog button
Step 1 — Connect API
The wizard opens on Connect API. You can start from a platform preset (Shopify, WooCommerce, Magento 2, BigCommerce, PrestaShop, or Generic JSON), which auto-fills the connection and field mappings, or Configure manually.
To configure manually, set:
| Field | Notes |
|---|---|
| API Base URL | The endpoint returning your product list (required). |
| HTTP Method | text text text text |
| Headers | Key/value pairs, e.g. text |
| Query Params | Static parameters sent with every request. |
| Auth | text text text text |
You can also fill What does this catalog represent? here — the AI uses it to decide which fields matter.
When the connection is set, click Detect Schema. The AI fetches a sample response and infers your fields; this can take 30–90 seconds, with a progress bar and a Cancel button.
🎬 [Video] — Entering an API URL and auth, then running Detect Schema
Manual import for tiny catalogs
If you have no product API, you can push products directly. Send a
POST/api/tenant/product-catalog/importnamedescriptionpricecurrencycategorybrandimagesattributesinStockNext, continue to Schema detection & field mapping.