> ## Documentation Index
> Fetch the complete documentation index at: https://botpress.com/docs/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

![Missing client ID](https://mintcdn.com/botpress/q8S__MXzNBiXVmVj/webchat/interact/assets/missing-client-id.png?fit=max\&auto=format\&n=q8S__MXzNBiXVmVj\&q=85\&s=ad7c23ce34648197b7ca39dfb7275fe0)

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

### Invalid client ID

![Invalid client ID](https://mintcdn.com/botpress/q8S__MXzNBiXVmVj/webchat/interact/assets/invalid-client-id.png?fit=max\&auto=format\&n=q8S__MXzNBiXVmVj\&q=85\&s=6f9e965180cb70455e2d6b5468460ea2)

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

### Missing API URL

![Missing API URL](https://mintcdn.com/botpress/q8S__MXzNBiXVmVj/webchat/interact/assets/missing-api-url.png?fit=max\&auto=format\&n=q8S__MXzNBiXVmVj\&q=85\&s=f79e43894eb004d7aa125c603e471131)

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

### Invalid API URL

![Invalid API URL](https://mintcdn.com/botpress/q8S__MXzNBiXVmVj/webchat/interact/assets/invalid-api-url.png?fit=max\&auto=format\&n=q8S__MXzNBiXVmVj\&q=85\&s=3fe595950c8bb50ace62eef1571889ce)

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

### Missing bot ID

![Missing bot ID](https://mintcdn.com/botpress/q8S__MXzNBiXVmVj/webchat/interact/assets/missing-bot-id.png?fit=max\&auto=format\&n=q8S__MXzNBiXVmVj\&q=85\&s=2faaed89d6ecdd04bde6965d214cbfd4)

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

### Missing config URL

![Missing config URL](https://mintcdn.com/botpress/q8S__MXzNBiXVmVj/webchat/interact/assets/missing-config-url.png?fit=max\&auto=format\&n=q8S__MXzNBiXVmVj\&q=85\&s=093a232f96bf4898bb6039692530e3e9)

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

### Invalid config URL

![Invalid config URL](https://mintcdn.com/botpress/q8S__MXzNBiXVmVj/webchat/interact/assets/invalid-config-url.png?fit=max\&auto=format\&n=q8S__MXzNBiXVmVj\&q=85\&s=53edec9da90f078301a5906ce48314a9)

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

### Invalid config

![Invalid configuration](https://mintcdn.com/botpress/q8S__MXzNBiXVmVj/webchat/interact/assets/invalid-config.png?fit=max\&auto=format\&n=q8S__MXzNBiXVmVj\&q=85\&s=0decdf519f66c6cc5fa37b689563e001)

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

### Config access denied

![Config access denied](https://mintcdn.com/botpress/q8S__MXzNBiXVmVj/webchat/interact/assets/config-access-denied.png?fit=max\&auto=format\&n=q8S__MXzNBiXVmVj\&q=85\&s=60a02c2dee01aa6e71c5825560315849)

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

## Bot Errors

### Bot is blocked

![Bot is blocked](https://mintcdn.com/botpress/q8S__MXzNBiXVmVj/webchat/interact/assets/bot-is-blocked.png?fit=max\&auto=format\&n=q8S__MXzNBiXVmVj\&q=85\&s=8ef7e2f9181dffeba083c4fa404aebca)

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

### Quota exceeded

![Quota exceeded](https://mintcdn.com/botpress/q8S__MXzNBiXVmVj/webchat/interact/assets/quota-exceeded.png?fit=max\&auto=format\&n=q8S__MXzNBiXVmVj\&q=85\&s=da0dbc5de484e48989a37bbef9ef20c4)

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

### Not a participant

![Not a participant](https://mintcdn.com/botpress/q8S__MXzNBiXVmVj/webchat/interact/assets/not-a-participant.png?fit=max\&auto=format\&n=q8S__MXzNBiXVmVj\&q=85\&s=8ecd8e55830af770b525a41c5b3487e6)

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

### Invalid message content type

![Invalid message content type](https://mintcdn.com/botpress/q8S__MXzNBiXVmVj/webchat/interact/assets/invalid-message-content-type.png?fit=max\&auto=format\&n=q8S__MXzNBiXVmVj\&q=85\&s=5671e99c844201e4acf913c53ffdf1b3)

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

## Network Errors

### Network error

![Network error](https://mintcdn.com/botpress/q8S__MXzNBiXVmVj/webchat/interact/assets/network-error.png?fit=max\&auto=format\&n=q8S__MXzNBiXVmVj\&q=85\&s=1ad805273371283bac792e4a38194e26)

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

### SSE disconnected

![SSE disconnected](https://mintcdn.com/botpress/q8S__MXzNBiXVmVj/webchat/interact/assets/sse-disconnected.png?fit=max\&auto=format\&n=q8S__MXzNBiXVmVj\&q=85\&s=27d34da67560d890462f33455b49e37e)

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.