> ## Documentation Index
> Fetch the complete documentation index at: https://botpress-charmenta-pr-583.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-583/nqaL_ELiyzNh3Tk1/webchat/interact/assets/missing-client-id.png?fit=max&auto=format&n=nqaL_ELiyzNh3Tk1&q=85&s=dce1e83d9c0308d618c63064020a891b" 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-583/nqaL_ELiyzNh3Tk1/webchat/interact/assets/missing-client-id-dark.png?fit=max&auto=format&n=nqaL_ELiyzNh3Tk1&q=85&s=09c8b13069d0ab8283dd214794a6d1e6" 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-583/nqaL_ELiyzNh3Tk1/webchat/interact/assets/invalid-client-id.png?fit=max&auto=format&n=nqaL_ELiyzNh3Tk1&q=85&s=525cb0d2e8d96ca1d5529b51711958e2" 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-583/nqaL_ELiyzNh3Tk1/webchat/interact/assets/invalid-client-id-dark.png?fit=max&auto=format&n=nqaL_ELiyzNh3Tk1&q=85&s=01494994331dfb38188284e58ca3c150" 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-583/nqaL_ELiyzNh3Tk1/webchat/interact/assets/missing-api-url.png?fit=max&auto=format&n=nqaL_ELiyzNh3Tk1&q=85&s=c0ac2720245241475480a7b00f16694b" 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-583/nqaL_ELiyzNh3Tk1/webchat/interact/assets/missing-api-url-dark.png?fit=max&auto=format&n=nqaL_ELiyzNh3Tk1&q=85&s=5da1f1cbc6caab256fb35810cfbd31fb" 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-583/nqaL_ELiyzNh3Tk1/webchat/interact/assets/invalid-api-url.png?fit=max&auto=format&n=nqaL_ELiyzNh3Tk1&q=85&s=1b34418153b1a7cdc5affee992722273" 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-583/nqaL_ELiyzNh3Tk1/webchat/interact/assets/invalid-api-url-dark.png?fit=max&auto=format&n=nqaL_ELiyzNh3Tk1&q=85&s=8c1d369549bdada361c0baa7a6e0c17b" 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-583/nqaL_ELiyzNh3Tk1/webchat/interact/assets/missing-bot-id.png?fit=max&auto=format&n=nqaL_ELiyzNh3Tk1&q=85&s=ddf9d5aabf4e4be0f217100c965ba91a" 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-583/nqaL_ELiyzNh3Tk1/webchat/interact/assets/missing-bot-id-dark.png?fit=max&auto=format&n=nqaL_ELiyzNh3Tk1&q=85&s=268c3053c293351a97d28eb3e1b3ba54" 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-583/nqaL_ELiyzNh3Tk1/webchat/interact/assets/missing-config-url.png?fit=max&auto=format&n=nqaL_ELiyzNh3Tk1&q=85&s=aa4e0072834069386dcee81be56edee0" 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-583/nqaL_ELiyzNh3Tk1/webchat/interact/assets/missing-config-url-dark.png?fit=max&auto=format&n=nqaL_ELiyzNh3Tk1&q=85&s=914ce9fe4ed0f20289a9a3ab3d122147" 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-583/nqaL_ELiyzNh3Tk1/webchat/interact/assets/invalid-config-url.png?fit=max&auto=format&n=nqaL_ELiyzNh3Tk1&q=85&s=65ef9eed492fe417dcb5c6fbf6e352a6" 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-583/nqaL_ELiyzNh3Tk1/webchat/interact/assets/invalid-config-url-dark.png?fit=max&auto=format&n=nqaL_ELiyzNh3Tk1&q=85&s=d1ccc06e803541c80154a12e86531c70" 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-583/nqaL_ELiyzNh3Tk1/webchat/interact/assets/invalid-config.png?fit=max&auto=format&n=nqaL_ELiyzNh3Tk1&q=85&s=dbcb2cf42392ebc709f1ea290a74a51f" 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-583/nqaL_ELiyzNh3Tk1/webchat/interact/assets/invalid-config-dark.png?fit=max&auto=format&n=nqaL_ELiyzNh3Tk1&q=85&s=eef941a872adc479af7a88aeb017e9fa" 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-583/nqaL_ELiyzNh3Tk1/webchat/interact/assets/config-access-denied.png?fit=max&auto=format&n=nqaL_ELiyzNh3Tk1&q=85&s=0ff2fad68b9d66498ed1c5a7826c1c3f" 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-583/nqaL_ELiyzNh3Tk1/webchat/interact/assets/config-access-denied-dark.png?fit=max&auto=format&n=nqaL_ELiyzNh3Tk1&q=85&s=6bc3334d1243b7030d409a0580d39c47" 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-583/nqaL_ELiyzNh3Tk1/webchat/interact/assets/bot-is-blocked.png?fit=max&auto=format&n=nqaL_ELiyzNh3Tk1&q=85&s=8fb5cf20c21131c1765ab77c5d0f22be" 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-583/nqaL_ELiyzNh3Tk1/webchat/interact/assets/bot-is-blocked-dark.png?fit=max&auto=format&n=nqaL_ELiyzNh3Tk1&q=85&s=229a658341e97d90624245a489ddc855" 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-583/nqaL_ELiyzNh3Tk1/webchat/interact/assets/quota-exceeded.png?fit=max&auto=format&n=nqaL_ELiyzNh3Tk1&q=85&s=9127d27f21c86ec3afbab0a13423a600" 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-583/nqaL_ELiyzNh3Tk1/webchat/interact/assets/quota-exceeded-dark.png?fit=max&auto=format&n=nqaL_ELiyzNh3Tk1&q=85&s=71de11bbee060031120d1168201b8114" 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-583/nqaL_ELiyzNh3Tk1/webchat/interact/assets/not-a-participant.png?fit=max&auto=format&n=nqaL_ELiyzNh3Tk1&q=85&s=850c7d531d569953db00b7fbc7e51698" 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-583/nqaL_ELiyzNh3Tk1/webchat/interact/assets/not-a-participant-dark.png?fit=max&auto=format&n=nqaL_ELiyzNh3Tk1&q=85&s=3d7fe6846f5de0fc2a405b40a2605382" 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-583/nqaL_ELiyzNh3Tk1/webchat/interact/assets/invalid-message-content-type.png?fit=max&auto=format&n=nqaL_ELiyzNh3Tk1&q=85&s=82e0c658cb3da8ecf8bce3e08f0d0154" 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-583/nqaL_ELiyzNh3Tk1/webchat/interact/assets/invalid-message-content-type-dark.png?fit=max&auto=format&n=nqaL_ELiyzNh3Tk1&q=85&s=77db48de82656ace3cdb9d69caa5ac17" 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-583/nqaL_ELiyzNh3Tk1/webchat/interact/assets/network-error.png?fit=max&auto=format&n=nqaL_ELiyzNh3Tk1&q=85&s=073c27d41a9665249f0298f2089b20bf" 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-583/nqaL_ELiyzNh3Tk1/webchat/interact/assets/network-error-dark.png?fit=max&auto=format&n=nqaL_ELiyzNh3Tk1&q=85&s=dab2b0fdf8bfe37fbab8afc96f8ed85a" 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-583/nqaL_ELiyzNh3Tk1/webchat/interact/assets/sse-disconnected.png?fit=max&auto=format&n=nqaL_ELiyzNh3Tk1&q=85&s=9c1672fb8622732993ce956afecb4e71" 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-583/nqaL_ELiyzNh3Tk1/webchat/interact/assets/sse-disconnected-dark.png?fit=max&auto=format&n=nqaL_ELiyzNh3Tk1&q=85&s=3bc1995f0d4d221cc5559787c6256355" width="1440" height="662" data-path="webchat/interact/assets/sse-disconnected-dark.png" />
</Frame>

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