> ## Documentation Index
> Fetch the complete documentation index at: https://botpress-charmenta-pr-693.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-693/wyQ3c0XBzAN2Zd7L/webchat/interact/assets/missing-client-id.png?fit=max&auto=format&n=wyQ3c0XBzAN2Zd7L&q=85&s=5ba7c2a49b29d29fef2c8af82533f84e" 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-693/wyQ3c0XBzAN2Zd7L/webchat/interact/assets/missing-client-id-dark.png?fit=max&auto=format&n=wyQ3c0XBzAN2Zd7L&q=85&s=47dfdb5f5b5b8afb802acdd88a43ef61" 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-693/wyQ3c0XBzAN2Zd7L/webchat/interact/assets/invalid-client-id.png?fit=max&auto=format&n=wyQ3c0XBzAN2Zd7L&q=85&s=606d91b2724d3f32a6420932fcc7ba2c" 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-693/wyQ3c0XBzAN2Zd7L/webchat/interact/assets/invalid-client-id-dark.png?fit=max&auto=format&n=wyQ3c0XBzAN2Zd7L&q=85&s=f8de01a482107e24e8fabc601bb777c3" 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-693/wyQ3c0XBzAN2Zd7L/webchat/interact/assets/missing-api-url.png?fit=max&auto=format&n=wyQ3c0XBzAN2Zd7L&q=85&s=903d955245507e270a10435489a92946" 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-693/wyQ3c0XBzAN2Zd7L/webchat/interact/assets/missing-api-url-dark.png?fit=max&auto=format&n=wyQ3c0XBzAN2Zd7L&q=85&s=2b7a2e646a81596a1c68bbdf9bf86931" 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-693/wyQ3c0XBzAN2Zd7L/webchat/interact/assets/invalid-api-url.png?fit=max&auto=format&n=wyQ3c0XBzAN2Zd7L&q=85&s=6b50f2fad66fc32189b07cced216b6f7" 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-693/wyQ3c0XBzAN2Zd7L/webchat/interact/assets/invalid-api-url-dark.png?fit=max&auto=format&n=wyQ3c0XBzAN2Zd7L&q=85&s=567da72f8bd711ed05fe43e5888ab82c" 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-693/wyQ3c0XBzAN2Zd7L/webchat/interact/assets/missing-bot-id.png?fit=max&auto=format&n=wyQ3c0XBzAN2Zd7L&q=85&s=ce06f9cb77cb0ade6c001a4b23dad12b" 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-693/wyQ3c0XBzAN2Zd7L/webchat/interact/assets/missing-bot-id-dark.png?fit=max&auto=format&n=wyQ3c0XBzAN2Zd7L&q=85&s=cb9e37deb8244feb7646bd5e6c716659" 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-693/wyQ3c0XBzAN2Zd7L/webchat/interact/assets/missing-config-url.png?fit=max&auto=format&n=wyQ3c0XBzAN2Zd7L&q=85&s=ae7c3952820c39157cf56f4962b8f24d" 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-693/wyQ3c0XBzAN2Zd7L/webchat/interact/assets/missing-config-url-dark.png?fit=max&auto=format&n=wyQ3c0XBzAN2Zd7L&q=85&s=dfb48ed783767bee8054464fed1f0672" 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-693/wyQ3c0XBzAN2Zd7L/webchat/interact/assets/invalid-config-url.png?fit=max&auto=format&n=wyQ3c0XBzAN2Zd7L&q=85&s=beaa97a768656e966b49899892830824" 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-693/wyQ3c0XBzAN2Zd7L/webchat/interact/assets/invalid-config-url-dark.png?fit=max&auto=format&n=wyQ3c0XBzAN2Zd7L&q=85&s=6948297d0a8ceedff508ec70fd9e492a" 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-693/wyQ3c0XBzAN2Zd7L/webchat/interact/assets/invalid-config.png?fit=max&auto=format&n=wyQ3c0XBzAN2Zd7L&q=85&s=dcf9ede1dc501740e3b7d2a1bb9ed40b" 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-693/wyQ3c0XBzAN2Zd7L/webchat/interact/assets/invalid-config-dark.png?fit=max&auto=format&n=wyQ3c0XBzAN2Zd7L&q=85&s=ea892659b357e92b02788623ab50333f" 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-693/wyQ3c0XBzAN2Zd7L/webchat/interact/assets/config-access-denied.png?fit=max&auto=format&n=wyQ3c0XBzAN2Zd7L&q=85&s=5958469ba6d687c285dad0e3c8fdadfb" 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-693/wyQ3c0XBzAN2Zd7L/webchat/interact/assets/config-access-denied-dark.png?fit=max&auto=format&n=wyQ3c0XBzAN2Zd7L&q=85&s=eec8b9dbe3d64904926c5014ecea8e9e" 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-693/wyQ3c0XBzAN2Zd7L/webchat/interact/assets/bot-is-blocked.png?fit=max&auto=format&n=wyQ3c0XBzAN2Zd7L&q=85&s=5d262debb6b2527d7f517472b987140b" 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-693/wyQ3c0XBzAN2Zd7L/webchat/interact/assets/bot-is-blocked-dark.png?fit=max&auto=format&n=wyQ3c0XBzAN2Zd7L&q=85&s=9d4ab9fd3625165dda122092b2f4ba92" 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-693/wyQ3c0XBzAN2Zd7L/webchat/interact/assets/quota-exceeded.png?fit=max&auto=format&n=wyQ3c0XBzAN2Zd7L&q=85&s=e84c84e9883170fb598b42f20434bfa5" 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-693/wyQ3c0XBzAN2Zd7L/webchat/interact/assets/quota-exceeded-dark.png?fit=max&auto=format&n=wyQ3c0XBzAN2Zd7L&q=85&s=fd15b3f1b264c522bd538543be011fa6" 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-693/wyQ3c0XBzAN2Zd7L/webchat/interact/assets/not-a-participant.png?fit=max&auto=format&n=wyQ3c0XBzAN2Zd7L&q=85&s=b01d5189b5edc7b96c352133fb4193b4" 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-693/wyQ3c0XBzAN2Zd7L/webchat/interact/assets/not-a-participant-dark.png?fit=max&auto=format&n=wyQ3c0XBzAN2Zd7L&q=85&s=3a5e0069c893b04c8866d3739f479353" 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-693/wyQ3c0XBzAN2Zd7L/webchat/interact/assets/invalid-message-content-type.png?fit=max&auto=format&n=wyQ3c0XBzAN2Zd7L&q=85&s=9ee2fdf2615980d36c8b402639f3f68a" 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-693/wyQ3c0XBzAN2Zd7L/webchat/interact/assets/invalid-message-content-type-dark.png?fit=max&auto=format&n=wyQ3c0XBzAN2Zd7L&q=85&s=e67c93b427bd45ae3315eba60c3039a1" 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-693/wyQ3c0XBzAN2Zd7L/webchat/interact/assets/network-error.png?fit=max&auto=format&n=wyQ3c0XBzAN2Zd7L&q=85&s=d628c2e22a2a7655d3450e3822e342a0" 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-693/wyQ3c0XBzAN2Zd7L/webchat/interact/assets/network-error-dark.png?fit=max&auto=format&n=wyQ3c0XBzAN2Zd7L&q=85&s=d89295fac1edc1100fc6fbd953a608ef" 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-693/wyQ3c0XBzAN2Zd7L/webchat/interact/assets/sse-disconnected.png?fit=max&auto=format&n=wyQ3c0XBzAN2Zd7L&q=85&s=18b83c4c1685d9ec2aa088859b1ccd74" 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-693/wyQ3c0XBzAN2Zd7L/webchat/interact/assets/sse-disconnected-dark.png?fit=max&auto=format&n=wyQ3c0XBzAN2Zd7L&q=85&s=7901c7c69d0d61321e13f8afe8e0d7a6" width="1440" height="662" data-path="webchat/interact/assets/sse-disconnected-dark.png" />
</Frame>

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