Catalogs

A catalog is a set of products or services the bot’s Catalog node can present to the user. Each catalog holds bilingual items with a price and (optional) image. Use catalogs for menus, plan tiers, service lists — anywhere the bot needs to render a structured product picker.

Creating a catalog

1. Settings → Catalogs → + New.
2. Name (EN) — the English label shown to admins and to the bot (e.g. Plan tiers).
3. Name (AR) — optional Arabic label, used when the bot is replying in Arabic.
4. Description — optional free text shown to admins only.
5. Currency (ISO 4217) — the default currency for items inside this catalog (e.g. AED, SAR, USD). Items can override per-row.

Newly created catalogs appear in the left rail. Select one to manage its items.

Adding items

The Catalogs page is a split view — the catalogs list sits on the left and the selected catalog’s items list sits on the right. Click any catalog on the left to load its items in the right pane.

With a catalog selected, click + New item in the items panel.

1. SKU — short unique identifier within this catalog (e.g. PLAN-GOLD). Used as the value the bot returns when the user picks this item.
2. External ID (optional) — your downstream system’s identifier for the item.
3. Name (EN) / Name (AR) — the labels the bot shows.
4. Description (EN) / Description (AR) — optional secondary text shown under the name.
5. Price — entered in the smallest currency unit (fils or cents). Example: 2500 for AED 25.00.
6. Currency — defaults to the catalog’s currency. Override only for mixed-currency catalogs.
7. Image URL — optional. Paste a publicly reachable URL; the bot renders the image alongside the row.
8. Sort order — integer used to order items in the Catalog node. Lower comes first.

Items can be marked Unavailable when editing — they stay in the catalog for audit but the bot hides them.

Activating and deactivating a catalog

The catalog header has an Activate / Deactivate toggle. Deactivated catalogs are invisible to the bot but remain in this admin surface for editing. Use this when retiring a catalog without losing the data.

Where catalogs are used

• Catalog node in the recipe canvas — picks a catalog by name and renders its items as a selectable list.
• Smart Plug entity bindings — some plugs read catalog rows to render product info inside the agent right rail.

Deleting a catalog

Deleting a catalog soft-deletes every item inside it. Recipes that reference the deleted catalog by name will fail their Catalog node — find them and re-point before deleting.

Best practices

• Store prices in the smallest unit. AED 25.00 is 2500, not 25 or 25.00. This avoids every floating-point rounding bug downstream.
• Keep SKUs stable. Bot recipes branch on the SKU value the user picked; renaming a SKU breaks every conversation in flight at that step.
• Use sort order liberally. The default zero on every new item means insertion order — set explicit values once you have more than five items.