Integration Guides
Obtain Your Unique Chat ID
Sign in to your BizDriver.ai Dashboard, navigate to AI Agents → Website Integration, and locate your unique Chat ID.
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;
Install the Free WPCode Plugin
- Log in to your WordPress administrator dashboard.
- Go to Plugins → Add New Plugin.
- Search for "WPCode – Insert Headers and Footers + Custom Code Snippets".
- Click Install Now, then click Activate.
Note: The free version of WPCode is 100% sufficient for this installation.
Open WPCode Header & Footer Settings
- In the WordPress admin sidebar, go to Code Snippets → Header & Footer.
- Locate the Header text area at the top of the page.
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>
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/embeddedaichatuxfrom deferred execution. - Verify Chat ID: Ensure you replaced
YOUR_CHAT_IDwith your valid Agent ID from BizDriver.ai.
Method 1: Wix Visual Editor (Embed HTML + Pin to Corner)
- In the Wix Editor, click Add Elements (+) → Embed Code → Embed HTML.
- 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> - Resize the chat container to approximately Width: 350px, Height: 720px.
- Pin to corner: Right-click on the chat component, select Pin Settings, and choose the lower right corner.
- Publish your Wix website!
Method 2: Wix Dashboard Custom Code (Sitewide)
- Go to your Wix Site Dashboard → Settings → Custom Code (under Advanced).
- Click + Add Custom Code.
- Paste the BizDriver.ai script snippet.
- Under Place Code In, select Body - end.
- Under Add Code to Pages, select All Pages • Load code once.
- Click Apply and publish your site.
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;
}
}
Install the Module in PrestaShop Back Office
- Log in to your PrestaShop Back Office.
- Go to Modules → Module Manager.
- Search for "BizDriver AI Assistant".
- Click Install.
Clear PrestaShop Cache
- Go to Advanced Parameters → Performance.
- Click the Clear cache button in the upper-right corner.
- Open your storefront to verify the chat widget is active!
PrestaShop Tips & Optimization
- DisplayHeader Hook: PrestaShop's
displayHeaderhook injects the script cleanest into the storefront<head>without modifying core template files. - Whitelisting / CSP: Ensure your hosting allows
script-src https://unpkg.com;andconnect-src https://app.bizdriver.ai;.
Shopify Theme Integration
- In your Shopify Admin, go to Online Store → Themes.
- Click the Actions / ... button next to your active theme → Edit code.
- Under the Layout folder, select theme.liquid.
- 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> - Click Save in the upper right.
Squarespace Code Injection
- In your Squarespace menu, go to Settings → Advanced → Code Injection (or Website → Pages → Custom Code → Code Injection).
- 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> - Click Save in the upper-left corner.