Troubleshooting Guide
Troubleshooting Guide
If you encounter issues with the Supervised AI Bots plugin, follow these steps to diagnose and resolve common problems.
1. Chatbot Not Displaying on Page
If the chatbot interface or the floating button does not appear on your page after adding the shortcode, check the following:
- Verify the Shortcode ID: The
idattribute in[supervised_ai_bot id="X"]corresponds to the row number of the URL you entered in the plugin settings.- Example: If you have three URLs, the first URL is
id="1", the second isid="2", and so on. - Ensure there are no extra spaces or quotes around the number (e.g., use
[supervised_ai_bot id="1"]).
- Example: If you have three URLs, the first URL is
- Check the URL List: Navigate to Supervised AI Bots in your WordPress dashboard. Ensure you have entered the full URL (including
https://) and that there is only one URL per line. - Theme Conflicts: Some WordPress themes may have styles that hide fixed-position elements. Inspect the page source to see if the
<div class="popup-container">is present in the HTML but set todisplay: none.
2. Floating Button Appears, but Popup is Empty
If the blue circle button appears but the popup window is blank or shows a "Refused to Connect" error:
- Mixed Content Errors: Ensure your WordPress site and the Supervised AI URL both use
HTTPS. Browsers will block anHTTPiframe from loading on anHTTPSsite. - X-Frame-Options: The Supervised AI URL you are using must allow embedding. If the bot provider has set an
X-Frame-Options: DENYorSAMEORIGINheader, the bot cannot be displayed in a WordPress iframe. - Invalid URL: Copy and paste the bot URL directly into your browser address bar to ensure it is active and accessible.
3. Popup is Hidden Behind Other Elements
If the chatbot button or window is partially covered by your theme's header, footer, or other plugins:
- Z-Index Conflict: The plugin uses a
z-indexof9999for the button and1001for the popup. If your theme uses higher values, you may need to add custom CSS to your theme to bring the chatbot forward:.circle-button { z-index: 99999 !important; } .popup-container { z-index: 99998 !important; }
4. Click Action Does Not Open the Bot
If clicking the floating button does nothing:
- JavaScript Errors: Open your browser's Developer Tools (F12) and check the Console tab. Look for errors related to
togglePopuporcustom-popup-script.js. - Script Optimization Plugins: If you use caching or optimization plugins (like WP Rocket or Autoptimize), they may be delaying or minifying the plugin's JavaScript incorrectly. Try clearing your site cache or excluding
custom-popup-script.jsfrom minification.
5. Layout or Sizing Issues
The bot popup is designed with a fixed height of 670px and a width of 400px.
- Mobile View: If the bot appears too large on mobile devices, ensure your theme's viewport meta tag is correctly set.
- Overlapping Content: If the
60pxcircle button overlaps important site content (like a "Back to Top" button), you can adjust its position in your site's "Additional CSS" section:.circle-button { bottom: 80px !important; /* Moves the button higher */ }
Still having trouble? If these steps do not resolve your issue, please contact our support team at Supervised AI Support with a link to the page where the bot is installed.