> ## Documentation Index
> Fetch the complete documentation index at: https://botpress-pb-update-api.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-pb-update-api/p4207HaMDnDWz-I-/webchat/interact/assets/missing-client-id.png?fit=max&auto=format&n=p4207HaMDnDWz-I-&q=85&s=25915dd9e67c39be7a7b9557649ad45c" 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-pb-update-api/p4207HaMDnDWz-I-/webchat/interact/assets/missing-client-id-dark.png?fit=max&auto=format&n=p4207HaMDnDWz-I-&q=85&s=7675ee0ec4333c4aaba24cb51284609f" 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-pb-update-api/p4207HaMDnDWz-I-/webchat/interact/assets/invalid-client-id.png?fit=max&auto=format&n=p4207HaMDnDWz-I-&q=85&s=d44abc4de7108e171d6bb14f0757d78a" 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-pb-update-api/p4207HaMDnDWz-I-/webchat/interact/assets/invalid-client-id-dark.png?fit=max&auto=format&n=p4207HaMDnDWz-I-&q=85&s=351a48ac525b4e0acb13b72fc70c5f4e" 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-pb-update-api/p4207HaMDnDWz-I-/webchat/interact/assets/missing-api-url.png?fit=max&auto=format&n=p4207HaMDnDWz-I-&q=85&s=d95cae270c43bda168e8aad930f1e7cb" 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-pb-update-api/p4207HaMDnDWz-I-/webchat/interact/assets/missing-api-url-dark.png?fit=max&auto=format&n=p4207HaMDnDWz-I-&q=85&s=16c3f66f1440e51da679a39b4dd4f6ba" 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-pb-update-api/p4207HaMDnDWz-I-/webchat/interact/assets/invalid-api-url.png?fit=max&auto=format&n=p4207HaMDnDWz-I-&q=85&s=36ef703ca8dec6ac581b388fd55cc33e" 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-pb-update-api/p4207HaMDnDWz-I-/webchat/interact/assets/invalid-api-url-dark.png?fit=max&auto=format&n=p4207HaMDnDWz-I-&q=85&s=40b7d0fa148a73069ee848fbadce1786" 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-pb-update-api/p4207HaMDnDWz-I-/webchat/interact/assets/missing-bot-id.png?fit=max&auto=format&n=p4207HaMDnDWz-I-&q=85&s=9d6ee77a356c75bf0bcb43da44497ec4" 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-pb-update-api/p4207HaMDnDWz-I-/webchat/interact/assets/missing-bot-id-dark.png?fit=max&auto=format&n=p4207HaMDnDWz-I-&q=85&s=f5cdf4ad4292df39b5d7c3c2fb93fe06" 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-pb-update-api/p4207HaMDnDWz-I-/webchat/interact/assets/missing-config-url.png?fit=max&auto=format&n=p4207HaMDnDWz-I-&q=85&s=350621271b32e8f0eec3b39da86dae00" 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-pb-update-api/p4207HaMDnDWz-I-/webchat/interact/assets/missing-config-url-dark.png?fit=max&auto=format&n=p4207HaMDnDWz-I-&q=85&s=6f9ae7ce9b603ec34bec62d8d0f8f52d" 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-pb-update-api/p4207HaMDnDWz-I-/webchat/interact/assets/invalid-config-url.png?fit=max&auto=format&n=p4207HaMDnDWz-I-&q=85&s=2fc7114c4d49ee63c7b9be8a7e3d9e25" 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-pb-update-api/p4207HaMDnDWz-I-/webchat/interact/assets/invalid-config-url-dark.png?fit=max&auto=format&n=p4207HaMDnDWz-I-&q=85&s=ec6fce7251f03b43b091eff71f68d1f7" 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-pb-update-api/p4207HaMDnDWz-I-/webchat/interact/assets/invalid-config.png?fit=max&auto=format&n=p4207HaMDnDWz-I-&q=85&s=0c0df64dcbb9821069357ced053df944" 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-pb-update-api/p4207HaMDnDWz-I-/webchat/interact/assets/invalid-config-dark.png?fit=max&auto=format&n=p4207HaMDnDWz-I-&q=85&s=42aea59bcc51ae7c88ebff45e2652d20" 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-pb-update-api/p4207HaMDnDWz-I-/webchat/interact/assets/config-access-denied.png?fit=max&auto=format&n=p4207HaMDnDWz-I-&q=85&s=90a0777c45aaedecac7849b1abed808c" 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-pb-update-api/p4207HaMDnDWz-I-/webchat/interact/assets/config-access-denied-dark.png?fit=max&auto=format&n=p4207HaMDnDWz-I-&q=85&s=9554d7acb03ee5e577dbb2c79fdbb893" 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-pb-update-api/p4207HaMDnDWz-I-/webchat/interact/assets/bot-is-blocked.png?fit=max&auto=format&n=p4207HaMDnDWz-I-&q=85&s=1b3ec51d1ca044c61ee49dc8fd753cfe" 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-pb-update-api/p4207HaMDnDWz-I-/webchat/interact/assets/bot-is-blocked-dark.png?fit=max&auto=format&n=p4207HaMDnDWz-I-&q=85&s=2ff9bdc181e5b17ab13f8653b9386720" 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-pb-update-api/p4207HaMDnDWz-I-/webchat/interact/assets/quota-exceeded.png?fit=max&auto=format&n=p4207HaMDnDWz-I-&q=85&s=df1d85a2084056073e23f47bda748b35" 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-pb-update-api/p4207HaMDnDWz-I-/webchat/interact/assets/quota-exceeded-dark.png?fit=max&auto=format&n=p4207HaMDnDWz-I-&q=85&s=55b8393178213d0065c25989ee60bee7" 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-pb-update-api/p4207HaMDnDWz-I-/webchat/interact/assets/not-a-participant.png?fit=max&auto=format&n=p4207HaMDnDWz-I-&q=85&s=033e5a8737f0517819c7a030f4bfdf4f" 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-pb-update-api/p4207HaMDnDWz-I-/webchat/interact/assets/not-a-participant-dark.png?fit=max&auto=format&n=p4207HaMDnDWz-I-&q=85&s=44763b84512c5cb53f0bc79ac1afe0dd" 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-pb-update-api/p4207HaMDnDWz-I-/webchat/interact/assets/invalid-message-content-type.png?fit=max&auto=format&n=p4207HaMDnDWz-I-&q=85&s=4541fde7a159c521ef7b4305bc2080ca" 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-pb-update-api/p4207HaMDnDWz-I-/webchat/interact/assets/invalid-message-content-type-dark.png?fit=max&auto=format&n=p4207HaMDnDWz-I-&q=85&s=81c2d7a237f01bde839faeb91aa20b8c" 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-pb-update-api/p4207HaMDnDWz-I-/webchat/interact/assets/network-error.png?fit=max&auto=format&n=p4207HaMDnDWz-I-&q=85&s=803103cd58d476059140fe11f98afd5f" 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-pb-update-api/p4207HaMDnDWz-I-/webchat/interact/assets/network-error-dark.png?fit=max&auto=format&n=p4207HaMDnDWz-I-&q=85&s=4b6fc59a83178d3713f41fba57029041" 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-pb-update-api/p4207HaMDnDWz-I-/webchat/interact/assets/sse-disconnected.png?fit=max&auto=format&n=p4207HaMDnDWz-I-&q=85&s=7cf3f7c4a8ee3201c5d9bb9feff9efa2" 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-pb-update-api/p4207HaMDnDWz-I-/webchat/interact/assets/sse-disconnected-dark.png?fit=max&auto=format&n=p4207HaMDnDWz-I-&q=85&s=9158e727b6b2891bf124902c72b451a2" width="1440" height="662" data-path="webchat/interact/assets/sse-disconnected-dark.png" />
</Frame>

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