Troubleshooting

This section covers common issues you might encounter while setting up or using the Supervised AI Bots plugin.

If the chatbot launcher or the shortcode output is not visible, check the following:

Plugin Activation: Ensure the plugin is activated under Plugins > Installed Plugins.
Correct ID Reference: The id attribute in the shortcode refers to the line number of the URL in your settings.
- If your bot URL is on the first line, use [supervised_ai_bot id="1"].
- If your bot URL is on the second line, use [supervised_ai_bot id="2"].
Shortcode Syntax: Ensure you are using straight quotes (") rather than "curly" or "smart" quotes (”) in your shortcode. Correct usage: [supervised_ai_bot id="1"].

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

URL Format: Verify that the URL entered in the settings page is complete and includes the protocol (e.g., https://supervised.co/your-bot-url).
SSL/HTTPS Conflicts: If your site is running on https, your chatbot URL must also use https. Browsers will block "Mixed Content" (HTTP content on an HTTPS site).
X-Frame-Options: Ensure your Supervised AI bot settings allow embedding via iframes. If the bot's server sends an X-Frame-Options: DENY or SAMEORIGIN header, the bot will not load inside the WordPress site.

If the chatbot button or popup is appearing behind your website's header, footer, or other UI elements:

Z-Index Conflicts: The plugin uses a z-index of 9999 for the launcher button and 1001 for the popup container. If your theme uses higher values, you may need to add custom CSS to your theme to bring the bot forward:
```
.circle-button {
    z-index: 99999 !important;
}
.popup-container {
    z-index: 99998 !important;
}
```

If clicking the circular button does not open the chat window:

JavaScript Conflicts: Open your browser's developer tools (F12 or Right-click > Inspect) and check the Console tab for errors. Another plugin or your theme may be causing a script error that prevents custom-popup-script.js from executing.
Caching Plugins: If you use a caching or "minification" plugin (like WP Rocket or Autoptimize), try clearing the cache. These plugins can sometimes delay or break the execution of the togglePopup() function.

The chatbot container is designed with a fixed height and width (670px height, 400px width).

Mobile View: On very small screens, the 400px width might exceed the viewport. If the bot looks cut off, you may need to apply a media query in your WordPress Additional CSS:
```
@media (max-width: 480px) {
    .popup-container {
        width: 90% !important;
        right: 5% !important;
    }
}
```

If your issue is not resolved by the steps above, please visit the Supervised AI Support page for further assistance.