Troubleshooting¶

Common issues and their solutions.

If the chat widget doesn't appear on your website, check these items in order:

Go to Inqyra > Configuration > Widget tab and verify that Widget Status is toggled on.

2. Is an agent configured?¶

The widget requires a saved and active agent. Go to Inqyra > Configuration and make sure you have saved your agent settings.

3. Is an API key configured?¶

The widget won't load if your selected AI provider has no API key. Go to Inqyra > Settings and verify that the API key for your chosen provider is entered and shows a valid status.

4. Have daily limits been reached?¶

If the daily token limit or cost limit has been reached, the widget is automatically hidden. Check the Dashboard for current usage levels. Limits reset at midnight (server time).

If you're using "Only selected pages" or "Everywhere except" display mode, verify that the current page is included. Go to Inqyra > Configuration > Widget tab and check the page selection.

6. Is mobile display enabled?¶

If the widget is missing only on mobile devices, check that Mobile Enabled is turned on in the Widget configuration.

7. Is there a caching conflict?¶

If you use a caching plugin (WP Super Cache, W3 Total Cache, LiteSpeed, etc.), clear the cache after making changes to widget settings.

Chatbot Gives Irrelevant Answers¶

Re-index your content¶

If your content has changed, the knowledge base may be outdated. Go to Inqyra > Knowledge Base and click Re-index.

Check for pending embeddings¶

Content chunks without embeddings cannot be found by the chatbot. On the Knowledge Base page, check if there are pending embeddings and click Process Embeddings to generate them.

Improve your system prompt¶

A vague system prompt leads to vague answers. Add specific instructions about what topics to cover and how to respond. See Agent Basics for tips.

Enable query rewriting¶

Query rewriting can significantly improve search results by reformulating vague visitor questions. Enable it in the AI Provider settings.

Add synonyms (Premium)¶

If visitors use different terminology than your website, add synonyms to bridge the gap.

Embeddings Not Processing¶

Keep the browser tab open¶

Embeddings are generated in your browser. The process requires the admin page to remain open. You can switch to another tab, but don't close the browser.

Reduce the batch size¶

If your browser slows down during embedding generation, go to Inqyra > Settings > Advanced and reduce the Embedding Batch Size (default: 5). Try setting it to 2 or 3.

Check browser console for errors¶

Open your browser's developer tools (F12) and check the Console tab for error messages. Common issues include network errors when loading the embedding model from the CDN.

Slow Chatbot Responses¶

Choose a faster model¶

Some AI models are slower than others. Faster options include:

Claude 3.5 Haiku
GPT-4o Mini
Gemini 2.5 Flash
Mistral Small

Lower max tokens¶

Reduce Max Tokens per Response in Limits to get shorter, faster responses.

Check your hosting¶

Slow server response times can delay the initial API call. If your WordPress hosting is slow, the chatbot will be affected.

Rate Limiting Errors¶

Visitors see a "Too many messages" error when they exceed the rate limit (20 messages per minute or 200 per hour per IP address).

This limit protects against abuse. If legitimate users are hitting the limit, there's likely a configuration issue causing excessive requests — check the browser console for errors that might trigger retries.

License Activation Issues¶

"License key is invalid"¶

Double-check that you entered the key exactly as received. License keys are case-sensitive.

"Domain limit reached"¶

Your license has been activated on the maximum number of websites. Deactivate it from another site first, or upgrade to a higher license tier.

"License expired"¶

Renew your license at inqyra.com. After renewal, go to Inqyra > Settings and click Activate License again.

Content Not Found by Chatbot¶

Verify the content is indexed¶

Go to Inqyra > Knowledge Base and search for the content in the chunks table. If it's not there:

Check that the post type is included in Crawling settings
Verify the post is published (not draft or private)
Re-index your content

Verify embeddings are generated¶

Content without embeddings won't appear in search results. Check the "Embedding Status" column in the chunks table — it should show "Ready", not "Pending".

Check HTML tags¶

If content is in an unusual HTML element that's not in the extraction list, it won't be crawled. Add the tag in Crawling settings.

Getting Help¶

If you're still experiencing issues:

Enable Debug Mode in Inqyra > Settings > Advanced to capture additional diagnostic information
Check the browser console (F12 > Console) for JavaScript errors
Contact support with a description of the issue and any error messages