Launch Chat Widget

Use this guide to deploy the Octocom chat widget on your website (if you’re using Shopify, follow this guide instead). You’ll insert a script tag and configure domain settings in your Octocom dashboard.

1. Add the Script Tag

To embed the chat widget, insert the following script tag into your website’s HTML:

<script src="https://www.octocom.ai/chatbot/bundle.js" async></script>

You can include this:

  • Directly in your website’s HTML (recommended), or

  • Via a tag manager such as Google Tag Manager (GTM)

⚠️ Note: If the chat widget is added via Google Tag Manager, it may be blocked by browser ad blockers and not appear for some users. To ensure the widget loads reliably, we recommend adding the script directly into your website’s HTML.

2. Whitelist Your Domain

The widget will only appear on domains that you explicitly allow. You can whitelist domains either via the Octocom dashboard or by contacting your account manager.

Configure in Dashboard

  1. Navigate to:

    Settings → Channels → Web Chat → Deployment

  2. In the Deployment tab:

    • Add your domain (e.g., example.com)

    • Enable deployment using the toggle

    • Click Save

  3. Once saved, the widget will become active for visitors on the specified domain.

🛠️ Tip: You can restrict deployment to specific pages (e.g., /faq, /contact) if needed.

Octocom web chat settings

3. Optional: Time-Based Activation

You can configure the chat widget to appear only during specific hours (e.g., business hours).

This feature is currently managed manually. To enable it:

  • Contact your account manager to configure operating hours.

Last updated