> ## Documentation Index
> Fetch the complete documentation index at: https://botpress-helpdesk.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-helpdesk/c7Y9YEIrbAfPnQGS/webchat/interact/assets/missing-client-id.png?fit=max&auto=format&n=c7Y9YEIrbAfPnQGS&q=85&s=1271236c8beac6f72cbe2fe37011a0cc" 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-helpdesk/c7Y9YEIrbAfPnQGS/webchat/interact/assets/missing-client-id-dark.png?fit=max&auto=format&n=c7Y9YEIrbAfPnQGS&q=85&s=f19a32b570368604653fff946a50efdf" 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-helpdesk/c7Y9YEIrbAfPnQGS/webchat/interact/assets/invalid-client-id.png?fit=max&auto=format&n=c7Y9YEIrbAfPnQGS&q=85&s=e89a2ca512bdefc68452a4364c98adb8" 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-helpdesk/c7Y9YEIrbAfPnQGS/webchat/interact/assets/invalid-client-id-dark.png?fit=max&auto=format&n=c7Y9YEIrbAfPnQGS&q=85&s=57e4223e2b29edc381f6e0289bb20f3d" 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-helpdesk/c7Y9YEIrbAfPnQGS/webchat/interact/assets/missing-api-url.png?fit=max&auto=format&n=c7Y9YEIrbAfPnQGS&q=85&s=80f10202b6998392eeff1cb4e06573fb" 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-helpdesk/c7Y9YEIrbAfPnQGS/webchat/interact/assets/missing-api-url-dark.png?fit=max&auto=format&n=c7Y9YEIrbAfPnQGS&q=85&s=161c784329c69ca61d58c0f5595beb2c" 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-helpdesk/c7Y9YEIrbAfPnQGS/webchat/interact/assets/invalid-api-url.png?fit=max&auto=format&n=c7Y9YEIrbAfPnQGS&q=85&s=5480c9de249671e1ce8dadffe51c9ead" 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-helpdesk/c7Y9YEIrbAfPnQGS/webchat/interact/assets/invalid-api-url-dark.png?fit=max&auto=format&n=c7Y9YEIrbAfPnQGS&q=85&s=3bab0b7ca998ea8a85c84f7fb6f4f5f5" 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-helpdesk/c7Y9YEIrbAfPnQGS/webchat/interact/assets/missing-bot-id.png?fit=max&auto=format&n=c7Y9YEIrbAfPnQGS&q=85&s=57475e6cd525a80a4f51111783600069" 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-helpdesk/c7Y9YEIrbAfPnQGS/webchat/interact/assets/missing-bot-id-dark.png?fit=max&auto=format&n=c7Y9YEIrbAfPnQGS&q=85&s=7eff3086c4e6410885c47458de244a0a" 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-helpdesk/c7Y9YEIrbAfPnQGS/webchat/interact/assets/missing-config-url.png?fit=max&auto=format&n=c7Y9YEIrbAfPnQGS&q=85&s=a9be70ac347fac9863778ce0c753e863" 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-helpdesk/c7Y9YEIrbAfPnQGS/webchat/interact/assets/missing-config-url-dark.png?fit=max&auto=format&n=c7Y9YEIrbAfPnQGS&q=85&s=b12b320d79845f6c69303d42e90278b5" 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-helpdesk/c7Y9YEIrbAfPnQGS/webchat/interact/assets/invalid-config-url.png?fit=max&auto=format&n=c7Y9YEIrbAfPnQGS&q=85&s=fe348d5e465f90b7e7daf827dc78290e" 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-helpdesk/c7Y9YEIrbAfPnQGS/webchat/interact/assets/invalid-config-url-dark.png?fit=max&auto=format&n=c7Y9YEIrbAfPnQGS&q=85&s=03589e4c995600f061848b9f5065fd52" 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-helpdesk/c7Y9YEIrbAfPnQGS/webchat/interact/assets/invalid-config.png?fit=max&auto=format&n=c7Y9YEIrbAfPnQGS&q=85&s=ff1c89191ef3a7c0ebd7b33e4b0c2767" 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-helpdesk/c7Y9YEIrbAfPnQGS/webchat/interact/assets/invalid-config-dark.png?fit=max&auto=format&n=c7Y9YEIrbAfPnQGS&q=85&s=472913e73e5046dcd44cfc2f1cf46805" 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-helpdesk/c7Y9YEIrbAfPnQGS/webchat/interact/assets/config-access-denied.png?fit=max&auto=format&n=c7Y9YEIrbAfPnQGS&q=85&s=a82e8aca142ece0558365e37ed370662" 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-helpdesk/c7Y9YEIrbAfPnQGS/webchat/interact/assets/config-access-denied-dark.png?fit=max&auto=format&n=c7Y9YEIrbAfPnQGS&q=85&s=933010bd9bed950d0de8ab1326dec588" 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-helpdesk/c7Y9YEIrbAfPnQGS/webchat/interact/assets/bot-is-blocked.png?fit=max&auto=format&n=c7Y9YEIrbAfPnQGS&q=85&s=8aee4f16fb1f969ebfad8d8d7f2aeca2" 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-helpdesk/c7Y9YEIrbAfPnQGS/webchat/interact/assets/bot-is-blocked-dark.png?fit=max&auto=format&n=c7Y9YEIrbAfPnQGS&q=85&s=83b9fa5e44f274b3e33fe2450619c50a" 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-helpdesk/c7Y9YEIrbAfPnQGS/webchat/interact/assets/quota-exceeded.png?fit=max&auto=format&n=c7Y9YEIrbAfPnQGS&q=85&s=12d33268116ee75536f8b58a7eeff34c" 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-helpdesk/c7Y9YEIrbAfPnQGS/webchat/interact/assets/quota-exceeded-dark.png?fit=max&auto=format&n=c7Y9YEIrbAfPnQGS&q=85&s=4ea56e06cb888993733c99099c2dcf04" 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-helpdesk/c7Y9YEIrbAfPnQGS/webchat/interact/assets/not-a-participant.png?fit=max&auto=format&n=c7Y9YEIrbAfPnQGS&q=85&s=28728fcde880662851d52ef9d6414329" 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-helpdesk/c7Y9YEIrbAfPnQGS/webchat/interact/assets/not-a-participant-dark.png?fit=max&auto=format&n=c7Y9YEIrbAfPnQGS&q=85&s=35d88b6e7b45add21b47430b0c7de536" 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-helpdesk/c7Y9YEIrbAfPnQGS/webchat/interact/assets/invalid-message-content-type.png?fit=max&auto=format&n=c7Y9YEIrbAfPnQGS&q=85&s=004e54f2315984dc67d9a48aefbf8b6b" 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-helpdesk/c7Y9YEIrbAfPnQGS/webchat/interact/assets/invalid-message-content-type-dark.png?fit=max&auto=format&n=c7Y9YEIrbAfPnQGS&q=85&s=bb3bbb9be12d2d256617557b9ae47f1f" 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-helpdesk/c7Y9YEIrbAfPnQGS/webchat/interact/assets/network-error.png?fit=max&auto=format&n=c7Y9YEIrbAfPnQGS&q=85&s=4bcda72abc8da3d4823e87e9e278c79b" 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-helpdesk/c7Y9YEIrbAfPnQGS/webchat/interact/assets/network-error-dark.png?fit=max&auto=format&n=c7Y9YEIrbAfPnQGS&q=85&s=1ae1a6af5bb6b33c0c1ec01f4a7e49c9" 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-helpdesk/c7Y9YEIrbAfPnQGS/webchat/interact/assets/sse-disconnected.png?fit=max&auto=format&n=c7Y9YEIrbAfPnQGS&q=85&s=d5ef94da65b12e386ddd042147ffef00" 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-helpdesk/c7Y9YEIrbAfPnQGS/webchat/interact/assets/sse-disconnected-dark.png?fit=max&auto=format&n=c7Y9YEIrbAfPnQGS&q=85&s=5aa9f10949b6909ce028011772734de4" width="1440" height="662" data-path="webchat/interact/assets/sse-disconnected-dark.png" />
</Frame>

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