> ## Documentation Index
> Fetch the complete documentation index at: https://botpress-charmenta-pr-718.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-718/X1f5DsNjbZG6Cxoa/webchat/interact/assets/missing-client-id.png?fit=max&auto=format&n=X1f5DsNjbZG6Cxoa&q=85&s=05c7f7e5b78efde77b2001e30c93a33f" 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-718/X1f5DsNjbZG6Cxoa/webchat/interact/assets/missing-client-id-dark.png?fit=max&auto=format&n=X1f5DsNjbZG6Cxoa&q=85&s=b858b579c3d71ba5e34825986524b96c" 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-718/X1f5DsNjbZG6Cxoa/webchat/interact/assets/invalid-client-id.png?fit=max&auto=format&n=X1f5DsNjbZG6Cxoa&q=85&s=b506e22537a6c490eda57c738e435696" 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-718/X1f5DsNjbZG6Cxoa/webchat/interact/assets/invalid-client-id-dark.png?fit=max&auto=format&n=X1f5DsNjbZG6Cxoa&q=85&s=c20f6644bd6b3df4e782abfdede6a787" 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-718/X1f5DsNjbZG6Cxoa/webchat/interact/assets/missing-api-url.png?fit=max&auto=format&n=X1f5DsNjbZG6Cxoa&q=85&s=d8fbab45d1edd6eba73b00859d117d4f" 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-718/X1f5DsNjbZG6Cxoa/webchat/interact/assets/missing-api-url-dark.png?fit=max&auto=format&n=X1f5DsNjbZG6Cxoa&q=85&s=4bf21aad07a01b9b1d52079db6adfb37" 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-718/X1f5DsNjbZG6Cxoa/webchat/interact/assets/invalid-api-url.png?fit=max&auto=format&n=X1f5DsNjbZG6Cxoa&q=85&s=1812c55780789ad935f8dfd3d15a53ad" 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-718/X1f5DsNjbZG6Cxoa/webchat/interact/assets/invalid-api-url-dark.png?fit=max&auto=format&n=X1f5DsNjbZG6Cxoa&q=85&s=256ec4d9e7fa0a11cca1f45f16686f03" 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-718/X1f5DsNjbZG6Cxoa/webchat/interact/assets/missing-bot-id.png?fit=max&auto=format&n=X1f5DsNjbZG6Cxoa&q=85&s=e979412b65bb623e52ed82648175a3df" 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-718/X1f5DsNjbZG6Cxoa/webchat/interact/assets/missing-bot-id-dark.png?fit=max&auto=format&n=X1f5DsNjbZG6Cxoa&q=85&s=330b0878b752233f729add6433d0b3a7" 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-718/X1f5DsNjbZG6Cxoa/webchat/interact/assets/missing-config-url.png?fit=max&auto=format&n=X1f5DsNjbZG6Cxoa&q=85&s=1a6de918b70599b6ac13e8cdeee51e64" 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-718/X1f5DsNjbZG6Cxoa/webchat/interact/assets/missing-config-url-dark.png?fit=max&auto=format&n=X1f5DsNjbZG6Cxoa&q=85&s=029ba5d7e6b5b22c9bed817cdedded7d" 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-718/X1f5DsNjbZG6Cxoa/webchat/interact/assets/invalid-config-url.png?fit=max&auto=format&n=X1f5DsNjbZG6Cxoa&q=85&s=91a1af468c92781c5e60a5b1c1b751b9" 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-718/X1f5DsNjbZG6Cxoa/webchat/interact/assets/invalid-config-url-dark.png?fit=max&auto=format&n=X1f5DsNjbZG6Cxoa&q=85&s=1726f85fbc9998b7b3103f488aeff7f7" 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-718/X1f5DsNjbZG6Cxoa/webchat/interact/assets/invalid-config.png?fit=max&auto=format&n=X1f5DsNjbZG6Cxoa&q=85&s=a56145ae0a63ba632665292de7c0674b" 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-718/X1f5DsNjbZG6Cxoa/webchat/interact/assets/invalid-config-dark.png?fit=max&auto=format&n=X1f5DsNjbZG6Cxoa&q=85&s=6b5fa82fc66c4be42593c5f21c15b999" 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-718/X1f5DsNjbZG6Cxoa/webchat/interact/assets/config-access-denied.png?fit=max&auto=format&n=X1f5DsNjbZG6Cxoa&q=85&s=a5fe2387ec83a3417ff45da24ee33801" 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-718/X1f5DsNjbZG6Cxoa/webchat/interact/assets/config-access-denied-dark.png?fit=max&auto=format&n=X1f5DsNjbZG6Cxoa&q=85&s=a5b871fb392962308eed59b9150cd7bf" 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-718/X1f5DsNjbZG6Cxoa/webchat/interact/assets/bot-is-blocked.png?fit=max&auto=format&n=X1f5DsNjbZG6Cxoa&q=85&s=3f6c855c3a3bca5ec8d20188e13c59a9" 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-718/X1f5DsNjbZG6Cxoa/webchat/interact/assets/bot-is-blocked-dark.png?fit=max&auto=format&n=X1f5DsNjbZG6Cxoa&q=85&s=0ba2abbd734129f14aec396a07869d9b" 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-718/X1f5DsNjbZG6Cxoa/webchat/interact/assets/quota-exceeded.png?fit=max&auto=format&n=X1f5DsNjbZG6Cxoa&q=85&s=b896106d85e0ce0da76c2c505223e57a" 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-718/X1f5DsNjbZG6Cxoa/webchat/interact/assets/quota-exceeded-dark.png?fit=max&auto=format&n=X1f5DsNjbZG6Cxoa&q=85&s=1fc4d6ef5c2206bd72b031fa82b6a80b" 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-718/X1f5DsNjbZG6Cxoa/webchat/interact/assets/not-a-participant.png?fit=max&auto=format&n=X1f5DsNjbZG6Cxoa&q=85&s=2f52fa10eae626ce8f09422334383bf8" 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-718/X1f5DsNjbZG6Cxoa/webchat/interact/assets/not-a-participant-dark.png?fit=max&auto=format&n=X1f5DsNjbZG6Cxoa&q=85&s=cd7ab076674a4e868bbd279ad4682caa" 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-718/X1f5DsNjbZG6Cxoa/webchat/interact/assets/invalid-message-content-type.png?fit=max&auto=format&n=X1f5DsNjbZG6Cxoa&q=85&s=aedc94ec0a641a5a3d4f7165f118d640" 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-718/X1f5DsNjbZG6Cxoa/webchat/interact/assets/invalid-message-content-type-dark.png?fit=max&auto=format&n=X1f5DsNjbZG6Cxoa&q=85&s=236826bfacaad8c5652557299d39ab2c" 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-718/X1f5DsNjbZG6Cxoa/webchat/interact/assets/network-error.png?fit=max&auto=format&n=X1f5DsNjbZG6Cxoa&q=85&s=1f3283aa054e21df1754520db7dc0e70" 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-718/X1f5DsNjbZG6Cxoa/webchat/interact/assets/network-error-dark.png?fit=max&auto=format&n=X1f5DsNjbZG6Cxoa&q=85&s=bd93287f3845e0e3809c27ccb9445d7f" 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-718/X1f5DsNjbZG6Cxoa/webchat/interact/assets/sse-disconnected.png?fit=max&auto=format&n=X1f5DsNjbZG6Cxoa&q=85&s=d32621119fd3f7bae4fa58a45514cc35" 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-718/X1f5DsNjbZG6Cxoa/webchat/interact/assets/sse-disconnected-dark.png?fit=max&auto=format&n=X1f5DsNjbZG6Cxoa&q=85&s=fc03c11083868a5f5127f7f1580da653" width="1440" height="662" data-path="webchat/interact/assets/sse-disconnected-dark.png" />
</Frame>

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