Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.insitechat.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Embed widget

Add your InsiteChat chatbot to any website with a single embed code. The widget adds a chat icon to the corner of your page — visitors click it to open a full chat interface. No plugins or developers required.

​
Getting started

1

Open your chatbot

Log in to InsiteChat and select the chatbot you want to deploy.
2

Copy your chatbot ID

Go to the Overview tab. Your unique Chatbot ID is displayed with a Copy button. You’ll need this for integrations and API calls.
3

Choose an embed method

Go to the Embed tab and choose from three options: Script tag (recommended), iFrame, or direct link.
4

Paste into your website

Follow the platform-specific instructions below.
5

Test

Visit your site, click the chat icon, and send a test message.
Your Chatbot ID is required for:
  • WordPress and Shopify plugins
  • API calls and developer integrations
  • Webhook configuration
  • Third-party platform setup

​
Embed options

​
Platform-specific instructions

1

Access themes

From your Shopify admin, go to Online Store > Themes.
2

Edit code

Find your current theme and click Actions > Edit code.
3

Open theme.liquid

In the Layout section, click on theme.liquid.
4

Add embed code

Scroll to the bottom and paste the embed code just before the closing </body> tag.
5

Save

Click Save. The chatbot appears on all pages of your store.
To add the chatbot to specific pages only, edit individual page templates instead of theme.liquid.
1

Open settings

Log in to Squarespace and click Settings in the main menu.
2

Code injection

Click Advanced, then Code Injection.
3

Add code

In the FOOTER section, paste the embed code.
4

Save

Click Save.
Code Injection is available on Squarespace Business plans and higher. Personal plans require an upgrade.
1

Open editor

Open your Wix Editor.
2

Access settings

Click Settings in the top menu.
3

Custom code

Go to Custom Code in the Advanced section.
4

Add code

Click + Add Custom Code and paste the embed code.
5

Configure

Set “Add Code to Pages” to All Pages and “Place Code in” to Body - end.
6

Apply

Click Apply.
1

Open project settings

Open your Webflow project and go to Project Settings (gear icon).
2

Custom code tab

Click on the Custom Code tab.
3

Add footer code

In the Footer Code section, paste the embed code.
4

Save and publish

Click Save Changes and publish your site.
You can also add the code to specific pages by using a Webflow Embed element and pasting the code there.
For any website where you can edit HTML:
1

Copy embed code

Copy the script embed code from the Embed tab.
2

Open HTML

Open your website’s HTML file in a text editor.
3

Paste code

Add the code just before the closing </body> tag.
4

Save and upload

Save the file and upload to your web server.
Full example:
<!DOCTYPE html>
<html>
<head>
    <title>My Website</title>
</head>
<body>
    <h1>Welcome to my website</h1>

    <!-- InsiteChat embed — paste before </body> -->
    <script>
      (function(){
        var d=document,s=d.createElement('iframe');
        s.src='https://insitechat.ai/embed/YOUR_CHATBOT_ID';
        s.style.cssText='position:fixed;bottom:0;right:0;width:420px;height:650px;border:none;z-index:9999;';
        s.allow='clipboard-write';
        d.body.appendChild(s);
      })();
    </script>
</body>
</html>

​
Verifying installation

1

Clear browser cache

Clear your cache or use Ctrl+Shift+R / Cmd+Shift+R for a hard refresh.
2

Open incognito window

Visit your website in an incognito/private browser window.
3

Locate chat icon

Look for the chat bubble icon in the bottom corner of the page.
4

Open and test

Click the icon to open the chatbot. Send a test message to verify it responds correctly.
5

Check customization

Verify that your brand color, logo, display name, and greeting message appear as configured in the Embed tab.

​
Troubleshooting

  • Verify the embed code is present in your page source (right-click > View Page Source, search for “insitechat”)
  • Check the browser console (F12) for JavaScript errors
  • Ensure your chatbot has been trained with at least one source
  • Confirm the chatbot is active (not deleted or disabled)
  • Try a different browser or device
  • Verify your chatbot has trained content (check Sources tab — at least one source should be “done”)
  • Check the Overview dashboard — training status should be “Ready”
  • Test in the Preview tab first to isolate whether the issue is with the chatbot or the embed
  • Check that you haven’t added the embed code multiple times
  • Verify you’re only using one embed method (script OR iframe, not both)
  • Search your page source for duplicate InsiteChat scripts
  • Go to the Embed tab and check the Widget Position setting (left/right)
  • Adjust Bottom distance and Side distance in the Chat Icon section
  • If using iFrame embed, adjust the CSS bottom, right/left values manually
  • Auto-open only triggers once per browser session (uses sessionStorage)
  • Check that auto-open is enabled in the Embed tab for the correct device (desktop vs mobile)
  • The delay must pass before the widget opens — check the configured delay value
  • Try clearing sessionStorage or opening a new incognito window

​
Widget features reference

All these features are configured in the Embed tab and work automatically once the widget is embedded:
FeatureDescription
Brand color & text colorCustom colors for header, bubbles, and buttons
Font size12–20px base font size
Chat icon size & positionS to 2XL, configurable distance from edges
Auto-openSeparate desktop/mobile toggles with delay
RTL modeRight-to-left layout for Arabic, Hebrew, etc.
PersonasPre-built or custom personality
Chat modesAI, Agent, or Hybrid
Localization14 customizable UI strings
Quick promptsUp to 5 starter questions before first message
Smart follow-upsAI-generated suggestion buttons after responses
Source citationsClickable source links below responses
Hide feedbackToggle off thumbs-up/down on bot messages
Lead captureCustom forms with configurable timing
Session timeoutAuto-expire conversations after inactivity
Conversation historyVisitors can resume past sessions
WatermarkCustomizable on Growth+ plans
See Widget Customization for detailed configuration instructions.