> ## Documentation Index
> Fetch the complete documentation index at: https://botpress-docs-pr-583.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-docs-pr-583/JKd1vGYVvQKS6EFS/webchat/interact/assets/missing-client-id.png?fit=max&auto=format&n=JKd1vGYVvQKS6EFS&q=85&s=fa7bfb707ecfdfd344f168f61dee9cdc" 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-docs-pr-583/JKd1vGYVvQKS6EFS/webchat/interact/assets/missing-client-id-dark.png?fit=max&auto=format&n=JKd1vGYVvQKS6EFS&q=85&s=500be85aa7d2d03190c0360223ce4f7a" 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-docs-pr-583/JKd1vGYVvQKS6EFS/webchat/interact/assets/invalid-client-id.png?fit=max&auto=format&n=JKd1vGYVvQKS6EFS&q=85&s=23c017448ff957405c73e72ce626747a" 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-docs-pr-583/JKd1vGYVvQKS6EFS/webchat/interact/assets/invalid-client-id-dark.png?fit=max&auto=format&n=JKd1vGYVvQKS6EFS&q=85&s=890867f23aac84de59ed1c9621e690c2" 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-docs-pr-583/JKd1vGYVvQKS6EFS/webchat/interact/assets/missing-api-url.png?fit=max&auto=format&n=JKd1vGYVvQKS6EFS&q=85&s=0d1836d4d3776c891eac7b9bdd5c6427" 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-docs-pr-583/JKd1vGYVvQKS6EFS/webchat/interact/assets/missing-api-url-dark.png?fit=max&auto=format&n=JKd1vGYVvQKS6EFS&q=85&s=b4b940dfc927337016d6c3713016cb66" 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-docs-pr-583/JKd1vGYVvQKS6EFS/webchat/interact/assets/invalid-api-url.png?fit=max&auto=format&n=JKd1vGYVvQKS6EFS&q=85&s=8ca472eaf51a9306091a61409e7025b8" 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-docs-pr-583/JKd1vGYVvQKS6EFS/webchat/interact/assets/invalid-api-url-dark.png?fit=max&auto=format&n=JKd1vGYVvQKS6EFS&q=85&s=a0d67674d8f40fb30971a8770210f4d8" 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-docs-pr-583/JKd1vGYVvQKS6EFS/webchat/interact/assets/missing-bot-id.png?fit=max&auto=format&n=JKd1vGYVvQKS6EFS&q=85&s=fb67a1cc4ddb276438dc3d4a5579f573" 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-docs-pr-583/JKd1vGYVvQKS6EFS/webchat/interact/assets/missing-bot-id-dark.png?fit=max&auto=format&n=JKd1vGYVvQKS6EFS&q=85&s=4b152156d4c8a0dcbfa4b45a7e8a9340" 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-docs-pr-583/JKd1vGYVvQKS6EFS/webchat/interact/assets/missing-config-url.png?fit=max&auto=format&n=JKd1vGYVvQKS6EFS&q=85&s=be880b0a60897b67690726b1ddde11aa" 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-docs-pr-583/JKd1vGYVvQKS6EFS/webchat/interact/assets/missing-config-url-dark.png?fit=max&auto=format&n=JKd1vGYVvQKS6EFS&q=85&s=6410f47ae97586d6c67d8c502fe2bbc3" 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-docs-pr-583/JKd1vGYVvQKS6EFS/webchat/interact/assets/invalid-config-url.png?fit=max&auto=format&n=JKd1vGYVvQKS6EFS&q=85&s=f075f28529a3ebabe0e92f95ae4b875d" 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-docs-pr-583/JKd1vGYVvQKS6EFS/webchat/interact/assets/invalid-config-url-dark.png?fit=max&auto=format&n=JKd1vGYVvQKS6EFS&q=85&s=726e89812ded5221d637273aece60991" 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-docs-pr-583/JKd1vGYVvQKS6EFS/webchat/interact/assets/invalid-config.png?fit=max&auto=format&n=JKd1vGYVvQKS6EFS&q=85&s=08ee4d9930e0fa8e4e4bb2f7c2272753" 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-docs-pr-583/JKd1vGYVvQKS6EFS/webchat/interact/assets/invalid-config-dark.png?fit=max&auto=format&n=JKd1vGYVvQKS6EFS&q=85&s=c43d9595128cfec8d2d54ea8c75df50e" 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-docs-pr-583/JKd1vGYVvQKS6EFS/webchat/interact/assets/config-access-denied.png?fit=max&auto=format&n=JKd1vGYVvQKS6EFS&q=85&s=4d3ca00d834f4ebaa8da01c9f03d0f6c" 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-docs-pr-583/JKd1vGYVvQKS6EFS/webchat/interact/assets/config-access-denied-dark.png?fit=max&auto=format&n=JKd1vGYVvQKS6EFS&q=85&s=8f23e2258d5fcd1d74510086b3b03ff0" 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-docs-pr-583/JKd1vGYVvQKS6EFS/webchat/interact/assets/bot-is-blocked.png?fit=max&auto=format&n=JKd1vGYVvQKS6EFS&q=85&s=3d8b9e5b82604972266934dbdd92f171" 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-docs-pr-583/JKd1vGYVvQKS6EFS/webchat/interact/assets/bot-is-blocked-dark.png?fit=max&auto=format&n=JKd1vGYVvQKS6EFS&q=85&s=84ea1304a91549a7fb7626172adca4cf" 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-docs-pr-583/JKd1vGYVvQKS6EFS/webchat/interact/assets/quota-exceeded.png?fit=max&auto=format&n=JKd1vGYVvQKS6EFS&q=85&s=a9731c3262bd396d189f1b9e1491010a" 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-docs-pr-583/JKd1vGYVvQKS6EFS/webchat/interact/assets/quota-exceeded-dark.png?fit=max&auto=format&n=JKd1vGYVvQKS6EFS&q=85&s=13809ca9a457eb176fb24214759cbacb" 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-docs-pr-583/JKd1vGYVvQKS6EFS/webchat/interact/assets/not-a-participant.png?fit=max&auto=format&n=JKd1vGYVvQKS6EFS&q=85&s=f52fbef96f5cf628cbd2135114942aa1" 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-docs-pr-583/JKd1vGYVvQKS6EFS/webchat/interact/assets/not-a-participant-dark.png?fit=max&auto=format&n=JKd1vGYVvQKS6EFS&q=85&s=137a3e7612e87c8d0d86bd9447795715" 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-docs-pr-583/JKd1vGYVvQKS6EFS/webchat/interact/assets/invalid-message-content-type.png?fit=max&auto=format&n=JKd1vGYVvQKS6EFS&q=85&s=b4d21e861b0f1ac0523bf9635cfa4b06" 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-docs-pr-583/JKd1vGYVvQKS6EFS/webchat/interact/assets/invalid-message-content-type-dark.png?fit=max&auto=format&n=JKd1vGYVvQKS6EFS&q=85&s=46a244e2eac7becf29f7d54dd00ee556" 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-docs-pr-583/JKd1vGYVvQKS6EFS/webchat/interact/assets/network-error.png?fit=max&auto=format&n=JKd1vGYVvQKS6EFS&q=85&s=a5e7a31588900668cc350a50f0c08149" 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-docs-pr-583/JKd1vGYVvQKS6EFS/webchat/interact/assets/network-error-dark.png?fit=max&auto=format&n=JKd1vGYVvQKS6EFS&q=85&s=3223bf6278d3841a3b3dd27dd71608c3" 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-docs-pr-583/JKd1vGYVvQKS6EFS/webchat/interact/assets/sse-disconnected.png?fit=max&auto=format&n=JKd1vGYVvQKS6EFS&q=85&s=542d0d338fdd4e8fe823de7f81f8accc" 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-docs-pr-583/JKd1vGYVvQKS6EFS/webchat/interact/assets/sse-disconnected-dark.png?fit=max&auto=format&n=JKd1vGYVvQKS6EFS&q=85&s=604a2fb61d2942090b48465c165ed551" width="1440" height="662" data-path="webchat/interact/assets/sse-disconnected-dark.png" />
</Frame>

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.