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 id attribute 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 is id="2", and so on.
- Ensure there are no extra spaces or quotes around the number (e.g., use [supervised_ai_bot id="1"]).
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 to display: 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 an HTTP iframe from loading on an HTTPS site.
X-Frame-Options: The Supervised AI URL you are using must allow embedding. If the bot provider has set an X-Frame-Options: DENY or SAMEORIGIN header, 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-index of 9999 for the button and 1001 for 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 togglePopup or custom-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.js from 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 60px circle 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.