> ## Documentation Index
> Fetch the complete documentation index at: https://botpress-charmenta-pr-705.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-705/LSGDIh-dJkCRUXNL/webchat/interact/assets/missing-client-id.png?fit=max&auto=format&n=LSGDIh-dJkCRUXNL&q=85&s=46123fa7a389ed2e91555f2654fe0255" 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-705/LSGDIh-dJkCRUXNL/webchat/interact/assets/missing-client-id-dark.png?fit=max&auto=format&n=LSGDIh-dJkCRUXNL&q=85&s=19bd7dce871007645191528f478a775d" 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-705/LSGDIh-dJkCRUXNL/webchat/interact/assets/invalid-client-id.png?fit=max&auto=format&n=LSGDIh-dJkCRUXNL&q=85&s=2d549c53ba0b33057182a42c40edc459" 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-705/LSGDIh-dJkCRUXNL/webchat/interact/assets/invalid-client-id-dark.png?fit=max&auto=format&n=LSGDIh-dJkCRUXNL&q=85&s=f2d2f2c819f1a392e5fec865c288a2eb" 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-705/LSGDIh-dJkCRUXNL/webchat/interact/assets/missing-api-url.png?fit=max&auto=format&n=LSGDIh-dJkCRUXNL&q=85&s=0be4ec219c97e82e67351f9fa0ce798f" 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-705/LSGDIh-dJkCRUXNL/webchat/interact/assets/missing-api-url-dark.png?fit=max&auto=format&n=LSGDIh-dJkCRUXNL&q=85&s=cb033877cd3ea2425dc47028048351dd" 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-705/LSGDIh-dJkCRUXNL/webchat/interact/assets/invalid-api-url.png?fit=max&auto=format&n=LSGDIh-dJkCRUXNL&q=85&s=501e4c0c1b550a98c8282c124d6c24a3" 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-705/LSGDIh-dJkCRUXNL/webchat/interact/assets/invalid-api-url-dark.png?fit=max&auto=format&n=LSGDIh-dJkCRUXNL&q=85&s=87ebd6e7d05067f2bf1989765335df64" 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-705/LSGDIh-dJkCRUXNL/webchat/interact/assets/missing-bot-id.png?fit=max&auto=format&n=LSGDIh-dJkCRUXNL&q=85&s=71efe8a755a07cc83c0b02416543ccb6" 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-705/LSGDIh-dJkCRUXNL/webchat/interact/assets/missing-bot-id-dark.png?fit=max&auto=format&n=LSGDIh-dJkCRUXNL&q=85&s=ce7536a7d484a2478dfd871b2fe32698" 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-705/LSGDIh-dJkCRUXNL/webchat/interact/assets/missing-config-url.png?fit=max&auto=format&n=LSGDIh-dJkCRUXNL&q=85&s=7122164495974b1e5cc3666c709b61d9" 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-705/LSGDIh-dJkCRUXNL/webchat/interact/assets/missing-config-url-dark.png?fit=max&auto=format&n=LSGDIh-dJkCRUXNL&q=85&s=9f91bb30252cd0ff322344f984a3b354" 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-705/LSGDIh-dJkCRUXNL/webchat/interact/assets/invalid-config-url.png?fit=max&auto=format&n=LSGDIh-dJkCRUXNL&q=85&s=e2809e9f6de4b8d785ea7853e5acdc22" 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-705/LSGDIh-dJkCRUXNL/webchat/interact/assets/invalid-config-url-dark.png?fit=max&auto=format&n=LSGDIh-dJkCRUXNL&q=85&s=112580d31cfee6ef1b82e2def088f489" 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-705/LSGDIh-dJkCRUXNL/webchat/interact/assets/invalid-config.png?fit=max&auto=format&n=LSGDIh-dJkCRUXNL&q=85&s=890814e77ff9062bfffc2ae6cc152ecf" 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-705/LSGDIh-dJkCRUXNL/webchat/interact/assets/invalid-config-dark.png?fit=max&auto=format&n=LSGDIh-dJkCRUXNL&q=85&s=ecd70037f9314770df08344ac5fea860" 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-705/LSGDIh-dJkCRUXNL/webchat/interact/assets/config-access-denied.png?fit=max&auto=format&n=LSGDIh-dJkCRUXNL&q=85&s=67a9e175c31e4dbe4036ea7541277fae" 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-705/LSGDIh-dJkCRUXNL/webchat/interact/assets/config-access-denied-dark.png?fit=max&auto=format&n=LSGDIh-dJkCRUXNL&q=85&s=48c3b9d30d42fa17d52a3465d9deeeef" 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-705/LSGDIh-dJkCRUXNL/webchat/interact/assets/bot-is-blocked.png?fit=max&auto=format&n=LSGDIh-dJkCRUXNL&q=85&s=a9b1ae4b9b0878c8c4067bd6784e6248" 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-705/LSGDIh-dJkCRUXNL/webchat/interact/assets/bot-is-blocked-dark.png?fit=max&auto=format&n=LSGDIh-dJkCRUXNL&q=85&s=3fc61fb469583a567e9ba0dc2a551867" 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-705/LSGDIh-dJkCRUXNL/webchat/interact/assets/quota-exceeded.png?fit=max&auto=format&n=LSGDIh-dJkCRUXNL&q=85&s=75902836fc0b5aa9eea7809d7bf95627" 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-705/LSGDIh-dJkCRUXNL/webchat/interact/assets/quota-exceeded-dark.png?fit=max&auto=format&n=LSGDIh-dJkCRUXNL&q=85&s=f579c609b5cb81184396359d55052c40" 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-705/LSGDIh-dJkCRUXNL/webchat/interact/assets/not-a-participant.png?fit=max&auto=format&n=LSGDIh-dJkCRUXNL&q=85&s=fe7760470615cf86ef8aca3d44b8ac68" 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-705/LSGDIh-dJkCRUXNL/webchat/interact/assets/not-a-participant-dark.png?fit=max&auto=format&n=LSGDIh-dJkCRUXNL&q=85&s=142d22a6579dc8376acfb29b65270062" 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-705/LSGDIh-dJkCRUXNL/webchat/interact/assets/invalid-message-content-type.png?fit=max&auto=format&n=LSGDIh-dJkCRUXNL&q=85&s=b7b8e4a2812edbd25dbb7839a137c7a6" 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-705/LSGDIh-dJkCRUXNL/webchat/interact/assets/invalid-message-content-type-dark.png?fit=max&auto=format&n=LSGDIh-dJkCRUXNL&q=85&s=43a005235c3783aa48640d78376d069b" 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-705/LSGDIh-dJkCRUXNL/webchat/interact/assets/network-error.png?fit=max&auto=format&n=LSGDIh-dJkCRUXNL&q=85&s=24b469604a42067f16bae5696e42cf84" 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-705/LSGDIh-dJkCRUXNL/webchat/interact/assets/network-error-dark.png?fit=max&auto=format&n=LSGDIh-dJkCRUXNL&q=85&s=5d8568c274973f8c41162fc74d37ff70" 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-705/LSGDIh-dJkCRUXNL/webchat/interact/assets/sse-disconnected.png?fit=max&auto=format&n=LSGDIh-dJkCRUXNL&q=85&s=fc28e5010b871760a7c4a33f033ee515" 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-705/LSGDIh-dJkCRUXNL/webchat/interact/assets/sse-disconnected-dark.png?fit=max&auto=format&n=LSGDIh-dJkCRUXNL&q=85&s=d8b9c077e150d843c6f58b7705a49705" width="1440" height="662" data-path="webchat/interact/assets/sse-disconnected-dark.png" />
</Frame>

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