> ## Documentation Index
> Fetch the complete documentation index at: https://botpress-charmenta-pr-719.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-719/g2UEYmWJXP6qf9IZ/webchat/interact/assets/missing-client-id.png?fit=max&auto=format&n=g2UEYmWJXP6qf9IZ&q=85&s=c07e64b5226044e920814808839c70c1" 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-719/g2UEYmWJXP6qf9IZ/webchat/interact/assets/missing-client-id-dark.png?fit=max&auto=format&n=g2UEYmWJXP6qf9IZ&q=85&s=82f15644a53976fd9d9ba8de1675d6e0" 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-719/g2UEYmWJXP6qf9IZ/webchat/interact/assets/invalid-client-id.png?fit=max&auto=format&n=g2UEYmWJXP6qf9IZ&q=85&s=6c228b9d9d0f9ada266906d28529625f" 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-719/g2UEYmWJXP6qf9IZ/webchat/interact/assets/invalid-client-id-dark.png?fit=max&auto=format&n=g2UEYmWJXP6qf9IZ&q=85&s=f7b95700aaf01d3baad98879ca5e007b" 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-719/g2UEYmWJXP6qf9IZ/webchat/interact/assets/missing-api-url.png?fit=max&auto=format&n=g2UEYmWJXP6qf9IZ&q=85&s=b20a792c15b6e7c71aed0ec2dc9f195b" 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-719/g2UEYmWJXP6qf9IZ/webchat/interact/assets/missing-api-url-dark.png?fit=max&auto=format&n=g2UEYmWJXP6qf9IZ&q=85&s=187ae5a628ff12c8f218fa6750769998" 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-719/g2UEYmWJXP6qf9IZ/webchat/interact/assets/invalid-api-url.png?fit=max&auto=format&n=g2UEYmWJXP6qf9IZ&q=85&s=262479db1646af17408201fea41679fe" 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-719/g2UEYmWJXP6qf9IZ/webchat/interact/assets/invalid-api-url-dark.png?fit=max&auto=format&n=g2UEYmWJXP6qf9IZ&q=85&s=d196bc1e65f7f8e82a27ea8e2db11a51" 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-719/g2UEYmWJXP6qf9IZ/webchat/interact/assets/missing-bot-id.png?fit=max&auto=format&n=g2UEYmWJXP6qf9IZ&q=85&s=a8b343c8b113554396b2efc7487ec59d" 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-719/g2UEYmWJXP6qf9IZ/webchat/interact/assets/missing-bot-id-dark.png?fit=max&auto=format&n=g2UEYmWJXP6qf9IZ&q=85&s=7952859eca7b228502f282d19d3f79c0" 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-719/g2UEYmWJXP6qf9IZ/webchat/interact/assets/missing-config-url.png?fit=max&auto=format&n=g2UEYmWJXP6qf9IZ&q=85&s=1c1cee8e62e2699673109cb8c1967381" 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-719/g2UEYmWJXP6qf9IZ/webchat/interact/assets/missing-config-url-dark.png?fit=max&auto=format&n=g2UEYmWJXP6qf9IZ&q=85&s=9e0b41877601132706a2345e78be2637" 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-719/g2UEYmWJXP6qf9IZ/webchat/interact/assets/invalid-config-url.png?fit=max&auto=format&n=g2UEYmWJXP6qf9IZ&q=85&s=b64c7b6592cce306a31fcc27e7b85147" 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-719/g2UEYmWJXP6qf9IZ/webchat/interact/assets/invalid-config-url-dark.png?fit=max&auto=format&n=g2UEYmWJXP6qf9IZ&q=85&s=728c0bc891f81cb0d2b0ebc9b758c4df" 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-719/g2UEYmWJXP6qf9IZ/webchat/interact/assets/invalid-config.png?fit=max&auto=format&n=g2UEYmWJXP6qf9IZ&q=85&s=90c81c95ff04f80f8524123703484759" 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-719/g2UEYmWJXP6qf9IZ/webchat/interact/assets/invalid-config-dark.png?fit=max&auto=format&n=g2UEYmWJXP6qf9IZ&q=85&s=e20f692047283b0b6a9ac8a43be43c5f" 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-719/g2UEYmWJXP6qf9IZ/webchat/interact/assets/config-access-denied.png?fit=max&auto=format&n=g2UEYmWJXP6qf9IZ&q=85&s=cad07232cee5c4ebcdae06d4c0010191" 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-719/g2UEYmWJXP6qf9IZ/webchat/interact/assets/config-access-denied-dark.png?fit=max&auto=format&n=g2UEYmWJXP6qf9IZ&q=85&s=6f87b32415290a34c1ddac61f51a3c6c" 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-719/g2UEYmWJXP6qf9IZ/webchat/interact/assets/bot-is-blocked.png?fit=max&auto=format&n=g2UEYmWJXP6qf9IZ&q=85&s=a459cee7f5f7942a1e80c634ac0d8c3f" 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-719/g2UEYmWJXP6qf9IZ/webchat/interact/assets/bot-is-blocked-dark.png?fit=max&auto=format&n=g2UEYmWJXP6qf9IZ&q=85&s=cabdaf04dfdbf110ce1ae4e13cc522e5" 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-719/g2UEYmWJXP6qf9IZ/webchat/interact/assets/quota-exceeded.png?fit=max&auto=format&n=g2UEYmWJXP6qf9IZ&q=85&s=84c8d8cef1c382a9f15b0d97dd5961ba" 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-719/g2UEYmWJXP6qf9IZ/webchat/interact/assets/quota-exceeded-dark.png?fit=max&auto=format&n=g2UEYmWJXP6qf9IZ&q=85&s=b1678dc16b9d2be8cab52e67df50f32b" 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-719/g2UEYmWJXP6qf9IZ/webchat/interact/assets/not-a-participant.png?fit=max&auto=format&n=g2UEYmWJXP6qf9IZ&q=85&s=72e691d4592afb2ab43ef069be6b9e9b" 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-719/g2UEYmWJXP6qf9IZ/webchat/interact/assets/not-a-participant-dark.png?fit=max&auto=format&n=g2UEYmWJXP6qf9IZ&q=85&s=8dccdd0d316dc938dceeeb6e5769b5c6" 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-719/g2UEYmWJXP6qf9IZ/webchat/interact/assets/invalid-message-content-type.png?fit=max&auto=format&n=g2UEYmWJXP6qf9IZ&q=85&s=675683b59cbfaaecf31e4fc1d22925a9" 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-719/g2UEYmWJXP6qf9IZ/webchat/interact/assets/invalid-message-content-type-dark.png?fit=max&auto=format&n=g2UEYmWJXP6qf9IZ&q=85&s=8bc7e526a40cdcff2977b2801c463f49" 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-719/g2UEYmWJXP6qf9IZ/webchat/interact/assets/network-error.png?fit=max&auto=format&n=g2UEYmWJXP6qf9IZ&q=85&s=c1a27f1c368a91318e6dcd88d539d782" 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-719/g2UEYmWJXP6qf9IZ/webchat/interact/assets/network-error-dark.png?fit=max&auto=format&n=g2UEYmWJXP6qf9IZ&q=85&s=9987eabd8d764a6aab0bb39a85f21787" 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-719/g2UEYmWJXP6qf9IZ/webchat/interact/assets/sse-disconnected.png?fit=max&auto=format&n=g2UEYmWJXP6qf9IZ&q=85&s=1212bad800dbd9bf5ef0387756226466" 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-719/g2UEYmWJXP6qf9IZ/webchat/interact/assets/sse-disconnected-dark.png?fit=max&auto=format&n=g2UEYmWJXP6qf9IZ&q=85&s=02cf1054998749fe9cc90f64c7f460c4" width="1440" height="662" data-path="webchat/interact/assets/sse-disconnected-dark.png" />
</Frame>

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