Giizo AI
Ready-made platform plugins

Platform plugin

Installing the Giizo AI widget on your CS-Cart store

Ready-made add-on for CS-Cart 4.10 and above: installing from the Add-ons screen, entering the Agent ID and API key, and verification steps.

Version: 1.0.1Size: 16 KBRequirements: CS-Cart 4.10+ · PHP 7.4+
Download plugin

This add-on puts the chat widget on your CS-Cart store without writing code. The signed URL generation you would otherwise have to build yourself is handled by the add-on on the server side.

Requirements

  • CS-Cart 4.10 or above
  • PHP 7.4 or above
  • An assistant created and set to active in the dashboard

Step 1: Prepare your Agent ID and API key

Installation asks for two values; get both ready first.

API key. Generated on theSettings screen in the dashboard.

Agent ID. It appears as agent-id="..." inside the embed snippet on the assistant's Access Channels → Widget screen. There is no field in the dashboard that shows the Agent ID on its own, so you have to copy it out of the snippet.

Step 2: Install the add-on

Download the ZIP with the button at the top of this page, then:

  1. In the CS-Cart admin panel go to Add-ons → Manage add-ons
  2. Click the + button in the top-right corner
  3. Upload the ZIP file you downloaded
  4. Click Install

Step 3: Enter the settings

  1. Open Add-ons → Giizo AI Widget → Settings
  2. Enter your API key in the API Key field
  3. Enter your assistant's identifier in the Agent ID field
  4. Enable Enable Widget
  5. Click Save

Step 4: Verify on your store

Open the front end of your store. The chat button should appear in the bottom-right corner and open the window when clicked.

If the widget does not appear, check in this order:

  1. Is the assistant active? Widget configuration is not served for inactive assistants.
  2. Is the allowed domain list populated? If the list on the assistant'sSecurity tab is empty every domain is allowed; if it is populated your store's domain has to be in it.
  3. On multilingual stores, check which storefront you are testing.

Product recommendations

For the assistant to recommend your store's products, those products have to be added to the Giizo catalogue. The add-on does not transfer your CS-Cart product catalogue into Giizo; catalogue setup is a separate step, done by manual entry or with the Excel template. Details: Smart catalogue.

Product recommendations from the catalogue appear in the web widget as cards with an image, price and button.

Changing the appearance

Colours, button size, window variant and copy are configured in the dashboard, not in the add-on: the assistant'sAccess Channels → Widget screen. Because the widget fetches its appearance configuration from the server on every load, changes take effect without touching the add-on.

Things to know

  • Only one widget runs per page.
  • Version updates require downloading and installing the add-on again; there is no automatic update.