OpenCart Extension

The Conferbot OpenCart extension embeds the AI chat widget on an OpenCart 3.x store and passes the logged-in customer identity plus store/cart context to the bot. Requires OpenCart 3.0.x and PHP 7.2+.

See it in action

Paste the Chatbot ID, flip the switch, and the bot is live on the storefront - 30 seconds end to end:

How it works

The extension registers an OpenCart event on catalog/view/common/header/after and injects the standard Conferbot loader before </head> on every storefront page:

What the extension injects
<script src="https://cdn.conferbot.com/dist/v1/widget.min.js" async></script>
<script>
  window.ConferbotWidget("<CHATBOT_ID>", "live_chat", {
    user:       { id, name, email },              // logged-in customer, if any
    customData: { platform: "opencart", storeName, storeUrl,
                  storeLanguage, storeCurrency, cartTotal, cartItemCount }
  });
</script>

Storefront injection uses OpenCart's event system - no OCMOD file modifications - so it never conflicts with theme or vQmod/OCMOD edits to header.php. Widget appearance stays dashboard-driven.

Requirements

  • OpenCart 3.0.x
  • PHP 7.2+
  • A Conferbot account with a published chatbot, or the built-in demo bot to try it first

Installation

  1. Get conferbot.ocmod.zip from the latest GitHub release (or zip the repository contents with the upload/ directory at the top level).
  2. In the OpenCart admin, go to Extensions > Installer and upload the zip.
  3. Go to Extensions > Extensions, choose the Modules type, find Conferbot and click Install (the green plus). Installing registers the storefront event.
  4. Click Edit to open the configure screen.

Configuration

The configure screen is two steps: paste your Chatbot ID, flip the switch, save. You can paste the bare ID, the full embed snippet, or a dashboard URL - the extension extracts the ID for you.

  • Chatbot ID (required) - in the Conferbot dashboard open your bot, go to Share > Embed into website, and copy the Bot ID (24-character hex).
  • Turn the chat on - master on/off switch.
  • How the chat appears (advanced) - floating chat bubble (default) or popup window.
  • Widget script URL (advanced) - leave as is for the Conferbot CDN; useful for staging/self-hosted widget builds.
💡

No account yet?

Click Try our demo bot on the configure screen - it fills in the public demo bot 691c970890527a0468f9b2c9, which works out of the box.

Settings are stored under the module_conferbot code: module_conferbot_status, module_conferbot_bot_id, module_conferbot_embed_type, and module_conferbot_script_url.

What the extension passes to the widget

  • user- the logged-in customer's id, name, and email (omitted for guests).
  • customData - platform: "opencart", store name, store URL, store language, store currency, cart total, and cart item count.

Troubleshooting

If the widget does not appear:

  • Check the module is installed and enabled on the configure screen.
  • Check the Chatbot ID is correct and the bot is published and not disabled.
  • Check the conferbot event exists and is enabled under Extensions > Events.
  • Clear the theme/SASS caches under Dashboard > gear icon > Refresh.

No API key or workspace ID is required - the widget resolves everything server-side from the Chatbot ID over Socket.IO (wdt.conferbot.com). Outbound webhooks (order status, product updates, abandoned cart) are not part of this version.

Source

Open source (GPL-3.0-or-later, the OpenCart marketplace convention) on GitHub: Conferbot/conferbot-opencart. 18 PHPUnit tests (60 assertions) cover bot ID extraction, strict validation, widget option building, script-injection safety, and loader snippet rendering - the loader is a pure PHP class, so the suite runs without an OpenCart installation.