Docs/E-Commerce/OpenCart Integration

OpenCart Integration

The OpenCart integration uses a downloadable extension that adds an API bridge and optional widget injection to your OpenCart store. Once the extension is installed, you connect with a single API key — no OAuth flow or credential pairs needed.

Step 1 — Download the OpenCart extension

On the OpenCart integration page in AIChatVault, two download links are available:

  • Download for OpenCart 3.x — use for OpenCart 3.0.x stores.
  • Download for OpenCart 4.x — use for OpenCart 4.0.x stores.

Download the version that matches your OpenCart installation.

Step 2 — Install the extension

1

Log in to OpenCart Admin

Go to your OpenCart Admin panel.
2

Upload the extension

Navigate to Extensions → Installer. Upload the downloaded .ocmod.zip file and click Upload.
3

Install and enable

Go to Extensions → Extensions → select Modules from the dropdown. Find "AIChatVault" in the list and click Install, then Edit to enable it.
4

Refresh modifications

Go to Extensions → Modifications and click the Refresh button (top right) to apply the module's modifications to your store.

Step 3 — Get the API key

After the extension is installed, it generates an API key visible in the module's settings page in OpenCart Admin. Copy this key.

Step 4 — Connect in AIChatVault

1

Open Integrations → OpenCart

In your agent, go to the OpenCart integration page.
2

Enter your store URL and API key

Paste your OpenCart store's URL (e.g. https://yourstore.com) and the API key copied from the module settings.
3

Test the connection

Click Test Connection to verify the API key is valid and AIChatVault can reach your store. The test shows your store name and product count if successful.
4

Click Connect

Once the test passes, click Connect. A background product sync starts automatically.

Available actions

ActionDescription
Product Search & RecommendationsSearches the catalogue and returns product cards with images, prices, and direct links.
Order Status LookupRetrieves order status, shipping details, and purchase history using order number and email.
View CartDisplays the customer's current cart contents, quantities, and totals.
Browse CategoriesUsed internally to find categories when keyword search returns no results — improves product discovery.
Update Customer ProfileLets signed-in customers update their name, email, or phone number through chat.
Update Billing AddressLets signed-in customers add or modify billing addresses through natural conversation.

Widget embed

The OpenCart extension can inject the chat widget automatically into your storefront when enabled in the module settings. Alternatively, copy the widget snippet from the integration page in AIChatVault and paste it manually into your OpenCart theme's footer template.

Product sync

After connecting, AIChatVault syncs your OpenCart product catalogue to the knowledge base. The integration page shows the synced product count and last sync timestamp. Click Sync Products to trigger a manual sync after catalogue changes.

Disconnecting OpenCart

Clicking Disconnect in AIChatVault removes the stored credentials and clears synced products. The OpenCart extension remains installed — disable it in OpenCart Admin → Extensions → Modules if you no longer need it.

💡
Run the Test Connection check before clicking Connect — it confirms your store URL is correct, the API key is valid, and the extension is properly installed, saving you from debugging a silent connection failure later.

Was this page helpful?