> ## Documentation Index
> Fetch the complete documentation index at: https://botpress-ak-docs-20-document-updating-variables-from-outsid.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-ak-docs-20-document-updating-variables-from-outsid/yvaA5dZS1nQ_qaqv/webchat/interact/assets/missing-client-id.png?fit=max&auto=format&n=yvaA5dZS1nQ_qaqv&q=85&s=a3aa428391eb2b5d23a71d2e897407a6" 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-ak-docs-20-document-updating-variables-from-outsid/yvaA5dZS1nQ_qaqv/webchat/interact/assets/missing-client-id-dark.png?fit=max&auto=format&n=yvaA5dZS1nQ_qaqv&q=85&s=820ba86db256a788c0b8522aa17bfd32" 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-ak-docs-20-document-updating-variables-from-outsid/yvaA5dZS1nQ_qaqv/webchat/interact/assets/invalid-client-id.png?fit=max&auto=format&n=yvaA5dZS1nQ_qaqv&q=85&s=759c2142878ce88a43df308cf4ec987c" 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-ak-docs-20-document-updating-variables-from-outsid/yvaA5dZS1nQ_qaqv/webchat/interact/assets/invalid-client-id-dark.png?fit=max&auto=format&n=yvaA5dZS1nQ_qaqv&q=85&s=53617045c49ef06b64225029827d4d16" 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-ak-docs-20-document-updating-variables-from-outsid/yvaA5dZS1nQ_qaqv/webchat/interact/assets/missing-api-url.png?fit=max&auto=format&n=yvaA5dZS1nQ_qaqv&q=85&s=986279517f5f11d9699e5129e6bebe57" 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-ak-docs-20-document-updating-variables-from-outsid/yvaA5dZS1nQ_qaqv/webchat/interact/assets/missing-api-url-dark.png?fit=max&auto=format&n=yvaA5dZS1nQ_qaqv&q=85&s=aa68fa94ca0b36e3fca4460e3b151c34" 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-ak-docs-20-document-updating-variables-from-outsid/yvaA5dZS1nQ_qaqv/webchat/interact/assets/invalid-api-url.png?fit=max&auto=format&n=yvaA5dZS1nQ_qaqv&q=85&s=3f1f5fdfd1a6cd02f7002b7ca3f82910" 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-ak-docs-20-document-updating-variables-from-outsid/yvaA5dZS1nQ_qaqv/webchat/interact/assets/invalid-api-url-dark.png?fit=max&auto=format&n=yvaA5dZS1nQ_qaqv&q=85&s=12f8a282b36e5980dd1bbc10ffd3e9e6" 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-ak-docs-20-document-updating-variables-from-outsid/yvaA5dZS1nQ_qaqv/webchat/interact/assets/missing-bot-id.png?fit=max&auto=format&n=yvaA5dZS1nQ_qaqv&q=85&s=6bd815649c6c1a8a627e25b5abb5c656" 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-ak-docs-20-document-updating-variables-from-outsid/yvaA5dZS1nQ_qaqv/webchat/interact/assets/missing-bot-id-dark.png?fit=max&auto=format&n=yvaA5dZS1nQ_qaqv&q=85&s=df7c52a30f68ed0c1b0f247585a38b64" 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-ak-docs-20-document-updating-variables-from-outsid/yvaA5dZS1nQ_qaqv/webchat/interact/assets/missing-config-url.png?fit=max&auto=format&n=yvaA5dZS1nQ_qaqv&q=85&s=c2ae3d44ea01c9381d827766be1dd7e5" 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-ak-docs-20-document-updating-variables-from-outsid/yvaA5dZS1nQ_qaqv/webchat/interact/assets/missing-config-url-dark.png?fit=max&auto=format&n=yvaA5dZS1nQ_qaqv&q=85&s=9a09037a9d3bf93ff928fbbd854c5197" 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-ak-docs-20-document-updating-variables-from-outsid/yvaA5dZS1nQ_qaqv/webchat/interact/assets/invalid-config-url.png?fit=max&auto=format&n=yvaA5dZS1nQ_qaqv&q=85&s=1f203f93ef81f2a3d3776f7919cfaa9a" 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-ak-docs-20-document-updating-variables-from-outsid/yvaA5dZS1nQ_qaqv/webchat/interact/assets/invalid-config-url-dark.png?fit=max&auto=format&n=yvaA5dZS1nQ_qaqv&q=85&s=0ee483944f9081117b393e2555e8cef0" 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-ak-docs-20-document-updating-variables-from-outsid/yvaA5dZS1nQ_qaqv/webchat/interact/assets/invalid-config.png?fit=max&auto=format&n=yvaA5dZS1nQ_qaqv&q=85&s=33e52151599d02712bdd29a087fe3bf3" 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-ak-docs-20-document-updating-variables-from-outsid/yvaA5dZS1nQ_qaqv/webchat/interact/assets/invalid-config-dark.png?fit=max&auto=format&n=yvaA5dZS1nQ_qaqv&q=85&s=faea60684e9630474a91b0bfeae38c77" 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-ak-docs-20-document-updating-variables-from-outsid/yvaA5dZS1nQ_qaqv/webchat/interact/assets/config-access-denied.png?fit=max&auto=format&n=yvaA5dZS1nQ_qaqv&q=85&s=af2494aec3b7d11040030430d2c9c1bd" 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-ak-docs-20-document-updating-variables-from-outsid/yvaA5dZS1nQ_qaqv/webchat/interact/assets/config-access-denied-dark.png?fit=max&auto=format&n=yvaA5dZS1nQ_qaqv&q=85&s=0a8f586a6b3d884d5f80cb93c50f0463" 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-ak-docs-20-document-updating-variables-from-outsid/yvaA5dZS1nQ_qaqv/webchat/interact/assets/bot-is-blocked.png?fit=max&auto=format&n=yvaA5dZS1nQ_qaqv&q=85&s=ce92d4747c6b6caa65f5c51152789b18" 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-ak-docs-20-document-updating-variables-from-outsid/yvaA5dZS1nQ_qaqv/webchat/interact/assets/bot-is-blocked-dark.png?fit=max&auto=format&n=yvaA5dZS1nQ_qaqv&q=85&s=4b7d4db5f308773034a928190d4b8370" 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-ak-docs-20-document-updating-variables-from-outsid/yS5SMDKBhDXJsxO1/webchat/interact/assets/quota-exceeded.png?fit=max&auto=format&n=yS5SMDKBhDXJsxO1&q=85&s=5090e9cfa7e4f4c3e3dc665d5bc8f1a5" 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-ak-docs-20-document-updating-variables-from-outsid/yS5SMDKBhDXJsxO1/webchat/interact/assets/quota-exceeded-dark.png?fit=max&auto=format&n=yS5SMDKBhDXJsxO1&q=85&s=d88e0ef2f268d8ca9e5f923f64d3f832" 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-ak-docs-20-document-updating-variables-from-outsid/yS5SMDKBhDXJsxO1/webchat/interact/assets/not-a-participant.png?fit=max&auto=format&n=yS5SMDKBhDXJsxO1&q=85&s=e0dd39831794d1eec72a6243b66b48df" 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-ak-docs-20-document-updating-variables-from-outsid/yS5SMDKBhDXJsxO1/webchat/interact/assets/not-a-participant-dark.png?fit=max&auto=format&n=yS5SMDKBhDXJsxO1&q=85&s=01acf37f2a9875005be8ee9f299b4ecf" 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-ak-docs-20-document-updating-variables-from-outsid/yvaA5dZS1nQ_qaqv/webchat/interact/assets/invalid-message-content-type.png?fit=max&auto=format&n=yvaA5dZS1nQ_qaqv&q=85&s=338ddfd34c5dc8633d08637d94ba85b6" 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-ak-docs-20-document-updating-variables-from-outsid/yvaA5dZS1nQ_qaqv/webchat/interact/assets/invalid-message-content-type-dark.png?fit=max&auto=format&n=yvaA5dZS1nQ_qaqv&q=85&s=5a59374cea15224f7a7852c007dff277" 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-ak-docs-20-document-updating-variables-from-outsid/yvaA5dZS1nQ_qaqv/webchat/interact/assets/network-error.png?fit=max&auto=format&n=yvaA5dZS1nQ_qaqv&q=85&s=f73809259e17c013972751bd2cad77e0" 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-ak-docs-20-document-updating-variables-from-outsid/yvaA5dZS1nQ_qaqv/webchat/interact/assets/network-error-dark.png?fit=max&auto=format&n=yvaA5dZS1nQ_qaqv&q=85&s=e8d7838ec4818955f38a1c717054ceac" 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-ak-docs-20-document-updating-variables-from-outsid/yS5SMDKBhDXJsxO1/webchat/interact/assets/sse-disconnected.png?fit=max&auto=format&n=yS5SMDKBhDXJsxO1&q=85&s=709c0aac628ed5a6db7103cb8899d5da" 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-ak-docs-20-document-updating-variables-from-outsid/yS5SMDKBhDXJsxO1/webchat/interact/assets/sse-disconnected-dark.png?fit=max&auto=format&n=yS5SMDKBhDXJsxO1&q=85&s=4c426d76826e918c1a50d8bd31dfa38d" width="1440" height="662" data-path="webchat/interact/assets/sse-disconnected-dark.png" />
</Frame>

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