> ## Documentation Index
> Fetch the complete documentation index at: https://botpress-charmenta-pr-700.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-700/MARvjyf1O9JTt73h/webchat/interact/assets/missing-client-id.png?fit=max&auto=format&n=MARvjyf1O9JTt73h&q=85&s=3244ea4744f4ef8e615bf74e77dc68a8" 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-700/MARvjyf1O9JTt73h/webchat/interact/assets/missing-client-id-dark.png?fit=max&auto=format&n=MARvjyf1O9JTt73h&q=85&s=9ca37f7749ec0dba192b7fd108d0e0bc" 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-700/MARvjyf1O9JTt73h/webchat/interact/assets/invalid-client-id.png?fit=max&auto=format&n=MARvjyf1O9JTt73h&q=85&s=48d8bf7abaf60062de85246b82c9f8f1" 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-700/MARvjyf1O9JTt73h/webchat/interact/assets/invalid-client-id-dark.png?fit=max&auto=format&n=MARvjyf1O9JTt73h&q=85&s=276aa22b9211ad258b6d333ceddd1db1" 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-700/MARvjyf1O9JTt73h/webchat/interact/assets/missing-api-url.png?fit=max&auto=format&n=MARvjyf1O9JTt73h&q=85&s=52d75b5ca05fe1a76151c1168be0bd23" 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-700/MARvjyf1O9JTt73h/webchat/interact/assets/missing-api-url-dark.png?fit=max&auto=format&n=MARvjyf1O9JTt73h&q=85&s=9dd4d4427ca42081da30eb3b3c5b6f4c" 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-700/MARvjyf1O9JTt73h/webchat/interact/assets/invalid-api-url.png?fit=max&auto=format&n=MARvjyf1O9JTt73h&q=85&s=8c048d225179036be2946761160bd56f" 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-700/MARvjyf1O9JTt73h/webchat/interact/assets/invalid-api-url-dark.png?fit=max&auto=format&n=MARvjyf1O9JTt73h&q=85&s=8b0baec70727ba74baf3c1e835512e2c" 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-700/MARvjyf1O9JTt73h/webchat/interact/assets/missing-bot-id.png?fit=max&auto=format&n=MARvjyf1O9JTt73h&q=85&s=dcff6560d90f7989a95ac0428fb89830" 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-700/MARvjyf1O9JTt73h/webchat/interact/assets/missing-bot-id-dark.png?fit=max&auto=format&n=MARvjyf1O9JTt73h&q=85&s=dbe26f2e7cbcaeaaa325b879a4120bb6" 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-700/MARvjyf1O9JTt73h/webchat/interact/assets/missing-config-url.png?fit=max&auto=format&n=MARvjyf1O9JTt73h&q=85&s=215990881ce4e7c6f7e2403e80a47da3" 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-700/MARvjyf1O9JTt73h/webchat/interact/assets/missing-config-url-dark.png?fit=max&auto=format&n=MARvjyf1O9JTt73h&q=85&s=607d94fc148ec8c244b3e59f58b6bf67" 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-700/MARvjyf1O9JTt73h/webchat/interact/assets/invalid-config-url.png?fit=max&auto=format&n=MARvjyf1O9JTt73h&q=85&s=40d54f0742e8ae7e3b97aec0529419ec" 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-700/MARvjyf1O9JTt73h/webchat/interact/assets/invalid-config-url-dark.png?fit=max&auto=format&n=MARvjyf1O9JTt73h&q=85&s=b7c6dab8c84f4a912e8b00522de8fd9b" 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-700/MARvjyf1O9JTt73h/webchat/interact/assets/invalid-config.png?fit=max&auto=format&n=MARvjyf1O9JTt73h&q=85&s=af39654bb74232c4eb22ca51e8334037" 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-700/MARvjyf1O9JTt73h/webchat/interact/assets/invalid-config-dark.png?fit=max&auto=format&n=MARvjyf1O9JTt73h&q=85&s=eed487e12f2645806606c38d9716d258" 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-700/MARvjyf1O9JTt73h/webchat/interact/assets/config-access-denied.png?fit=max&auto=format&n=MARvjyf1O9JTt73h&q=85&s=86f4c93be99dcd9ab852b7ab285d7934" 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-700/MARvjyf1O9JTt73h/webchat/interact/assets/config-access-denied-dark.png?fit=max&auto=format&n=MARvjyf1O9JTt73h&q=85&s=26a3d0e6aec99f82ac33e3d2ac88606b" 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-700/MARvjyf1O9JTt73h/webchat/interact/assets/bot-is-blocked.png?fit=max&auto=format&n=MARvjyf1O9JTt73h&q=85&s=eed4382775775194c0cf499564ac865a" 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-700/MARvjyf1O9JTt73h/webchat/interact/assets/bot-is-blocked-dark.png?fit=max&auto=format&n=MARvjyf1O9JTt73h&q=85&s=c3bf7f68d66f810733b759a04cd9a64b" 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-700/MARvjyf1O9JTt73h/webchat/interact/assets/quota-exceeded.png?fit=max&auto=format&n=MARvjyf1O9JTt73h&q=85&s=a76cb6c80b8961414fa6deb4f9fba230" 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-700/MARvjyf1O9JTt73h/webchat/interact/assets/quota-exceeded-dark.png?fit=max&auto=format&n=MARvjyf1O9JTt73h&q=85&s=48902b1ab1219f3281761bc0b32f46dd" 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-700/MARvjyf1O9JTt73h/webchat/interact/assets/not-a-participant.png?fit=max&auto=format&n=MARvjyf1O9JTt73h&q=85&s=07fbdb16814e19f0532e8ff24da9e8a1" 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-700/MARvjyf1O9JTt73h/webchat/interact/assets/not-a-participant-dark.png?fit=max&auto=format&n=MARvjyf1O9JTt73h&q=85&s=879ef7820b3ac73ac8df55823190ca67" 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-700/MARvjyf1O9JTt73h/webchat/interact/assets/invalid-message-content-type.png?fit=max&auto=format&n=MARvjyf1O9JTt73h&q=85&s=b5b3ff9d5cf94e5e90353cbf107b69f1" 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-700/MARvjyf1O9JTt73h/webchat/interact/assets/invalid-message-content-type-dark.png?fit=max&auto=format&n=MARvjyf1O9JTt73h&q=85&s=1a5e3615fb59ae6c1533bf92645da6cc" 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-700/MARvjyf1O9JTt73h/webchat/interact/assets/network-error.png?fit=max&auto=format&n=MARvjyf1O9JTt73h&q=85&s=5bc2e6dfc882a44aa53eec3108379083" 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-700/MARvjyf1O9JTt73h/webchat/interact/assets/network-error-dark.png?fit=max&auto=format&n=MARvjyf1O9JTt73h&q=85&s=d37ebca50fa57007e93c97661817943c" 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-700/MARvjyf1O9JTt73h/webchat/interact/assets/sse-disconnected.png?fit=max&auto=format&n=MARvjyf1O9JTt73h&q=85&s=9e7ddd2ff3d84e5d76972efe65ea3124" 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-700/MARvjyf1O9JTt73h/webchat/interact/assets/sse-disconnected-dark.png?fit=max&auto=format&n=MARvjyf1O9JTt73h&q=85&s=43d9512fcf96bdd9f345112ee0b9bfa7" width="1440" height="662" data-path="webchat/interact/assets/sse-disconnected-dark.png" />
</Frame>

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