Troubleshooting & Support

Troubleshooting

This section covers common issues you might encounter while setting up or using the Supervised AI Bots plugin and how to resolve them.

If the chatbot icon or popup does not appear on your page after adding the shortcode, check the following:

Plugin Activation: Ensure the plugin is activated under the Plugins menu in your WordPress dashboard.
Correct Shortcode ID: The id attribute in the shortcode [supervised_ai_bot id="1"] must correspond to the line number of the URL entered in the settings page.
- Example: If you have three URLs, the third one is accessed via id="3".
Empty Settings: Verify that you have actually saved the chatbot URLs in the Supervised AI Bots settings page.

If the popup opens but remains blank or shows a connection error:

URL Accuracy: Double-check that the URL provided in the settings is correct and includes the protocol (e.g., https://).
Mixed Content: If your site uses https, ensure the Chatbot URL also uses https. Most browsers block http iframes on https sites for security.
X-Frame-Options: Ensure the Supervised AI instance allows its interface to be embedded via iframes. If the external server sends a DENY or SAMEORIGIN header, the bot will not load.

Because the chatbot uses a fixed-position popup, it may occasionally conflict with your theme's styles.

Z-Index Issues: If the chatbot button appears behind other elements (like a sticky header or another "Back to Top" button), there may be a z-index conflict. The plugin uses a default z-index of 9999 for the button and 1001 for the container.
Mobile Viewport: The popup has a fixed width of 400px. On very narrow mobile devices, this might exceed the screen width. Check your site on mobile to ensure the iframe-container scales appropriately.

The plugin uses a global function togglePopup() to handle the interface.

Script Errors: If clicking the chat icon does nothing, open your browser's Developer Tools (F12) and check the Console tab. If you see errors related to "togglePopup is not defined," the custom-popup-script.js file may not be loading correctly due to a caching plugin or an optimization tool (like Autoptimize or WP Rocket).
Excluding from Optimization: If you use a JS minification or deferral plugin, try excluding custom-popup-script.js from those settings.

If you are unable to resolve your issue using the troubleshooting steps above, please reach out to the official support channels.

For bugs, feature requests, or complex integration issues, visit the Supervised AI Support portal:

When contacting support, please provide the following details to speed up the resolution process: