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

Go to your OpenCart Admin panel.

Upload the extension

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

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.

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

Open Integrations → OpenCart

In your agent, go to the OpenCart integration page.

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.

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.

Click Connect

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

Available actions

Action	Description
Product Search & Recommendations	Searches the catalogue and returns product cards with images, prices, and direct links.
Order Status Lookup	Retrieves order status, shipping details, and purchase history using order number and email.
View Cart	Displays the customer's current cart contents, quantities, and totals.
Browse Categories	Used internally to find categories when keyword search returns no results — improves product discovery.
Update Customer Profile	Lets signed-in customers update their name, email, or phone number through chat.
Update Billing Address	Lets signed-in customers add or modify billing addresses through natural conversation.
Compare Products	Shows a side-by-side comparison of up to 4 products the customer is considering.
Check Return Eligibility	Checks whether an order is still within your configured return window, based on the order date and the return window you set on the integration page.
Check Discount Code	Validates whether a discount or coupon code the customer mentions is currently active.
Get Cross-Sell / Related Products	Suggests related products from the same category after the customer shows interest in an item.
Add to Cart	Adds a specific product, quantity, and selected options directly to the customer's cart, with a confirmation card shown before it's added. Unique to OpenCart — other platforms use View Cart only.

ℹ️

Order Cancellation is not currently available for OpenCart stores — it's supported on Shopify and WooCommerce only.

Health monitoring

The integration page shows a health status for your OpenCart connection, backed by periodic background checks and incoming webhook activity:

•Healthy — the connector, API, and catalogue sync are all operating normally.
•Warning — shown when the last store action failed, or when no webhook event has been received from your store for 48 hours. A warning doesn't mean the integration is broken: scheduled polling keeps your catalogue synced even without webhooks, but it's worth checking that your OpenCart extension is still installed and reachable.

Behind the scenes, AIChatVault deduplicates incoming webhook events and tracks consecutive failures per integration, so a single flaky request from your store doesn't cascade into repeated processing or false alarms — this is what the reliability hardening added to the OpenCart integration covers.

Enabling and disabling the integration

Use the enable/disable toggle on the integration page to temporarily turn the store integration off without disconnecting it — useful if you need to pause AI store actions during maintenance. Your API key is masked on the integration page after saving (only the last 4 characters are shown); re-enter it if you ever need to change it.

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.

Magento 2

Overview

Was this page helpful?