Chat plugin for OpenCart: what to look for, and how to install one on versions 3 and 4

A chat plugin for OpenCart earns its place when it does four things beyond putting a bubble on the page: syncs the catalogue so answers carry real prices and stock, looks up orders live from the store, hands a conversation to a person with the transcript, and answers in the shopper's language. Below: what to look for, installation on OpenCart 3 and 4, pull versus push sync behind Cloudflare, and the checks to run before launch.

Live chat plugin or AI chat plugin?

OpenCart's marketplace has both, and the label "chat" hides the difference. A live-chat plugin routes messages to a person; when nobody is online, the shopper waits. An AI chat plugin answers from the store's own data and hands over only when it should. For a small OpenCart store the second is usually the right shape, because most questions are about shipping, orders and products, and most arrive when nobody is at the desk. The general case is made in what an AI chatbot for ecommerce is; this guide is OpenCart-specific.

What to look for in a chat plugin for OpenCart

1. Version coverage. OpenCart 3.0.x and OpenCart 4.0–4.1 are different platforms with different extension formats (OCMOD with install.xml on OC3; install.json on OC4). Check the plugin ships both and states its PHP requirement; Vatdi's OC3 extension runs on PHP 7.0+, the OC4 extension on PHP 7.3+.
2. One-click connect. You should not be copying API keys between tabs. A "Connect to Vatdi" button in the module page creates the account link and stores the credentials.
3. Catalogue sync that survives your hosting. Many OpenCart stores sit behind Cloudflare or a host firewall that blocks inbound sync calls. Look for a push mode driven by your own cron (details below).
4. Order lookup with verification and a rate limit. The bot should require the order number plus the email or phone on the order, and refuse repeated guesses. Vatdi's OC4 extension limits lookups to five attempts per five minutes per order.
5. Real-time updates on OC4. OpenCart 4's event system lets the extension push a single changed product to the assistant within seconds of an admin save; bulk imports still rely on the cron.
6. A price you can forecast. Vatdi is flat per store with unlimited teammates: Free (15 conversations a month), Starter $4.49, Grow $7.49 unlimited, as of September 2026 (pricing).

The Vatdi extension is listed on the OpenCart marketplace (extension 47958); the platform page with the feature matrix is AI chat for OpenCart.

Installing on OpenCart 3

1. Extensions › Installer: upload the OC3 zip (an OCMOD package). If the upload fails, check that storage/upload is writable.
2. Extensions › Modifications: click the refresh button so the OCMOD that injects the widget is applied.
3. Extensions › Extensions › Modules: find Vatdi AI Chat Agent, click Install, then Edit.
4. Connect to Vatdi: click the button; a short sign-up or sign-in creates the link and stores the store key and secret for you.
5. Enable Chat Widget: switch it on and save. The bubble appears on every shop page.
6. Test Connection: confirms the store can be reached for sync. If it fails and your store is behind Cloudflare, switch to push mode below rather than fighting the firewall.

Version note: OC3 extension 1.3.0 removed a PHP 7.0 incompatibility that caused a parse error on some hosts after install; if you see one, update the extension before anything else.

Installing on OpenCart 4

1. Extensions › Installer: upload the OC4 zip. OpenCart 4 reads install.json and copies the files itself; click Install on the uploaded row.
2. Extensions › Extensions › Modules: find Vatdi AI Chatbot, click Install, then Edit.
3. Connect to Vatdi, then Enable Chat Widget and save. Go to Dashboard opens your Vatdi dashboard from the same page.
4. Leave the events registered. The extension hooks OpenCart 4's product, category, coupon, manufacturer and information-page events so admin edits reach the assistant within seconds.

Upgrading: reinstalling an earlier OC4 version could wipe the connection; from OC4 1.2.5 and OC3 1.3.1 the credentials survive a reinstall. If you are on an older version, upgrade before reinstalling, or expect to click Connect again.

Pull or push sync: the Cloudflare question

By default the assistant pulls: it calls your store's sync endpoints on a schedule, authenticated with the store key and secret. Cloudflare's bot protection and some host firewalls block those calls, and the classic symptom is "connected but only one product synced". Push mode reverses the direction: your own cron calls a URL on your store, and the store sends its catalogue out to Vatdi. The module page shows the exact cron command after you connect; every 15 minutes is typical, hourly also works. Push is available in OC3 from extension 1.3.0 and OC4 from 1.2.0. On OC4, admin edits are additionally pushed one item at a time within seconds, but bulk imports and SQL-level changes still need the cron.

What order lookup does on OpenCart

With the plugin connected, a shopper who asks "where is my order" is asked for the order number and the email or phone used at checkout; the extension checks the pair against the order and returns the status live. Nothing is shown without a match, and the OC4 extension limits attempts to five per five minutes per order so an email cannot be guessed. This is the single feature that most reduces the support inbox on a store, and the one to test first; see how to track orders with a chatbot and order tracking in chat.

Checks to run before customers see it

1. Catalogue count. Compare the number of synced products in the Vatdi dashboard with your OpenCart catalogue. A big gap means pull is blocked; switch to push.
2. Ten real questions from your inbox, asked in the live widget on a phone: shipping time and cost, returns, a product's size or compatibility, stock of a variant.
3. One real order number with the right email, then with a wrong email. Live status, then a polite refusal.
4. Two negative cases: a product you do not sell and an exact delivery date. A decline and a range.
5. Handover: ask for a person inside and outside your agent hours; check the alert arrives and the offline notice is honest.
6. A second language if you sell abroad; the answer and the widget labels should both switch.

Fix the content behind any wrong answer, not the plugin: a missing shipping page or an attribute stored only in a product image is the usual cause. The general set-up order is in how to train a chatbot on your data.

Troubleshooting

• Parse error after installing on OC3: a PHP version mismatch; update to OC3 extension 1.3.0 or later.
• Connected but one product synced: Cloudflare or a host firewall blocking pull; enable push mode and add the cron.
• Widget not visible on OC3: the OCMOD was not applied; refresh under Extensions › Modifications, then clear the theme cache.
• Connection lost after reinstall: older versions reset credentials on reinstall; upgrade to OC4 1.2.5 / OC3 1.3.1 or later, then reconnect once.
• Prices in answers look stale: check the cron is running (push) or that Test Connection passes (pull); on OC4 confirm the events are registered.

The platform page, AI chat for OpenCart, keeps the current version numbers and the download; the wider platform list is on the integrations page, and OpenCart's own documentation covers the installer and modifications system (docs.opencart.com). For choosing between tools rather than installing one, see best AI chatbots for small online stores.

Frequently asked questions

Does the chat plugin work on both OpenCart 3 and OpenCart 4?

Vatdi ships two extensions: one for OpenCart 3.0.x (OCMOD format, PHP 7.0 or later) and one for OpenCart 4.0 to 4.1 (install.json format, PHP 7.3 or later). Both connect with one click, sync the catalogue and support order lookup. OpenCart 4 additionally pushes single admin edits to the assistant in real time through its event system. Check your exact OpenCart version before downloading.

Can the OpenCart chatbot check a customer's order status?

Yes. The shopper provides the order number plus the email or phone on the order, the extension verifies the pair and returns the live status from your store; nothing is shown without a match. The OC4 extension limits lookups to five attempts per five minutes per order to prevent email guessing. Test it with a real order and a wrong email before launch.

My store is behind Cloudflare and the sync only got one product. What now?

Cloudflare is blocking the inbound pull. Switch to push mode: after connecting, the module page shows a cron command; add it to your hosting control panel to run every 15 minutes. Your store then sends the catalogue outbound, which Cloudflare does not inspect. Push is available from OC3 extension 1.3.0 and OC4 extension 1.2.0.

What does the plugin sync from OpenCart?

Products, categories, manufacturers, information pages, coupons, and store, shipping and policy information, so the assistant can answer product, price, stock, shipping and policy questions and show product cards. On OpenCart 4, saves and deletes of those items are pushed individually within seconds; bulk imports are picked up by the scheduled sync.

Will installing the plugin slow down my OpenCart store?

The widget script loads asynchronously after the page content, and the sync runs on a schedule rather than on page views. Check it yourself: compare a product page's load with and without the widget enabled. If you use push mode, the cron runs on your server every 15 minutes; on a normal catalogue it completes quickly, and you can run it hourly instead.

How much does an AI chat plugin for OpenCart cost?

The Vatdi extension itself is free to install; the assistant is priced per store, not per agent. As of September 2026: Free with 15 conversations a month and every feature, Starter at $4.49 a month for 150 conversations, Grow at $7.49 a month for unlimited, with unlimited teammates on each. Other OpenCart chat plugins often price per agent or sell the AI as an add-on; check the unit before comparing.