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.
Chatbot Not Displaying
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
idattribute 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".
- Example: If you have three URLs, the third one is accessed via
- Empty Settings: Verify that you have actually saved the chatbot URLs in the Supervised AI Bots settings page.
Empty or "Refused to Connect" Popup
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 useshttps. Most browsers blockhttpiframes onhttpssites for security. - X-Frame-Options: Ensure the Supervised AI instance allows its interface to be embedded via iframes. If the external server sends a
DENYorSAMEORIGINheader, the bot will not load.
Layout and UI Conflicts
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-indexconflict. The plugin uses a defaultz-indexof9999for the button and1001for 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 theiframe-containerscales appropriately.
JavaScript Conflicts
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.jsfile 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.jsfrom those settings.
Official Support
If you are unable to resolve your issue using the troubleshooting steps above, please reach out to the official support channels.
Technical Assistance
For bugs, feature requests, or complex integration issues, visit the Supervised AI Support portal:
- Support Website: Supervised AI Support
Information to Include
When contacting support, please provide the following details to speed up the resolution process:
- Your WordPress version.
- The version of the Supervised AI Bots plugin you are using.
- A link to the page where the chatbot is supposed to appear.
- A screenshot of any errors visible in the browser console.