Integrations

Install HoverBot on your store

Pick your platform. Plugins for WooCommerce, Magento and PrestaShop, and a few lines of code for everything else.

Before you start

  • A HoverBot chatbot. Its Chatbot ID and Widget Key are in the HoverBot dashboard under your chatbot's Embed settings. The WooCommerce plugin can create them for you.
  • Your store's domain in the chatbot's Allowed Domains, or the chat stays hidden.
  • Replace YOUR_CHATBOT_ID and YOUR_WIDGET_KEY in any code below with your own values.

WooCommerce / WordPress

Plugin

Download plugin (2.0.0)

Connect in one step. The plugin creates your chatbot and allows your store domain for you.

  1. In WordPress admin go to Plugins → Add New → Upload Plugin, choose the zip, then Install and Activate.
  2. Open WooCommerce → HoverBot Chat (Settings → HoverBot Chat without WooCommerce).
  3. New to HoverBot: fill in the form and click Create account and connect. Already a customer: paste your Chatbot ID and Widget Key.
  4. Visit your store. The chat appears in the corner of every page.

Shopify

App embed

The HoverBot Chat app for the Shopify App Store is being prepared. Until it is listed, add the code to your theme in two minutes.

  1. In Shopify admin go to Online Store → Themes → ⋯ → Edit code.
  2. Open layout/theme.liquid and paste the code just before </body>. Save.
  3. In HoverBot, add yourstore.myshopify.com and your custom domain to the chatbot's Allowed Domains.
<script>window.HOVERBOT_CONFIG = { chatbotId: "YOUR_CHATBOT_ID", apiKey: "YOUR_WIDGET_KEY" };</script>
<script src="https://cdn.hoverbot.ai/widget.js" async></script>

Magento 2 / Adobe Commerce

Module

Download module (1.0.0)

Configure per store view. Includes the CSP allowlist, so strict checkout pages keep working.

  1. Unzip into app/code/HoverBot/Chat on your server.
  2. Run bin/magento module:enable HoverBot_Chat, then bin/magento setup:upgrade and bin/magento cache:flush.
  3. Go to Stores → Configuration → HoverBot → HoverBot Chat, paste your Chatbot ID and Widget Key, set Enable to Yes.

PrestaShop 1.7, 8 and 9

Module

Download module (1.0.0)

Upload, configure, done. Optionally hide the chat on cart and checkout.

  1. Go to Modules → Module Manager → Upload a module and choose the zip.
  2. Click Configure on HoverBot Chat.
  3. Paste your Chatbot ID and Widget Key and Save.

BigCommerce

Paste code

Uses Script Manager. No theme editing.

  1. Go to Storefront → Script Manager → Create a Script.
  2. Placement: Footer. Location: All pages. Category: Essential. Type: Script.
  3. Paste the code and Save. Add your store domains to the chatbot's Allowed Domains.
<script>window.HOVERBOT_CONFIG = { chatbotId: "YOUR_CHATBOT_ID", apiKey: "YOUR_WIDGET_KEY" };</script>
<script src="https://cdn.hoverbot.ai/widget.js" async></script>

Wix

Paste code

Needs a premium plan with a connected domain.

  1. Go to Settings → Custom Code → Add Custom Code.
  2. Paste the code below. Apply to All pages, load once, place in Body - end.
<script>window.HOVERBOT_CONFIG = { chatbotId: "YOUR_CHATBOT_ID", apiKey: "YOUR_WIDGET_KEY" };</script>
<script src="https://cdn.hoverbot.ai/widget.js" async onload="document.readyState==='complete'&&!window.hoverBotWidget&&(window.hoverBotWidget=HoverBotWidget.init(window.HOVERBOT_CONFIG))"></script>

Squarespace

Paste code

Uses Code Injection, available on Core plans and above.

  1. Go to Settings → Advanced → Code Injection.
  2. Paste the code into Footer and Save.
<script>window.HOVERBOT_CONFIG = { chatbotId: "YOUR_CHATBOT_ID", apiKey: "YOUR_WIDGET_KEY" };</script>
<script src="https://cdn.hoverbot.ai/widget.js" async></script>

Webflow

Paste code

Site-wide footer code.

  1. Go to Site settings → Custom code.
  2. Paste the code into Footer code, Save, then Publish.
<script>window.HOVERBOT_CONFIG = { chatbotId: "YOUR_CHATBOT_ID", apiKey: "YOUR_WIDGET_KEY" };</script>
<script src="https://cdn.hoverbot.ai/widget.js" async></script>

Google Tag Manager

Paste code

For any other site that already runs GTM.

  1. Create a tag of type Custom HTML.
  2. Paste the code below, trigger it on All Pages, and publish the container.
<script>window.HOVERBOT_CONFIG = { chatbotId: "YOUR_CHATBOT_ID", apiKey: "YOUR_WIDGET_KEY" };</script>
<script src="https://cdn.hoverbot.ai/widget.js" async onload="document.readyState==='complete'&&!window.hoverBotWidget&&(window.hoverBotWidget=HoverBotWidget.init(window.HOVERBOT_CONFIG))"></script>

Chat not showing?

  • Check the store domain is in Allowed Domains, including any port and both www and non-www.
  • Clear your caching plugin or CDN cache once after installing.
  • In the browser console, run window.hoverBotWidget.getState(). isChatbotAvailable: true means the ID, key and domain are all correct.
  • Still stuck? Contact us.

More detail for WordPress and Shopify: WordPress & Shopify Embed Guide.