> ## Documentation Index
> Fetch the complete documentation index at: https://docs.typewise.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Chat widget

> No visitor activity from your website chat

**Alert**: "Chat widget not active on your website"

**Impact**: Customers can't reach you through website chat.

## Quick diagnosis

| Symptom                           | Likely cause                                         | Fix                                                  |
| --------------------------------- | ---------------------------------------------------- | ---------------------------------------------------- |
| Widget doesn't appear             | Script removed or not installed                      | [Install the script](#install-the-script)            |
| Widget missing, no console errors | Script loaded via tag manager, blocked by ad blocker | Move to [direct HTML injection](#install-the-script) |
| Widget appears but no messages    | Low traffic period                                   | May be normal. Check your analytics.                 |
| Console shows errors              | Script blocked or CSP issue                          | [Check for blockers](#check-for-blockers)            |

## Install the script

<Steps>
  <Step title="Open Installation">
    Go to **Behaviour > Channels > Chat > Installation**.
  </Step>

  <Step title="Copy script">
    Copy the widget script.
  </Step>

  <Step title="Add to HTML">
    Add it directly to your website's HTML before `</body>`.
  </Step>

  <Step title="Deploy">
    Deploy your changes.
  </Step>
</Steps>

<Warning>
  Always add the script directly to your HTML source code. Do not use tag managers such as Google Tag Manager, Adobe Launch, Tealium, or Segment to inject the script. Ad blockers and privacy extensions routinely block tag manager requests, which silently prevents the widget from loading for affected visitors.
</Warning>

**Verify installation:**

<Steps>
  <Step title="View source">
    View your website's page source (right-click > View Page Source).
  </Step>

  <Step title="Search for script">
    Search for "typewise".
  </Step>

  <Step title="Confirm match">
    Confirm the script matches what's in your settings.
  </Step>
</Steps>

## Check for blockers

Open your browser's developer tools (F12) and check:

**Elements tab**: Look for the Typewise iframe

**Console tab**: Look for errors mentioning:

* `Content-Security-Policy` → [Configure your CSP](/guides/channels/content-security-policy) to allow Typewise domains
* `blocked` or `refused` → Check firewall or proxy settings
* `404` or `failed to load` → Script URL may be wrong

**Common blockers:**

* Tag managers (Google Tag Manager, Adobe Launch, Tealium, Segment): ad blockers block tag manager requests, preventing any scripts they inject from loading. Move the script to [direct HTML injection](#install-the-script) instead.
* Ad blockers (test in incognito mode)
* Corporate firewalls
* Strict CSP headers

## Test it

<Steps>
  <Step title="Open website">
    Open your website in a private/incognito window.
  </Step>

  <Step title="Open chat">Click the chat icon.</Step>
  <Step title="Send message">Send a test message.</Step>
  <Step title="Check inbox">Check your Typewise inbox.</Step>
</Steps>

The alert clears when the next visitor sends a message.

<Note>
  Typewise learns your traffic patterns. Low-traffic sites have longer detection
  windows. Weekend silence on a B2B site is normal. The alert clears when Monday
  traffic resumes.
</Note>