Magento 2 Module

The Conferbot Magento 2 module embeds the AI chat widget on a Magento 2 store (Open Source or Adobe Commerce) and passes the logged-in customer identity plus store/cart context to the bot. Requires Magento 2.4.x and PHP 8.1+.

💡

Demo video

The merchant flow is identical across every Conferbot integration: paste the Chatbot ID, enable, and the bot is live. The demos on the PrestaShop and Shopify pages show the same flow - a Magento-specific recording will be added after the staging smoke test.

How it works

The module adds a block to the before.body.end container on every storefront page and injects the standard Conferbot loader:

What the module 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: "magento", storeName, storeUrl,
                  storeLanguage, storeCurrency, cartTotal, cartItemCount }
  });
</script>

Widget appearance and behavior are configured in the Conferbot dashboard under Customize and delivered at runtime - the module does not duplicate those settings.

Requirements

  • Magento 2.4.x (Open Source or Adobe Commerce)
  • PHP 8.1+
  • A Conferbot account with a published chatbot, or the built-in demo bot to try it first

Installation

Via Composer (recommended):

Composer install
composer require conferbot/module-chat
bin/magento module:enable Conferbot_Chat
bin/magento setup:upgrade
bin/magento cache:flush

Manual (app/code): copy the repository to app/code/Conferbot/Chat/ in your Magento root, then run the same module:enable, setup:upgrade, and cache:flush commands.

Configuration

In the Magento admin go to Stores > Configuration > Services > Conferbot. Two steps: paste your Chatbot ID, set Enable Chat to Yes, save. You can paste the bare ID, the full embed snippet, or a dashboard URL - the module extracts the ID for you.

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

All settings support Magento's default/website/store configuration scopes (Widget Script URL is global).

💡

No account yet?

Paste the public demo bot ID 691c970890527a0468f9b2c9 - it works out of the box so you can see the widget live before signing up.

What the module passes to the widget

  • user- the logged-in customer's id, name, and email (omitted for guests).
  • customData - platform: "magento", store name, store URL, store language, store currency, cart total, and cart item count - so the bot and human agents see the customer's cart value and store details.

Troubleshooting

If the widget does not appear:

  • Check the module is enabled: bin/magento module:status Conferbot_Chat.
  • Check Enable Chat is Yes in the current configuration scope.
  • Check the Chatbot ID is correct and the bot is published and not disabled.
  • Flush the cache: bin/magento cache:flush. With full page cache enabled the block renders into the cached page - flush after config changes.

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 (OSL 3.0) on GitHub: Conferbot/conferbot-magento. The PHPUnit suite covers bot ID parsing, strict validation, widget option building (guest/customer/cart variants), and script-injection safety - it runs without a Magento installation because the loader class is dependency-free by design.