> ## Documentation Index
> Fetch the complete documentation index at: https://botpress-charmenta-pr-711.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-711/ksS2w8akfAyqnaIC/webchat/interact/assets/missing-client-id.png?fit=max&auto=format&n=ksS2w8akfAyqnaIC&q=85&s=8e1e3c060b761a21b5b5a7b753ca3b88" 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-711/ksS2w8akfAyqnaIC/webchat/interact/assets/missing-client-id-dark.png?fit=max&auto=format&n=ksS2w8akfAyqnaIC&q=85&s=9f5579aefbb44a86e8d69856df7b1aca" 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-711/ksS2w8akfAyqnaIC/webchat/interact/assets/invalid-client-id.png?fit=max&auto=format&n=ksS2w8akfAyqnaIC&q=85&s=40001aa09ce3c9f5953384f9f4b129b3" 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-711/ksS2w8akfAyqnaIC/webchat/interact/assets/invalid-client-id-dark.png?fit=max&auto=format&n=ksS2w8akfAyqnaIC&q=85&s=e9a72682bd5006aedf47823846bb6456" 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-711/ksS2w8akfAyqnaIC/webchat/interact/assets/missing-api-url.png?fit=max&auto=format&n=ksS2w8akfAyqnaIC&q=85&s=a64140e5b0f41d46fd4181ea166eb831" 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-711/ksS2w8akfAyqnaIC/webchat/interact/assets/missing-api-url-dark.png?fit=max&auto=format&n=ksS2w8akfAyqnaIC&q=85&s=d231df1b9bbd816220a41e926fcbdb59" 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-711/ksS2w8akfAyqnaIC/webchat/interact/assets/invalid-api-url.png?fit=max&auto=format&n=ksS2w8akfAyqnaIC&q=85&s=19818c7e7cff9459c35b0a392b09b76f" 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-711/ksS2w8akfAyqnaIC/webchat/interact/assets/invalid-api-url-dark.png?fit=max&auto=format&n=ksS2w8akfAyqnaIC&q=85&s=0f92f0c2e07a50da59756058aa7a946f" 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-711/ksS2w8akfAyqnaIC/webchat/interact/assets/missing-bot-id.png?fit=max&auto=format&n=ksS2w8akfAyqnaIC&q=85&s=f9abb5a0248384390cd88025fd50b813" 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-711/ksS2w8akfAyqnaIC/webchat/interact/assets/missing-bot-id-dark.png?fit=max&auto=format&n=ksS2w8akfAyqnaIC&q=85&s=95b2bb64672fe9e12ddbfc562bb40483" 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-711/ksS2w8akfAyqnaIC/webchat/interact/assets/missing-config-url.png?fit=max&auto=format&n=ksS2w8akfAyqnaIC&q=85&s=6377c544c4b012f8a05d7e531a6cb039" 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-711/ksS2w8akfAyqnaIC/webchat/interact/assets/missing-config-url-dark.png?fit=max&auto=format&n=ksS2w8akfAyqnaIC&q=85&s=4fcaf9bfd750f2edbc6cea3f2d50d38c" 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-711/ksS2w8akfAyqnaIC/webchat/interact/assets/invalid-config-url.png?fit=max&auto=format&n=ksS2w8akfAyqnaIC&q=85&s=a06d0022e5e4618866f1f92a87fac9a7" 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-711/ksS2w8akfAyqnaIC/webchat/interact/assets/invalid-config-url-dark.png?fit=max&auto=format&n=ksS2w8akfAyqnaIC&q=85&s=ddef76d7ef3400d76549847bd2b90dc4" 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-711/ksS2w8akfAyqnaIC/webchat/interact/assets/invalid-config.png?fit=max&auto=format&n=ksS2w8akfAyqnaIC&q=85&s=595170d11631e48fed3594b0919ff6f2" 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-711/ksS2w8akfAyqnaIC/webchat/interact/assets/invalid-config-dark.png?fit=max&auto=format&n=ksS2w8akfAyqnaIC&q=85&s=9f459c1d4d11cb7b5087cbeb852b03a9" 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-711/ksS2w8akfAyqnaIC/webchat/interact/assets/config-access-denied.png?fit=max&auto=format&n=ksS2w8akfAyqnaIC&q=85&s=d697920ec967f34b9ea2bfb9d0ad270f" 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-711/ksS2w8akfAyqnaIC/webchat/interact/assets/config-access-denied-dark.png?fit=max&auto=format&n=ksS2w8akfAyqnaIC&q=85&s=5f412dfd85dc6fc8444a5200ff0bfa71" 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-711/ksS2w8akfAyqnaIC/webchat/interact/assets/bot-is-blocked.png?fit=max&auto=format&n=ksS2w8akfAyqnaIC&q=85&s=e66d8fd7032dea1b8fc115a404e1406b" 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-711/ksS2w8akfAyqnaIC/webchat/interact/assets/bot-is-blocked-dark.png?fit=max&auto=format&n=ksS2w8akfAyqnaIC&q=85&s=c789cf9426f7d260b7fe18da0b41d4c3" 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-711/ksS2w8akfAyqnaIC/webchat/interact/assets/quota-exceeded.png?fit=max&auto=format&n=ksS2w8akfAyqnaIC&q=85&s=5f415883975a3665c39aca30e672e1e1" 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-711/ksS2w8akfAyqnaIC/webchat/interact/assets/quota-exceeded-dark.png?fit=max&auto=format&n=ksS2w8akfAyqnaIC&q=85&s=6245065316b3bcae86879c87c3c90c33" 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-711/ksS2w8akfAyqnaIC/webchat/interact/assets/not-a-participant.png?fit=max&auto=format&n=ksS2w8akfAyqnaIC&q=85&s=4e9dcb85df53703126f7525d8d7e68a7" 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-711/ksS2w8akfAyqnaIC/webchat/interact/assets/not-a-participant-dark.png?fit=max&auto=format&n=ksS2w8akfAyqnaIC&q=85&s=b7593895bb22e84521f2644ae315f797" 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-711/ksS2w8akfAyqnaIC/webchat/interact/assets/invalid-message-content-type.png?fit=max&auto=format&n=ksS2w8akfAyqnaIC&q=85&s=6c16515a3bb495b2535cceaf65bb8245" 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-711/ksS2w8akfAyqnaIC/webchat/interact/assets/invalid-message-content-type-dark.png?fit=max&auto=format&n=ksS2w8akfAyqnaIC&q=85&s=f1b7fff8e4431108e8783f0500e69e77" 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-711/ksS2w8akfAyqnaIC/webchat/interact/assets/network-error.png?fit=max&auto=format&n=ksS2w8akfAyqnaIC&q=85&s=a2518d254fad11a88864b3f101343210" 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-711/ksS2w8akfAyqnaIC/webchat/interact/assets/network-error-dark.png?fit=max&auto=format&n=ksS2w8akfAyqnaIC&q=85&s=b00c586c3cc07d6ff6714181fa5ef637" 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-711/ksS2w8akfAyqnaIC/webchat/interact/assets/sse-disconnected.png?fit=max&auto=format&n=ksS2w8akfAyqnaIC&q=85&s=4eadcbf0fa42439da5a7628cc7e827ce" 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-711/ksS2w8akfAyqnaIC/webchat/interact/assets/sse-disconnected-dark.png?fit=max&auto=format&n=ksS2w8akfAyqnaIC&q=85&s=2492af3c0a6edbe9a8af9aad526050ff" width="1440" height="662" data-path="webchat/interact/assets/sse-disconnected-dark.png" />
</Frame>

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