> ## Documentation Index
> Fetch the complete documentation index at: https://botpress-update-integrations.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-update-integrations/hFTjvqpi4MwX6K0A/webchat/interact/assets/missing-client-id.png?fit=max&auto=format&n=hFTjvqpi4MwX6K0A&q=85&s=749ae1bbbfe6e722de0a0f67b4eff6ed" 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-update-integrations/hFTjvqpi4MwX6K0A/webchat/interact/assets/missing-client-id-dark.png?fit=max&auto=format&n=hFTjvqpi4MwX6K0A&q=85&s=f39016293954efa1af9cb967a2b32c26" 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-update-integrations/hFTjvqpi4MwX6K0A/webchat/interact/assets/invalid-client-id.png?fit=max&auto=format&n=hFTjvqpi4MwX6K0A&q=85&s=010bcc4fbdc8b53100b3c86f8b28f9ed" 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-update-integrations/SV6kvpEZ6ZDnne_7/webchat/interact/assets/invalid-client-id-dark.png?fit=max&auto=format&n=SV6kvpEZ6ZDnne_7&q=85&s=f3e89220955dd7898573bd3cac508203" 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-update-integrations/hFTjvqpi4MwX6K0A/webchat/interact/assets/missing-api-url.png?fit=max&auto=format&n=hFTjvqpi4MwX6K0A&q=85&s=c9856f33f7ecbcea0506419850dc5f44" 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-update-integrations/hFTjvqpi4MwX6K0A/webchat/interact/assets/missing-api-url-dark.png?fit=max&auto=format&n=hFTjvqpi4MwX6K0A&q=85&s=256440ab0f3068c8ffee4ac6cee00fca" 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-update-integrations/SV6kvpEZ6ZDnne_7/webchat/interact/assets/invalid-api-url.png?fit=max&auto=format&n=SV6kvpEZ6ZDnne_7&q=85&s=f1727f3743f07db58ba6bebacb2478b6" 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-update-integrations/SV6kvpEZ6ZDnne_7/webchat/interact/assets/invalid-api-url-dark.png?fit=max&auto=format&n=SV6kvpEZ6ZDnne_7&q=85&s=1b7bd8e68dc68ff36254ff7c5484fd51" 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-update-integrations/hFTjvqpi4MwX6K0A/webchat/interact/assets/missing-bot-id.png?fit=max&auto=format&n=hFTjvqpi4MwX6K0A&q=85&s=00201b69fc6c33480841d8bfecc171ab" 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-update-integrations/hFTjvqpi4MwX6K0A/webchat/interact/assets/missing-bot-id-dark.png?fit=max&auto=format&n=hFTjvqpi4MwX6K0A&q=85&s=c14a9940eeef41f20d8a6981c730bbf6" 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-update-integrations/hFTjvqpi4MwX6K0A/webchat/interact/assets/missing-config-url.png?fit=max&auto=format&n=hFTjvqpi4MwX6K0A&q=85&s=58c548ac2cfcb59d98ee65cfca1beab3" 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-update-integrations/hFTjvqpi4MwX6K0A/webchat/interact/assets/missing-config-url-dark.png?fit=max&auto=format&n=hFTjvqpi4MwX6K0A&q=85&s=1ae59fcc088e431abd6bf902f8456e58" 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-update-integrations/hFTjvqpi4MwX6K0A/webchat/interact/assets/invalid-config-url.png?fit=max&auto=format&n=hFTjvqpi4MwX6K0A&q=85&s=ed06cff5b4e4e7277ea667a5545a5993" 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-update-integrations/hFTjvqpi4MwX6K0A/webchat/interact/assets/invalid-config-url-dark.png?fit=max&auto=format&n=hFTjvqpi4MwX6K0A&q=85&s=b6f6e2a9dfd2da4767b6d2061c0faf3a" 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-update-integrations/hFTjvqpi4MwX6K0A/webchat/interact/assets/invalid-config.png?fit=max&auto=format&n=hFTjvqpi4MwX6K0A&q=85&s=a26d4fab657669c118dfa7f9cc309e02" 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-update-integrations/hFTjvqpi4MwX6K0A/webchat/interact/assets/invalid-config-dark.png?fit=max&auto=format&n=hFTjvqpi4MwX6K0A&q=85&s=e6fd994f3886f1f1897a40f68728b5d5" 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-update-integrations/SV6kvpEZ6ZDnne_7/webchat/interact/assets/config-access-denied.png?fit=max&auto=format&n=SV6kvpEZ6ZDnne_7&q=85&s=41cc7c373c39ff2d078bdf42c168f9b8" 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-update-integrations/SV6kvpEZ6ZDnne_7/webchat/interact/assets/config-access-denied-dark.png?fit=max&auto=format&n=SV6kvpEZ6ZDnne_7&q=85&s=5114c486fc1c13c805b0e9eea1aafa17" 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-update-integrations/SV6kvpEZ6ZDnne_7/webchat/interact/assets/bot-is-blocked.png?fit=max&auto=format&n=SV6kvpEZ6ZDnne_7&q=85&s=c513819f3917f33bd901ad16d1f34c34" 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-update-integrations/SV6kvpEZ6ZDnne_7/webchat/interact/assets/bot-is-blocked-dark.png?fit=max&auto=format&n=SV6kvpEZ6ZDnne_7&q=85&s=6592184cd629f8710681c3d7a46ff0de" 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-update-integrations/hFTjvqpi4MwX6K0A/webchat/interact/assets/quota-exceeded.png?fit=max&auto=format&n=hFTjvqpi4MwX6K0A&q=85&s=2a1f085ae1efed169524897226735bbc" 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-update-integrations/hFTjvqpi4MwX6K0A/webchat/interact/assets/quota-exceeded-dark.png?fit=max&auto=format&n=hFTjvqpi4MwX6K0A&q=85&s=91c5d241f1046602c16951b11b02b3cc" 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-update-integrations/hFTjvqpi4MwX6K0A/webchat/interact/assets/not-a-participant.png?fit=max&auto=format&n=hFTjvqpi4MwX6K0A&q=85&s=8afaf1f1720cdc6491d5740b07c72a5b" 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-update-integrations/hFTjvqpi4MwX6K0A/webchat/interact/assets/not-a-participant-dark.png?fit=max&auto=format&n=hFTjvqpi4MwX6K0A&q=85&s=b6cf96befc72f76ec874b10effbc4df5" 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-update-integrations/hFTjvqpi4MwX6K0A/webchat/interact/assets/invalid-message-content-type.png?fit=max&auto=format&n=hFTjvqpi4MwX6K0A&q=85&s=39a0f19e594f59e5488c6767efc5301b" 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-update-integrations/hFTjvqpi4MwX6K0A/webchat/interact/assets/invalid-message-content-type-dark.png?fit=max&auto=format&n=hFTjvqpi4MwX6K0A&q=85&s=e2d8bbae7badf125d75297e46e398c84" 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-update-integrations/hFTjvqpi4MwX6K0A/webchat/interact/assets/network-error.png?fit=max&auto=format&n=hFTjvqpi4MwX6K0A&q=85&s=eb96500a73a549e3be152dd007db24e7" 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-update-integrations/hFTjvqpi4MwX6K0A/webchat/interact/assets/network-error-dark.png?fit=max&auto=format&n=hFTjvqpi4MwX6K0A&q=85&s=7b49a1d0b9652db4995e6f3089c8c31b" 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-update-integrations/hFTjvqpi4MwX6K0A/webchat/interact/assets/sse-disconnected.png?fit=max&auto=format&n=hFTjvqpi4MwX6K0A&q=85&s=973d24e27987a800dfad038cb59e65da" 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-update-integrations/hFTjvqpi4MwX6K0A/webchat/interact/assets/sse-disconnected-dark.png?fit=max&auto=format&n=hFTjvqpi4MwX6K0A&q=85&s=35ac5a280236a2819ed6673584c5e144" width="1440" height="662" data-path="webchat/interact/assets/sse-disconnected-dark.png" />
</Frame>

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