Troubleshooting

Common Issues and Solutions

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

Shortcode is Not Rendering

If the shortcode [supervised_ai_bot id="X"] appears as plain text on your page or does not display anything:

• Check the ID Number: Ensure the id corresponds to the correct row number of the bot URL you entered in the settings. For example, if you want to display the first URL in your list, use id="1".
• Verify Plugin Activation: Ensure the plugin is activated under Plugins > Installed Plugins.
• Avoid Formatting in Editor: If you are using the WordPress Block Editor (Gutenberg), ensure the shortcode is placed inside a Shortcode Block. Sometimes, copying and pasting shortcodes into a Paragraph Block can add hidden HTML tags (like <code> or <span>) that break functionality.

Chatbot Popup Does Not Open

If you see the launcher button but clicking it does not open the chatbot window:

• JavaScript Conflicts: The plugin relies on a small JavaScript file to toggle the popup. Check your browser console (F12 > Console) for any "Uncaught ReferenceError" or scripts blocked by security plugins or "defer/delay" optimizations.
• URL Configuration: Ensure the URL provided in the settings page is valid and starts with https://. An incorrect URL may prevent the iframe from loading inside the popup.

Chatbot UI is Cut Off or Overlapping Content

The chatbot popup uses a fixed height of 670px and a width of 400px. If this conflicts with your theme:

• Z-Index Conflicts: If the chatbot appears behind your website's header or other elements, there may be a z-index conflict. The plugin uses a z-index of 9999 for the launcher. Check if your theme has elements with higher priority.
• Mobile Display: The popup is optimized for standard screen sizes. If it looks too large on mobile devices, check your theme’s mobile responsiveness settings or contact support for CSS customization tips.

"Bot Not Found" or Empty Popup

If the popup opens but shows a "404 Not Found" or a blank white screen:

• One URL Per Line: In the plugin settings, ensure that you have entered only one URL per line. Extra spaces, commas, or semicolons between URLs will cause the plugin to read the URL incorrectly.
• Iframe Permissions: Some websites prevent their content from being embedded in an iframe (using X-Frame-Options headers). Ensure that the URL you are using from Supervised AI is configured to allow embedding on your domain.

Plugin Settings Not Saving

If your chatbot URLs disappear after clicking "Save":

• User Permissions: Ensure you are logged in as an Administrator with permissions to modify plugin settings.
• Security Plugins: Some security plugins (like Wordfence) may block the saving of URLs in the database if they perceive them as suspicious. If this happens, "whitelist" the action in your security plugin's firewall settings.

---

Technical Debugging

If the steps above do not resolve your issue, you can perform a deeper check:

1. Inspect Element: Right-click the chatbot button and select Inspect. Look for the .popup-container and .circle-button classes in the HTML.
2. Clear Cache: If you use a caching plugin (e.g., WP Rocket, W3 Total Cache) or a CDN (e.g., Cloudflare), clear all caches after updating your chatbot URLs to ensure the new configuration is loaded.
3. Theme Switch: Temporarily switch to a default WordPress theme (like Twenty Twenty-Four). If the bot works, the issue is a conflict with your specific theme’s CSS or JavaScript.

For further assistance, please visit the Supervised AI Support Page.