Chat Widget

Launch Chat Widget

Use this guide to deploy the Octocom chat widget on your website. You’ll insert a script tag and configure domain settings in your Octocom dashboard.

On Shopify?

If the storefront is hosted by Shopify, skip the script tag and use the Shopify Chat Widget Tutorial — the app embed does the same job with no code.

Use this guide instead for a headless or custom storefront, even when Shopify powers the checkout or order data behind it. The Shopify theme editor has no effect on pages Shopify doesn't render. If you run both — a custom site plus a Shopify storefront — set up each one with its own method.

1. Add the Script Tag

Open the Octocom dashboard and select your organization and business. Go to Settings -> Web Chat -> Deployment and choose Copy script under Install on your website. The script already contains your organization ID; you do not need to look it up separately.

Paste that script into your website’s HTML. It looks like this (replace the placeholder with the ID from your copied script):

<script
  id="octocom-script"
  data-organization-id="YOUR_ORGANIZATION_ID"
  src="https://www.octocom.ai/chatbot/bundle.js"
  async
></script>

Keep both id="octocom-script" and data-organization-id. The organization ID is public installation configuration, not a secret or an API credential. It makes the loader select only your organization's configurations, and both widget versions verify the returned organization before displaying content or running custom JavaScript. A wrong ID leaves the widget unloaded instead of selecting another organization.

Domain and page rules still choose the matching chat within your organization. To select a particular chat directly, turn on Use only this web chat before copying. That adds data-config-id and bypasses domain and page selection for that script.

If a plugin installs your script, use a version that includes your organization ID, or replace its script with the one copied from Web Chat settings.

Installed the widget before 3 November 2026?

Older scripts have no data-organization-id. You don't need to change anything: they keep loading your chat on every domain where it was live on 3 November 2026, and no other Octocom organization can take those domains over.

For a new domain, install the script from Settings -> Web Chat -> Deployment instead of the older one. You can also switch an existing site to it whenever convenient: it works immediately and your deployment rules stay the same.

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.

🍪 Cookie consent: the widget sets no cookies and stores nothing in the visitor's browser until they open the chat, so it does not need to be gated behind a consent banner on the standard reading — you can safely load it directly. Details, the full storage breakdown, and a consent-gated loading recipe (if your legal team prefers it) are in Browser Storage & Consent.

2. Whitelist Your Domain

With the default organization-pinned script, domain and page rules determine where the widget appears. Add allowed domains in the Octocom dashboard or contact your account manager. A script with data-config-id selects that chat directly and does not apply these rules.

Configure in Dashboard

  1. Go to Octocom Dashboard

  2. Navigate to:

    Settings -> Web Chat -> Deployment

  3. In the Deployment tab:

    • Add your domain (e.g., example.com)
    • Enable deployment using the toggle
    • Click Save
  4. 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.

Each hostname needs its own entry

Domains are matched by exact hostname, so every hostname you want the widget on has to be listed separately:

  • example.com and us.example.com are different hostnames — list both.
  • www.example.com and example.com are treated as the same, so you only need one of them.
  • Locale paths on one hostname (example.com/us/, example.com/nl/) are all covered by that single entry.

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.

On this page