> ## Documentation Index
> Fetch the complete documentation index at: https://botpress-charmenta-pr-696.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-696/gMIy6l3I-2e0lgT5/webchat/interact/assets/missing-client-id.png?fit=max&auto=format&n=gMIy6l3I-2e0lgT5&q=85&s=15c83dcadd8f05d562d2e373a4c19f29" 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-696/gMIy6l3I-2e0lgT5/webchat/interact/assets/missing-client-id-dark.png?fit=max&auto=format&n=gMIy6l3I-2e0lgT5&q=85&s=cf3389c90688efd2035ad99a9e71149a" 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-696/gMIy6l3I-2e0lgT5/webchat/interact/assets/invalid-client-id.png?fit=max&auto=format&n=gMIy6l3I-2e0lgT5&q=85&s=d638762dffc245817d3e6fdebd03a853" 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-696/gMIy6l3I-2e0lgT5/webchat/interact/assets/invalid-client-id-dark.png?fit=max&auto=format&n=gMIy6l3I-2e0lgT5&q=85&s=aca550965cf75339c17f209d50a64f7b" 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-696/gMIy6l3I-2e0lgT5/webchat/interact/assets/missing-api-url.png?fit=max&auto=format&n=gMIy6l3I-2e0lgT5&q=85&s=81468a0cb27a7900b6ac738c28482029" 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-696/gMIy6l3I-2e0lgT5/webchat/interact/assets/missing-api-url-dark.png?fit=max&auto=format&n=gMIy6l3I-2e0lgT5&q=85&s=0b33f617b4f974be540fb44ae08dd949" 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-696/gMIy6l3I-2e0lgT5/webchat/interact/assets/invalid-api-url.png?fit=max&auto=format&n=gMIy6l3I-2e0lgT5&q=85&s=e136d94832a28ad23a7e4e89dd58178e" 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-696/gMIy6l3I-2e0lgT5/webchat/interact/assets/invalid-api-url-dark.png?fit=max&auto=format&n=gMIy6l3I-2e0lgT5&q=85&s=9fdf493d614dc81d670421f417b0142c" 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-696/gMIy6l3I-2e0lgT5/webchat/interact/assets/missing-bot-id.png?fit=max&auto=format&n=gMIy6l3I-2e0lgT5&q=85&s=3cb447b5475363c858d1a9ca18cf3785" 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-696/gMIy6l3I-2e0lgT5/webchat/interact/assets/missing-bot-id-dark.png?fit=max&auto=format&n=gMIy6l3I-2e0lgT5&q=85&s=e2957fe13665d97d0d513fd1dd2e0a74" 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-696/gMIy6l3I-2e0lgT5/webchat/interact/assets/missing-config-url.png?fit=max&auto=format&n=gMIy6l3I-2e0lgT5&q=85&s=c99d1907bb9f94ff5fc02777f254966f" 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-696/gMIy6l3I-2e0lgT5/webchat/interact/assets/missing-config-url-dark.png?fit=max&auto=format&n=gMIy6l3I-2e0lgT5&q=85&s=31373de197ea1dbb881bd37b55eb20ce" 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-696/gMIy6l3I-2e0lgT5/webchat/interact/assets/invalid-config-url.png?fit=max&auto=format&n=gMIy6l3I-2e0lgT5&q=85&s=26f1b562deab79d01512322d7dd1956e" 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-696/gMIy6l3I-2e0lgT5/webchat/interact/assets/invalid-config-url-dark.png?fit=max&auto=format&n=gMIy6l3I-2e0lgT5&q=85&s=dcfe3668770c6a333d0016b748eb815c" 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-696/gMIy6l3I-2e0lgT5/webchat/interact/assets/invalid-config.png?fit=max&auto=format&n=gMIy6l3I-2e0lgT5&q=85&s=4713e73c8afc8b16196ef047bf3467f1" 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-696/gMIy6l3I-2e0lgT5/webchat/interact/assets/invalid-config-dark.png?fit=max&auto=format&n=gMIy6l3I-2e0lgT5&q=85&s=da87dec0a149f5c4735a656eead035a8" 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-696/gMIy6l3I-2e0lgT5/webchat/interact/assets/config-access-denied.png?fit=max&auto=format&n=gMIy6l3I-2e0lgT5&q=85&s=3294d4e088656556ec7f4c028a6e2380" 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-696/gMIy6l3I-2e0lgT5/webchat/interact/assets/config-access-denied-dark.png?fit=max&auto=format&n=gMIy6l3I-2e0lgT5&q=85&s=8a879c1bd7fc745aae771e5cab8c6f66" 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-696/gMIy6l3I-2e0lgT5/webchat/interact/assets/bot-is-blocked.png?fit=max&auto=format&n=gMIy6l3I-2e0lgT5&q=85&s=aaea5f980f4e1b7aef63c14644a007ec" 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-696/gMIy6l3I-2e0lgT5/webchat/interact/assets/bot-is-blocked-dark.png?fit=max&auto=format&n=gMIy6l3I-2e0lgT5&q=85&s=3099d403ebcc4cbc8d8ec232b9fb633e" 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-696/gMIy6l3I-2e0lgT5/webchat/interact/assets/quota-exceeded.png?fit=max&auto=format&n=gMIy6l3I-2e0lgT5&q=85&s=81823a54b9df363d3616bc44920f9bb2" 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-696/gMIy6l3I-2e0lgT5/webchat/interact/assets/quota-exceeded-dark.png?fit=max&auto=format&n=gMIy6l3I-2e0lgT5&q=85&s=83f3daeea58487228d62943debea64fa" 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-696/gMIy6l3I-2e0lgT5/webchat/interact/assets/not-a-participant.png?fit=max&auto=format&n=gMIy6l3I-2e0lgT5&q=85&s=f6705ef542a2f5d8809eea432a90599e" 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-696/gMIy6l3I-2e0lgT5/webchat/interact/assets/not-a-participant-dark.png?fit=max&auto=format&n=gMIy6l3I-2e0lgT5&q=85&s=83cbe8a661a251830179a12097a81753" 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-696/gMIy6l3I-2e0lgT5/webchat/interact/assets/invalid-message-content-type.png?fit=max&auto=format&n=gMIy6l3I-2e0lgT5&q=85&s=577a11dd1ec3553297da4d362cf3b2bb" 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-696/gMIy6l3I-2e0lgT5/webchat/interact/assets/invalid-message-content-type-dark.png?fit=max&auto=format&n=gMIy6l3I-2e0lgT5&q=85&s=4ea7e45a37ead9e685ec0bf5c5d392f8" 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-696/gMIy6l3I-2e0lgT5/webchat/interact/assets/network-error.png?fit=max&auto=format&n=gMIy6l3I-2e0lgT5&q=85&s=a036a59f54599a976224a74098d54db0" 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-696/gMIy6l3I-2e0lgT5/webchat/interact/assets/network-error-dark.png?fit=max&auto=format&n=gMIy6l3I-2e0lgT5&q=85&s=e60674cf50a8f1e1c398adc859b15c70" 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-696/gMIy6l3I-2e0lgT5/webchat/interact/assets/sse-disconnected.png?fit=max&auto=format&n=gMIy6l3I-2e0lgT5&q=85&s=9d29bf12f0d3bad3fd7d80feb1d4efd8" 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-696/gMIy6l3I-2e0lgT5/webchat/interact/assets/sse-disconnected-dark.png?fit=max&auto=format&n=gMIy6l3I-2e0lgT5&q=85&s=95dbc83f85b056c201552aead9047e58" width="1440" height="662" data-path="webchat/interact/assets/sse-disconnected-dark.png" />
</Frame>

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