Integration Guides

How to add BizDriver.ai Assistant to your website or eCommerce platform
Setup Time: 2 Minutes • Scope: Sitewide
1

Obtain Your Unique Chat ID

Sign in to your BizDriver.ai Dashboard, navigate to AI AgentsWebsite Integration, and locate your unique Chat ID.

2

Paste the Embed Code Before </body>

Add this standard module script tag directly before the closing </body> tag on your HTML pages:

<script type="module">
import { initEmbeddedChat } from 'https://unpkg.com/embeddedaichatux@latest/EmbeddedChat.js';

document.addEventListener('DOMContentLoaded', function () {
  initEmbeddedChat(null, 'YOUR_CHAT_ID', {
    serverUrl: 'https://app.bizdriver.ai/'
  });
});
</script>

Replace YOUR_CHAT_ID with the ID from your BizDriver dashboard.

Content Security Policy (CSP) Settings

If your website enforces strict Content Security Policy headers, make sure to whitelist:

  • script-src https://unpkg.com;
  • connect-src https://app.bizdriver.ai;
Setup Time: 5–10 Minutes • Access: WordPress Administrator • Zero Theme Editing
1

Install the Free WPCode Plugin

  1. Log in to your WordPress administrator dashboard.
  2. Go to Plugins → Add New Plugin.
  3. Search for "WPCode – Insert Headers and Footers + Custom Code Snippets".
  4. Click Install Now, then click Activate.

Note: The free version of WPCode is 100% sufficient for this installation.

2

Open WPCode Header & Footer Settings

  1. In the WordPress admin sidebar, go to Code Snippets → Header & Footer.
  2. Locate the Header text area at the top of the page.
3

Paste the BizDriver.ai Script & Save

Paste the following code snippet into the Header field and click Save Changes:

<script type="module">
import { initEmbeddedChat } from 'https://unpkg.com/embeddedaichatux@latest/EmbeddedChat.js';

document.addEventListener('DOMContentLoaded', function () {
  initEmbeddedChat(null, 'YOUR_CHAT_ID', {
    serverUrl: 'https://app.bizdriver.ai/'
  });
});
</script>
4

Test on Your Live Site

Open your public website in a new tab, refresh the page, and the BizDriver chat launcher will automatically appear in the bottom-right corner. No shortcodes or Gutenberg blocks are needed!

WordPress Troubleshooting & Checklist
  • Caching Plugins: If the widget doesn't appear immediately, clear your WordPress cache (WP Rocket, LiteSpeed, W3 Total Cache), hosting cache, and browser cache.
  • JS Minification / Delay: If using a speed optimizer that delays JavaScript, exclude unpkg.com/embeddedaichatux from deferred execution.
  • Verify Chat ID: Ensure you replaced YOUR_CHAT_ID with your valid Agent ID from BizDriver.ai.
Setup Time: 3 Minutes • Methods: Visual Editor (Embed HTML) or Dashboard (Custom Code)
A

Method 1: Wix Visual Editor (Embed HTML + Pin to Corner)

  1. In the Wix Editor, click Add Elements (+) → Embed Code → Embed HTML.
  2. Click Edit Code and paste the following snippet, then click Update:
    <body><script type="module">
    import {initEmbeddedChat} from 'https://unpkg.com/embeddedaichatux@latest/EmbeddedChat.js';
    
    document.addEventListener('DOMContentLoaded', function () {
      initEmbeddedChat(null, 'YOUR_CHAT_ID', {
        'serverUrl': 'https://app.bizdriver.ai/'
      });
    });
    </script></body>
  3. Resize the chat container to approximately Width: 350px, Height: 720px.
  4. Pin to corner: Right-click on the chat component, select Pin Settings, and choose the lower right corner.
  5. Publish your Wix website!
B

Method 2: Wix Dashboard Custom Code (Sitewide)

  1. Go to your Wix Site Dashboard → Settings → Custom Code (under Advanced).
  2. Click + Add Custom Code.
  3. Paste the BizDriver.ai script snippet.
  4. Under Place Code In, select Body - end.
  5. Under Add Code to Pages, select All Pages • Load code once.
  6. Click Apply and publish your site.
Setup Time: 5–10 Minutes • Integration Method: PrestaShop Module
1

Create the Module Directory & File

In your PrestaShop installation root, create the following module path:

/modules/bizdriverassistant/bizdriverassistant.php

Paste the following PHP module code into bizdriverassistant.php:

<?php

if (!defined('_PS_VERSION_')) {
    exit;
}

class BizDriverAssistant extends Module
{
    public function __construct()
    {
        $this->name = 'bizdriverassistant';
        $this->tab = 'front_office_features';
        $this->version = '1.0.0';
        $this->author = 'BizDriver.ai';
        $this->need_instance = 0;
        $this->bootstrap = true;

        parent::__construct();

        $this->displayName = 'BizDriver AI Assistant';
        $this->description = 'Adds the BizDriver AI Assistant widget to the storefront.';
    }

    public function install()
    {
        return parent::install()
            && $this->registerHook('displayHeader');
    }

    public function hookDisplayHeader($params)
    {
        // Optional: do not show on checkout/order pages
        $excludedControllers = [
            'cart',
            'order',
            'checkout',
            'orderconfirmation',
            'authentication'
        ];

        $controller = $this->context->controller->php_self;

        if (in_array($controller, $excludedControllers)) {
            return '';
        }

        return <<<HTML
<script type="module">
import {initEmbeddedChat} from 'https://unpkg.com/embeddedaichatux@latest/EmbeddedChat.js';

document.addEventListener('DOMContentLoaded', function () {
  initEmbeddedChat(null, 'YOUR_CHAT_ID', {
    'serverUrl': 'https://app.bizdriver.ai/'
  });
});
</script>
HTML;
    }
}
2

Install the Module in PrestaShop Back Office

  1. Log in to your PrestaShop Back Office.
  2. Go to Modules → Module Manager.
  3. Search for "BizDriver AI Assistant".
  4. Click Install.
3

Clear PrestaShop Cache

  1. Go to Advanced Parameters → Performance.
  2. Click the Clear cache button in the upper-right corner.
  3. Open your storefront to verify the chat widget is active!
PrestaShop Tips & Optimization
  • DisplayHeader Hook: PrestaShop's displayHeader hook injects the script cleanest into the storefront <head> without modifying core template files.
  • Whitelisting / CSP: Ensure your hosting allows script-src https://unpkg.com; and connect-src https://app.bizdriver.ai;.
Setup Time: 2 Minutes • Direct Template Embed

Shopify Theme Integration

  1. In your Shopify Admin, go to Online Store → Themes.
  2. Click the Actions / ... button next to your active theme → Edit code.
  3. Under the Layout folder, select theme.liquid.
  4. Scroll down to the bottom and paste the BizDriver script immediately before the closing </body> tag:
    <script type="module">
    import { initEmbeddedChat } from 'https://unpkg.com/embeddedaichatux@latest/EmbeddedChat.js';
    
    document.addEventListener('DOMContentLoaded', function () {
      initEmbeddedChat(null, 'YOUR_CHAT_ID', {
        serverUrl: 'https://app.bizdriver.ai/'
      });
    });
    </script>
  5. Click Save in the upper right.
Setup Time: 2 Minutes • Code Injection

Squarespace Code Injection

  1. In your Squarespace menu, go to Settings → Advanced → Code Injection (or Website → Pages → Custom Code → Code Injection).
  2. Paste the following BizDriver script into the Footer box:
    <script type="module">
    import { initEmbeddedChat } from 'https://unpkg.com/embeddedaichatux@latest/EmbeddedChat.js';
    
    document.addEventListener('DOMContentLoaded', function () {
      initEmbeddedChat(null, 'YOUR_CHAT_ID', {
        serverUrl: 'https://app.bizdriver.ai/'
      });
    });
    </script>
  3. Click Save in the upper-left corner.