OpenSpeechAI

Troubleshooting

Common issues and solutions to help you resolve problems with your OpenSpeechAI chat widget and agent configuration.

Widget Not Appearing on Website

If your widget isn't showing up on your website after adding the script, here are the most common causes and solutions.

Messages Not Sending

If your widget appears but messages aren't sending or you see errors, here's how to diagnose and fix the issue.

Agent Not Responding Correctly

If your agent is giving incorrect, irrelevant, or unhelpful responses, the issue is usually in your agent configuration or knowledge base.

Knowledge Base Issues

Problems with adding content to your knowledge base or getting your agent to use that content correctly.

Customization Not Showing

If you changed your widget's appearance or settings but don't see the updates on your website.

Workspace and Invitation Issues

Checking Browser Console

Many issues can be diagnosed by checking your browser's developer console. Here's how to access it and what to look for.

To open the developer console, press F12 on your keyboard (or right-click anywhere on your page and select "Inspect" or "Inspect Element"). Click the Console tab to see error messages and warnings.

Look for messages in red - these are errors. Common error messages include:

  • Origin not allowed or CORS error - Your domain isn't in allowed origins
  • Failed to load resource - The widget script couldn't load from the server
  • Refused to load script - Content Security Policy is blocking the widget

Copy any error messages you see. These help identify the exact problem and are useful if you need to contact support.

Getting Help

If you've tried these troubleshooting steps and still can't resolve your issue, contact support at shri@openspeechai.com.

When reaching out, include:

  • A description of the problem and what you're trying to do
  • Your website URL where the widget should appear
  • Any error messages from the browser console
  • What troubleshooting steps you've already tried

The more details you provide, the faster we can help you resolve the issue.


Last updated: August 7, 2026

On this page