Installing the widget

One script tag. No build step, no package to install, no framework required.

Get your snippet

Open Embed & API Keys for your chatbot. The dashboard shows a snippet already filled in with your IDs — copy that rather than typing one out.

It looks like this:

<script>
  (function() {
    window.ChatbotConfig = {
      chatbotId: "YOUR_CHATBOT_ID",
      apiKey: "YOUR_WIDGET_KEY",
      apiUrl: "https://apimesh.byteleaps.tech/api"
    };
    var s = document.createElement('script');
    s.src = 'https://apimesh.byteleaps.tech/widget.js';
    s.async = true;
    document.head.appendChild(s);
  })();
</script>

The three required fields

All three must be present. If chatbotId or apiKey is missing, the widget writes an error to the browser console and does nothing at all.

Field	What it is
chatbotId	Identifies which chatbot to load
apiKey	Your widget key
apiUrl	Where the widget sends its requests

Full reference: Widget configuration.

Where to paste it

Just before the closing </body> tag, on every page where the chat bubble should appear.

Most site builders have a setting for exactly this — usually called footer code, custom code, or scripts. Adding it there puts it on every page at once, which is normally what you want.

Step-by-step for your platform:

• WordPress
• Shopify
• Webflow
• Wix and Squarespace
• React and Next.js
• Plain HTML

Checking it worked

1. Open your site in a browser
2. Look for the chat bubble in the bottom corner
3. Click it — the panel opens with your welcome message
4. Ask a question you know your chatbot can answer

If the bubble is not there, open your browser's developer console and read the errors. Troubleshooting covers each message.

Hard-refresh after installing

Browsers cache pages aggressively. If the bubble does not appear, reload with Ctrl+Shift+R (or Cmd+Shift+R on a Mac) before assuming something is broken.

Only on certain pages

The widget appears wherever the snippet is. To limit it, add the snippet to those templates only rather than to the site-wide footer.

Common choices: leave it off checkout and payment pages, off login screens, and off long-form legal pages where a floating bubble is a distraction.

It will not clash with your site's design

The widget renders in an isolated container. Your stylesheets cannot reach into it and restyle it, and its styles cannot leak out and affect your page. You do not need to add any CSS, defensive or otherwise.

Change how it looks from Appearance, not from your own stylesheet.

Performance

The script loads asynchronously, so it never blocks your page from rendering. The widget's own resources are only fetched when they are needed.

Your page loads at the same speed with the snippet as without it.

Removing the widget

Delete the snippet from your site. If you want it gone immediately from a site you no longer control, revoke the widget key instead — the widget stops working the moment you do, wherever it is installed.