> ## Documentation Index
> Fetch the complete documentation index at: https://botpress-charmenta-pr-732.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Error handling

When Webchat encounters an error, it displays a dedicated error screen instead of the normal chat interface. Here's a breakdown of all possible error screens:

## Configuration Errors

### Missing client ID

<Frame>
  <img alt="Missing client ID" className="block dark:hidden" src="https://mintcdn.com/botpress-charmenta-pr-732/okwPrHqCmmL4sTOv/webchat/interact/assets/missing-client-id.png?fit=max&auto=format&n=okwPrHqCmmL4sTOv&q=85&s=ba0dd6279e118f4d2ed59d951922ec62" width="1440" height="662" data-path="webchat/interact/assets/missing-client-id.png" />

  <img alt="Missing client ID" className="hidden dark:block" src="https://mintcdn.com/botpress-charmenta-pr-732/okwPrHqCmmL4sTOv/webchat/interact/assets/missing-client-id-dark.png?fit=max&auto=format&n=okwPrHqCmmL4sTOv&q=85&s=320042f530fd426156eea9ee92285ae8" width="1440" height="662" data-path="webchat/interact/assets/missing-client-id-dark.png" />
</Frame>

* **Cause**: Client ID not provided during initialization
* **Solution**: Provide a valid client ID

### Invalid client ID

<Frame>
  <img alt="Invalid client ID" className="block dark:hidden" src="https://mintcdn.com/botpress-charmenta-pr-732/okwPrHqCmmL4sTOv/webchat/interact/assets/invalid-client-id.png?fit=max&auto=format&n=okwPrHqCmmL4sTOv&q=85&s=42a07c215fb5f0817b34e738a9de2361" width="1440" height="662" data-path="webchat/interact/assets/invalid-client-id.png" />

  <img alt="Invalid client ID" className="hidden dark:block" src="https://mintcdn.com/botpress-charmenta-pr-732/okwPrHqCmmL4sTOv/webchat/interact/assets/invalid-client-id-dark.png?fit=max&auto=format&n=okwPrHqCmmL4sTOv&q=85&s=357e5b7bfe9fed07c4c7796f9eb96959" width="1440" height="662" data-path="webchat/interact/assets/invalid-client-id-dark.png" />
</Frame>

* **Cause**: Provided Client ID isn't valid
* **Solution**: Use a valid Botpress Client ID

### Missing API URL

<Frame>
  <img alt="Missing API URL" className="block dark:hidden" src="https://mintcdn.com/botpress-charmenta-pr-732/okwPrHqCmmL4sTOv/webchat/interact/assets/missing-api-url.png?fit=max&auto=format&n=okwPrHqCmmL4sTOv&q=85&s=3149c5f0dc8739014be48bf3def45c3a" width="1440" height="662" data-path="webchat/interact/assets/missing-api-url.png" />

  <img alt="Missing API URL" className="hidden dark:block" src="https://mintcdn.com/botpress-charmenta-pr-732/okwPrHqCmmL4sTOv/webchat/interact/assets/missing-api-url-dark.png?fit=max&auto=format&n=okwPrHqCmmL4sTOv&q=85&s=7263aba30c514bcde64983e70a446fe7" width="1440" height="662" data-path="webchat/interact/assets/missing-api-url-dark.png" />
</Frame>

* **Cause**: API URL not provided during initialization
* **Solution**: Provide a valid API URL

### Invalid API URL

<Frame>
  <img alt="Invalid API URL" className="block dark:hidden" src="https://mintcdn.com/botpress-charmenta-pr-732/okwPrHqCmmL4sTOv/webchat/interact/assets/invalid-api-url.png?fit=max&auto=format&n=okwPrHqCmmL4sTOv&q=85&s=b7ac02c37fd40dffb358f20f550d4016" width="1440" height="662" data-path="webchat/interact/assets/invalid-api-url.png" />

  <img alt="Invalid API URL" className="hidden dark:block" src="https://mintcdn.com/botpress-charmenta-pr-732/okwPrHqCmmL4sTOv/webchat/interact/assets/invalid-api-url-dark.png?fit=max&auto=format&n=okwPrHqCmmL4sTOv&q=85&s=3b517571bbaec166ef48ef2769485c6b" width="1440" height="662" data-path="webchat/interact/assets/invalid-api-url-dark.png" />
</Frame>

* **Cause**: API URL format is incorrect
* **Solution**: Use HTTPS URL format

### Missing bot ID

<Frame>
  <img alt="Missing bot ID" className="block dark:hidden" src="https://mintcdn.com/botpress-charmenta-pr-732/okwPrHqCmmL4sTOv/webchat/interact/assets/missing-bot-id.png?fit=max&auto=format&n=okwPrHqCmmL4sTOv&q=85&s=5b15f93a06817c38b046170db15b1b02" width="1440" height="662" data-path="webchat/interact/assets/missing-bot-id.png" />

  <img alt="Missing bot ID" className="hidden dark:block" src="https://mintcdn.com/botpress-charmenta-pr-732/okwPrHqCmmL4sTOv/webchat/interact/assets/missing-bot-id-dark.png?fit=max&auto=format&n=okwPrHqCmmL4sTOv&q=85&s=68ba9c4b55a4b7f51024d67d30759246" width="1440" height="662" data-path="webchat/interact/assets/missing-bot-id-dark.png" />
</Frame>

* **Cause**: Bot ID not provided during initialization
* **Solution**: Provide a valid Bot ID

### Missing config URL

<Frame>
  <img alt="Missing config URL" className="block dark:hidden" src="https://mintcdn.com/botpress-charmenta-pr-732/okwPrHqCmmL4sTOv/webchat/interact/assets/missing-config-url.png?fit=max&auto=format&n=okwPrHqCmmL4sTOv&q=85&s=2edd482d0cc1b108d9266c2b74cd92d5" width="1440" height="662" data-path="webchat/interact/assets/missing-config-url.png" />

  <img alt="Missing config URL" className="hidden dark:block" src="https://mintcdn.com/botpress-charmenta-pr-732/okwPrHqCmmL4sTOv/webchat/interact/assets/missing-config-url-dark.png?fit=max&auto=format&n=okwPrHqCmmL4sTOv&q=85&s=8e63c982c349b2d439cf379fa4e52004" width="1440" height="662" data-path="webchat/interact/assets/missing-config-url-dark.png" />
</Frame>

* **Cause**: No configuration URL provided
* **Solution**: Provide a configuration URL

### Invalid config URL

<Frame>
  <img alt="Invalid config URL" className="block dark:hidden" src="https://mintcdn.com/botpress-charmenta-pr-732/okwPrHqCmmL4sTOv/webchat/interact/assets/invalid-config-url.png?fit=max&auto=format&n=okwPrHqCmmL4sTOv&q=85&s=adce1a63879a3e0d4dc5dfc9748b8b64" width="1440" height="662" data-path="webchat/interact/assets/invalid-config-url.png" />

  <img alt="Invalid config URL" className="hidden dark:block" src="https://mintcdn.com/botpress-charmenta-pr-732/okwPrHqCmmL4sTOv/webchat/interact/assets/invalid-config-url-dark.png?fit=max&auto=format&n=okwPrHqCmmL4sTOv&q=85&s=779b3edf48071839db6f3f4c5a856763" width="1440" height="662" data-path="webchat/interact/assets/invalid-config-url-dark.png" />
</Frame>

* **Cause**: Provided configuration URL is invalid
* **Solution**: Use a valid configuration URL

### Invalid config

<Frame>
  <img alt="Invalid configuration" className="block dark:hidden" src="https://mintcdn.com/botpress-charmenta-pr-732/okwPrHqCmmL4sTOv/webchat/interact/assets/invalid-config.png?fit=max&auto=format&n=okwPrHqCmmL4sTOv&q=85&s=c68b5203524629c96f161a4589ea550b" width="1440" height="662" data-path="webchat/interact/assets/invalid-config.png" />

  <img alt="Invalid configuration" className="hidden dark:block" src="https://mintcdn.com/botpress-charmenta-pr-732/okwPrHqCmmL4sTOv/webchat/interact/assets/invalid-config-dark.png?fit=max&auto=format&n=okwPrHqCmmL4sTOv&q=85&s=4abe1a459d53dd8954ddc86316d114a9" width="1440" height="662" data-path="webchat/interact/assets/invalid-config-dark.png" />
</Frame>

* **Cause**: Webchat configuration file is malformed
* **Solution**: Fix configuration file format

### Config access denied

<Frame>
  <img alt="Config access denied" className="block dark:hidden" src="https://mintcdn.com/botpress-charmenta-pr-732/okwPrHqCmmL4sTOv/webchat/interact/assets/config-access-denied.png?fit=max&auto=format&n=okwPrHqCmmL4sTOv&q=85&s=66c36b17dcf1adfef9049f3df470d3f5" width="1440" height="662" data-path="webchat/interact/assets/config-access-denied.png" />

  <img alt="Config access denied" className="hidden dark:block" src="https://mintcdn.com/botpress-charmenta-pr-732/okwPrHqCmmL4sTOv/webchat/interact/assets/config-access-denied-dark.png?fit=max&auto=format&n=okwPrHqCmmL4sTOv&q=85&s=7f660b21571929737b776890e1ee6765" width="1440" height="662" data-path="webchat/interact/assets/config-access-denied-dark.png" />
</Frame>

* **Cause**: Access to configuration file is restricted
* **Solution**: Check credentials and URL accessibility

## Bot Errors

### Bot is blocked

<Frame>
  <img alt="Bot is blocked" className="block dark:hidden" src="https://mintcdn.com/botpress-charmenta-pr-732/okwPrHqCmmL4sTOv/webchat/interact/assets/bot-is-blocked.png?fit=max&auto=format&n=okwPrHqCmmL4sTOv&q=85&s=94dc41c495a1a34f46765ff31b0a825e" width="1440" height="662" data-path="webchat/interact/assets/bot-is-blocked.png" />

  <img alt="Bot is blocked" className="hidden dark:block" src="https://mintcdn.com/botpress-charmenta-pr-732/okwPrHqCmmL4sTOv/webchat/interact/assets/bot-is-blocked-dark.png?fit=max&auto=format&n=okwPrHqCmmL4sTOv&q=85&s=3571ea51a85f88255909eb1e4cb5619a" width="1440" height="662" data-path="webchat/interact/assets/bot-is-blocked-dark.png" />
</Frame>

* **Cause**: Bot has been temporarily paused
* **Solution**: Check your bot's [status](/get-started/manage-your-agent/inspect)

### Quota exceeded

<Frame>
  <img alt="Quota exceeded" className="block dark:hidden" src="https://mintcdn.com/botpress-charmenta-pr-732/okwPrHqCmmL4sTOv/webchat/interact/assets/quota-exceeded.png?fit=max&auto=format&n=okwPrHqCmmL4sTOv&q=85&s=6706926025352215637cfc9e62f2c44c" width="1440" height="662" data-path="webchat/interact/assets/quota-exceeded.png" />

  <img alt="Quota exceeded" className="hidden dark:block" src="https://mintcdn.com/botpress-charmenta-pr-732/okwPrHqCmmL4sTOv/webchat/interact/assets/quota-exceeded-dark.png?fit=max&auto=format&n=okwPrHqCmmL4sTOv&q=85&s=818478084fef20bc61a97c73bd969f54" width="1440" height="662" data-path="webchat/interact/assets/quota-exceeded-dark.png" />
</Frame>

* **Cause**: Bot has reached usage limits
* **Solution**: Check usage quotas and limits in [Dashboard](/get-started/configure-your-workspace#manage-usage-quotas)

### Not a participant

<Frame>
  <img alt="Not a participant" className="block dark:hidden" src="https://mintcdn.com/botpress-charmenta-pr-732/okwPrHqCmmL4sTOv/webchat/interact/assets/not-a-participant.png?fit=max&auto=format&n=okwPrHqCmmL4sTOv&q=85&s=ad745f1b377418418677bcd8bd1cae17" width="1440" height="662" data-path="webchat/interact/assets/not-a-participant.png" />

  <img alt="Not a participant" className="hidden dark:block" src="https://mintcdn.com/botpress-charmenta-pr-732/okwPrHqCmmL4sTOv/webchat/interact/assets/not-a-participant-dark.png?fit=max&auto=format&n=okwPrHqCmmL4sTOv&q=85&s=47e0149544403b01bf25168716ac8463" width="1440" height="662" data-path="webchat/interact/assets/not-a-participant-dark.png" />
</Frame>

* **Cause**: User not authorized for conversation
* **Solution**: Clear browser storage and refresh

### Invalid message content type

<Frame>
  <img alt="Invalid message content type" className="block dark:hidden" src="https://mintcdn.com/botpress-charmenta-pr-732/okwPrHqCmmL4sTOv/webchat/interact/assets/invalid-message-content-type.png?fit=max&auto=format&n=okwPrHqCmmL4sTOv&q=85&s=eab9f36f25614802a567882c8a657934" width="1440" height="662" data-path="webchat/interact/assets/invalid-message-content-type.png" />

  <img alt="Invalid message content type" className="hidden dark:block" src="https://mintcdn.com/botpress-charmenta-pr-732/okwPrHqCmmL4sTOv/webchat/interact/assets/invalid-message-content-type-dark.png?fit=max&auto=format&n=okwPrHqCmmL4sTOv&q=85&s=428d7c03440be645e91d31b6bb4a879a" width="1440" height="662" data-path="webchat/interact/assets/invalid-message-content-type-dark.png" />
</Frame>

* **Cause**: Unable to process message format
* **Solution**
  * Check your bot's logs for any integration errors
  * Start a new conversation

## Network Errors

### Network error

<Frame>
  <img alt="Network error" className="block dark:hidden" src="https://mintcdn.com/botpress-charmenta-pr-732/okwPrHqCmmL4sTOv/webchat/interact/assets/network-error.png?fit=max&auto=format&n=okwPrHqCmmL4sTOv&q=85&s=dfd3a8b54e4630176e92807fd48ee6fe" width="1440" height="662" data-path="webchat/interact/assets/network-error.png" />

  <img alt="Network error" className="hidden dark:block" src="https://mintcdn.com/botpress-charmenta-pr-732/okwPrHqCmmL4sTOv/webchat/interact/assets/network-error-dark.png?fit=max&auto=format&n=okwPrHqCmmL4sTOv&q=85&s=fa4250a5453923570dd7aff6534e57ed" width="1440" height="662" data-path="webchat/interact/assets/network-error-dark.png" />
</Frame>

* **Cause**: General network connectivity problems
* **Solution**: Check internet connection

### SSE disconnected

<Frame>
  <img alt="SSE disconnected" className="block dark:hidden" src="https://mintcdn.com/botpress-charmenta-pr-732/okwPrHqCmmL4sTOv/webchat/interact/assets/sse-disconnected.png?fit=max&auto=format&n=okwPrHqCmmL4sTOv&q=85&s=b4279d9f642ac0ff34f2e85a00b651d3" width="1440" height="662" data-path="webchat/interact/assets/sse-disconnected.png" />

  <img alt="SSE disconnected" className="hidden dark:block" src="https://mintcdn.com/botpress-charmenta-pr-732/okwPrHqCmmL4sTOv/webchat/interact/assets/sse-disconnected-dark.png?fit=max&auto=format&n=okwPrHqCmmL4sTOv&q=85&s=122513f56186a327bfb3f9836be38bb9" width="1440" height="662" data-path="webchat/interact/assets/sse-disconnected-dark.png" />
</Frame>

* **Cause**: Server-Sent Events connection lost
* **Solution**: Refresh the page
