> ## Documentation Index
> Fetch the complete documentation index at: https://botpress-charmenta-pr-655.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-655/Wg6j50QanTQLnHFW/webchat/interact/assets/missing-client-id.png?fit=max&auto=format&n=Wg6j50QanTQLnHFW&q=85&s=cf1142dfaaff1443ff5fcbca2aa73cde" 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-655/Wg6j50QanTQLnHFW/webchat/interact/assets/missing-client-id-dark.png?fit=max&auto=format&n=Wg6j50QanTQLnHFW&q=85&s=17bbf5a28f8a69faa04402251421fcc2" 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-655/Wg6j50QanTQLnHFW/webchat/interact/assets/invalid-client-id.png?fit=max&auto=format&n=Wg6j50QanTQLnHFW&q=85&s=5717594c0c49114e7f4bb5e4bf4f131c" 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-655/Wg6j50QanTQLnHFW/webchat/interact/assets/invalid-client-id-dark.png?fit=max&auto=format&n=Wg6j50QanTQLnHFW&q=85&s=e01861843e84e912465b62e9178169a7" 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-655/Wg6j50QanTQLnHFW/webchat/interact/assets/missing-api-url.png?fit=max&auto=format&n=Wg6j50QanTQLnHFW&q=85&s=0dbe052255c41c20893fb20f609ddaa1" 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-655/Wg6j50QanTQLnHFW/webchat/interact/assets/missing-api-url-dark.png?fit=max&auto=format&n=Wg6j50QanTQLnHFW&q=85&s=b5665e5c37829830101a56bf501f4322" 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-655/Wg6j50QanTQLnHFW/webchat/interact/assets/invalid-api-url.png?fit=max&auto=format&n=Wg6j50QanTQLnHFW&q=85&s=abe7d99f81840724949671d2c93f5f06" 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-655/Wg6j50QanTQLnHFW/webchat/interact/assets/invalid-api-url-dark.png?fit=max&auto=format&n=Wg6j50QanTQLnHFW&q=85&s=47ed1c07e46a7bd578e8ef5298e63b6d" 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-655/Wg6j50QanTQLnHFW/webchat/interact/assets/missing-bot-id.png?fit=max&auto=format&n=Wg6j50QanTQLnHFW&q=85&s=eba3f4a382d04fee6bd84684c9e51e44" 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-655/Wg6j50QanTQLnHFW/webchat/interact/assets/missing-bot-id-dark.png?fit=max&auto=format&n=Wg6j50QanTQLnHFW&q=85&s=002e6caea7d8b4cc642d3ecd0dd5fbdf" 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-655/Wg6j50QanTQLnHFW/webchat/interact/assets/missing-config-url.png?fit=max&auto=format&n=Wg6j50QanTQLnHFW&q=85&s=694f45ce94e28911c916ced36a4ba705" 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-655/Wg6j50QanTQLnHFW/webchat/interact/assets/missing-config-url-dark.png?fit=max&auto=format&n=Wg6j50QanTQLnHFW&q=85&s=34be7a45878c53f1fdb623c8f7717d26" 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-655/Wg6j50QanTQLnHFW/webchat/interact/assets/invalid-config-url.png?fit=max&auto=format&n=Wg6j50QanTQLnHFW&q=85&s=16c6795970e82535811734d1ecc2a2df" 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-655/Wg6j50QanTQLnHFW/webchat/interact/assets/invalid-config-url-dark.png?fit=max&auto=format&n=Wg6j50QanTQLnHFW&q=85&s=dfc3061568dadab91646c845b24e4e04" 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-655/Wg6j50QanTQLnHFW/webchat/interact/assets/invalid-config.png?fit=max&auto=format&n=Wg6j50QanTQLnHFW&q=85&s=307b8f8abe397993478c0ea5b8bd9269" 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-655/Wg6j50QanTQLnHFW/webchat/interact/assets/invalid-config-dark.png?fit=max&auto=format&n=Wg6j50QanTQLnHFW&q=85&s=beb639b2763e9721bc407819269b308b" 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-655/Wg6j50QanTQLnHFW/webchat/interact/assets/config-access-denied.png?fit=max&auto=format&n=Wg6j50QanTQLnHFW&q=85&s=7ecaa6d9e29b10fa45cb6095989b79ea" 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-655/Wg6j50QanTQLnHFW/webchat/interact/assets/config-access-denied-dark.png?fit=max&auto=format&n=Wg6j50QanTQLnHFW&q=85&s=9ce947a4878ce51faf1f9fc665174aac" 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-655/Wg6j50QanTQLnHFW/webchat/interact/assets/bot-is-blocked.png?fit=max&auto=format&n=Wg6j50QanTQLnHFW&q=85&s=4ba2bc009567f1b7cf48fe63644795cc" 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-655/Wg6j50QanTQLnHFW/webchat/interact/assets/bot-is-blocked-dark.png?fit=max&auto=format&n=Wg6j50QanTQLnHFW&q=85&s=a2c7ad88af8407a2d5dd10248e03edf2" 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-655/Wg6j50QanTQLnHFW/webchat/interact/assets/quota-exceeded.png?fit=max&auto=format&n=Wg6j50QanTQLnHFW&q=85&s=a2850cf3226e1de3925d8473cd2267dc" 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-655/Wg6j50QanTQLnHFW/webchat/interact/assets/quota-exceeded-dark.png?fit=max&auto=format&n=Wg6j50QanTQLnHFW&q=85&s=9715c78d2f216761856d471736dd45a4" 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-655/Wg6j50QanTQLnHFW/webchat/interact/assets/not-a-participant.png?fit=max&auto=format&n=Wg6j50QanTQLnHFW&q=85&s=8786b952d356bf8bf253edf17568e950" 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-655/Wg6j50QanTQLnHFW/webchat/interact/assets/not-a-participant-dark.png?fit=max&auto=format&n=Wg6j50QanTQLnHFW&q=85&s=3d47cae7962cc01b5a04d095e4f50d35" 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-655/Wg6j50QanTQLnHFW/webchat/interact/assets/invalid-message-content-type.png?fit=max&auto=format&n=Wg6j50QanTQLnHFW&q=85&s=e1dbe9f8f3f5ce7fabadaddd5b3e1c25" 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-655/Wg6j50QanTQLnHFW/webchat/interact/assets/invalid-message-content-type-dark.png?fit=max&auto=format&n=Wg6j50QanTQLnHFW&q=85&s=b112ec8e0dbe8a8505b3a38c715c4297" 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-655/Wg6j50QanTQLnHFW/webchat/interact/assets/network-error.png?fit=max&auto=format&n=Wg6j50QanTQLnHFW&q=85&s=5883d76bd20bd89c9e49ab6d56450cab" 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-655/Wg6j50QanTQLnHFW/webchat/interact/assets/network-error-dark.png?fit=max&auto=format&n=Wg6j50QanTQLnHFW&q=85&s=a298e3beff84b4dc805061a9dff09587" 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-655/Wg6j50QanTQLnHFW/webchat/interact/assets/sse-disconnected.png?fit=max&auto=format&n=Wg6j50QanTQLnHFW&q=85&s=fef8664ca18b8207d41d24a90b9a9861" 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-655/Wg6j50QanTQLnHFW/webchat/interact/assets/sse-disconnected-dark.png?fit=max&auto=format&n=Wg6j50QanTQLnHFW&q=85&s=8b352e286624466cebad5734c12c30a5" width="1440" height="662" data-path="webchat/interact/assets/sse-disconnected-dark.png" />
</Frame>

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