Common Issues

Common Issues and Troubleshooting

This section provides solutions for the most frequent issues encountered when setting up and using the Supervised AI Bots plugin.

If you have added the shortcode but the chatbot does not appear, check the following:

Incorrect ID Reference: The id attribute in the shortcode corresponds to the line number of the URL in your settings. For example, [supervised_ai_bot id="1"] loads the first URL listed in the plugin settings. If you only have one URL and use id="2", the bot will not display.
Empty URL List: Ensure you have saved your bot URLs in the Supervised AI Bots settings page. Each URL must be on a new line.
Shortcode Syntax: Ensure the shortcode is written exactly as [supervised_ai_bot id="X"] (replacing X with the row number). Using curly braces or incorrect quotes may prevent WordPress from processing the tag.

If the floating action button (blue circle) is visible but clicking it does not open the chat window:

JavaScript Conflicts: Some themes or optimization plugins (like minifiers or "defer JS" tools) may interfere with the plugin's script. Check your browser console (F12 > Console) for any errors related to togglePopup or closePopup.
Z-Index Overlap: If your theme has a very high z-index for its footer or other fixed elements, the popup container might be opening "behind" other elements. The plugin uses a default z-index of 1001 for the popup and 9999 for the button.
Cache Issues: After activating the plugin or changing settings, clear your WordPress site cache (e.g., WP Rocket, W3 Total Cache) and your browser cache to ensure the latest scripts are loading.

If the popup opens but the iframe inside is empty or shows a connection error:

Mixed Content (SSL): If your website uses https:// but you provided a bot URL starting with http://, most modern browsers will block the content for security reasons. Always use secure https:// URLs.
X-Frame-Options: The Supervised AI URL you are using must allow "iframing." If the bot provider has restricted their URL from being embedded in an iframe, the browser will block the content. Ensure your Supervised AI instance is configured to allow your website's domain.

The chatbot popup has a fixed width of 400px and a height of 670px. If this does not fit your theme's layout:

CSS Overrides: You can adjust the appearance by adding Custom CSS to your theme (Appearance > Customize > Additional CSS).

To change the button color:

.circle-button {
    background-color: #YOUR_COLOR_CODE !important;
}

To adjust the popup size for mobile:

@media screen and (max-width: 480px) {
    .popup-container {
        width: 90% !important;
        right: 5% !important;
    }
}

If you see the literal text [supervised_ai_bot id="1"] on your live site instead of the chatbot:

Plugin Activation: Verify that the plugin is active under the Plugins menu.
Widget Support: If you are using the shortcode inside a Sidebar or Footer widget, ensure your theme supports shortcodes in widgets. Most modern versions of WordPress support this by default, but some older themes may require a "Shortcode" block or custom HTML block.