Troubleshoot issues with embedded chat

Use these steps to identify and resolve common issues when working with watsonx Orchestrate embedded chat.

Chat does not load

If the chat interface fails to appear, check the following:

  • Verify security configuration

    Make sure that both IBM and client public keys are correctly configured.

  • Check the JWT token signature

    Confirm that your JWT token is signed with your private key.

  • Validate token expiration

    Ensure that your JWT token is still valid and not expired.

API errors

If you receive API error responses, use these checks to resolve them:

  • 401 Unauthorized

    Confirm that your IAM token is valid and not expired.

  • 403 Forbidden

    Verify that your API key has the required permissions to access the service.

  • 400 Bad Request

    Review your request body format. Make sure it follows the expected structure and includes all required fields.

Key generation issues

If you encounter problems while generating keys, follow these steps:

  • Check OpenSSL installation

    Ensure that OpenSSL is installed and working correctly on your system. Run openssl version to check the installation.