> ## Documentation Index
> Fetch the complete documentation index at: https://botpress-charmenta-pr-716.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-716/5V9W7kfsWc1Tu6jp/webchat/interact/assets/missing-client-id.png?fit=max&auto=format&n=5V9W7kfsWc1Tu6jp&q=85&s=9dbb64d1dff3ef38464989d6a4792a73" 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-716/5V9W7kfsWc1Tu6jp/webchat/interact/assets/missing-client-id-dark.png?fit=max&auto=format&n=5V9W7kfsWc1Tu6jp&q=85&s=0ad808ee0226905d8173d6fe992666a2" 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-716/5V9W7kfsWc1Tu6jp/webchat/interact/assets/invalid-client-id.png?fit=max&auto=format&n=5V9W7kfsWc1Tu6jp&q=85&s=2b7ff4e332e9d6c39f7f67d5c014ddc4" 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-716/5V9W7kfsWc1Tu6jp/webchat/interact/assets/invalid-client-id-dark.png?fit=max&auto=format&n=5V9W7kfsWc1Tu6jp&q=85&s=257c1961542ec827d8b39b9ae168fa9a" 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-716/5V9W7kfsWc1Tu6jp/webchat/interact/assets/missing-api-url.png?fit=max&auto=format&n=5V9W7kfsWc1Tu6jp&q=85&s=68c4f3c46791758459961835765e7ccf" 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-716/5V9W7kfsWc1Tu6jp/webchat/interact/assets/missing-api-url-dark.png?fit=max&auto=format&n=5V9W7kfsWc1Tu6jp&q=85&s=dc5a7fb3ef1220ef1d9c3dfa2a014882" 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-716/5V9W7kfsWc1Tu6jp/webchat/interact/assets/invalid-api-url.png?fit=max&auto=format&n=5V9W7kfsWc1Tu6jp&q=85&s=8d1e00d09b845816835b13958e64ed26" 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-716/5V9W7kfsWc1Tu6jp/webchat/interact/assets/invalid-api-url-dark.png?fit=max&auto=format&n=5V9W7kfsWc1Tu6jp&q=85&s=e0f4751236f2337cac264f81ecaa481f" 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-716/5V9W7kfsWc1Tu6jp/webchat/interact/assets/missing-bot-id.png?fit=max&auto=format&n=5V9W7kfsWc1Tu6jp&q=85&s=a2e528a74dd61c479cd035852f1c7a2e" 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-716/5V9W7kfsWc1Tu6jp/webchat/interact/assets/missing-bot-id-dark.png?fit=max&auto=format&n=5V9W7kfsWc1Tu6jp&q=85&s=5d447cca3bb49a92bd7aba9916d7bf6c" 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-716/5V9W7kfsWc1Tu6jp/webchat/interact/assets/missing-config-url.png?fit=max&auto=format&n=5V9W7kfsWc1Tu6jp&q=85&s=39a857c64e885a30a0b33667b6a983bf" 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-716/5V9W7kfsWc1Tu6jp/webchat/interact/assets/missing-config-url-dark.png?fit=max&auto=format&n=5V9W7kfsWc1Tu6jp&q=85&s=3f7e823bfd78972f82d5814788f2dca8" 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-716/5V9W7kfsWc1Tu6jp/webchat/interact/assets/invalid-config-url.png?fit=max&auto=format&n=5V9W7kfsWc1Tu6jp&q=85&s=3f0f1a611de150abfe81a369db4293f8" 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-716/5V9W7kfsWc1Tu6jp/webchat/interact/assets/invalid-config-url-dark.png?fit=max&auto=format&n=5V9W7kfsWc1Tu6jp&q=85&s=b39e41363662cfca972a5b8c4cc2a253" 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-716/5V9W7kfsWc1Tu6jp/webchat/interact/assets/invalid-config.png?fit=max&auto=format&n=5V9W7kfsWc1Tu6jp&q=85&s=b7c655951144405265e10aee00566b91" 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-716/5V9W7kfsWc1Tu6jp/webchat/interact/assets/invalid-config-dark.png?fit=max&auto=format&n=5V9W7kfsWc1Tu6jp&q=85&s=f88584ad97667c0a3ac5fb728ccb868f" 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-716/5V9W7kfsWc1Tu6jp/webchat/interact/assets/config-access-denied.png?fit=max&auto=format&n=5V9W7kfsWc1Tu6jp&q=85&s=e9bdb22fa5a1ee4b54524219563880ce" 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-716/5V9W7kfsWc1Tu6jp/webchat/interact/assets/config-access-denied-dark.png?fit=max&auto=format&n=5V9W7kfsWc1Tu6jp&q=85&s=283c84e09ccb4c61d1686568e4b923c4" 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-716/5V9W7kfsWc1Tu6jp/webchat/interact/assets/bot-is-blocked.png?fit=max&auto=format&n=5V9W7kfsWc1Tu6jp&q=85&s=933968b6da5675814f547db661f17725" 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-716/5V9W7kfsWc1Tu6jp/webchat/interact/assets/bot-is-blocked-dark.png?fit=max&auto=format&n=5V9W7kfsWc1Tu6jp&q=85&s=cdbd5d942236f55e134d3454dbc623ed" 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-716/5V9W7kfsWc1Tu6jp/webchat/interact/assets/quota-exceeded.png?fit=max&auto=format&n=5V9W7kfsWc1Tu6jp&q=85&s=64fc0e09b0130aee4af32a3adaf159a9" 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-716/5V9W7kfsWc1Tu6jp/webchat/interact/assets/quota-exceeded-dark.png?fit=max&auto=format&n=5V9W7kfsWc1Tu6jp&q=85&s=27aad7513885680adf6414edf0b934c0" 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-716/5V9W7kfsWc1Tu6jp/webchat/interact/assets/not-a-participant.png?fit=max&auto=format&n=5V9W7kfsWc1Tu6jp&q=85&s=23affde429710466966af3047cf36013" 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-716/5V9W7kfsWc1Tu6jp/webchat/interact/assets/not-a-participant-dark.png?fit=max&auto=format&n=5V9W7kfsWc1Tu6jp&q=85&s=afe5166ad63a7d92946d7739e014a872" 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-716/5V9W7kfsWc1Tu6jp/webchat/interact/assets/invalid-message-content-type.png?fit=max&auto=format&n=5V9W7kfsWc1Tu6jp&q=85&s=0ff24e2390ec5464c5e2dfdb3ed60510" 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-716/5V9W7kfsWc1Tu6jp/webchat/interact/assets/invalid-message-content-type-dark.png?fit=max&auto=format&n=5V9W7kfsWc1Tu6jp&q=85&s=52ec3a2e16c367d254cc6667814f12af" 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-716/5V9W7kfsWc1Tu6jp/webchat/interact/assets/network-error.png?fit=max&auto=format&n=5V9W7kfsWc1Tu6jp&q=85&s=56e8899d9cacb0e051c1b93dec6c1e87" 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-716/5V9W7kfsWc1Tu6jp/webchat/interact/assets/network-error-dark.png?fit=max&auto=format&n=5V9W7kfsWc1Tu6jp&q=85&s=81e33ca01658d6e404d7450eea18ebd8" 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-716/5V9W7kfsWc1Tu6jp/webchat/interact/assets/sse-disconnected.png?fit=max&auto=format&n=5V9W7kfsWc1Tu6jp&q=85&s=5d54ae24ff6d00d5d38c91a9bdb36034" 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-716/5V9W7kfsWc1Tu6jp/webchat/interact/assets/sse-disconnected-dark.png?fit=max&auto=format&n=5V9W7kfsWc1Tu6jp&q=85&s=c095e7bfdfcd9c82a393ce8248400ca9" width="1440" height="662" data-path="webchat/interact/assets/sse-disconnected-dark.png" />
</Frame>

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