Support & Troubleshooting

Troubleshooting

If you encounter issues displaying or interacting with your Supervised AI chatbots, please review the common solutions below before contacting support.

Chatbot Not Appearing

If the chatbot interface or the launcher bubble is not visible on your page, check the following:

1. Verify the Bot ID: Ensure the id used in the shortcode corresponds to the correct line number in your settings.
   • [supervised_ai_bot id="1"] targets the first URL entered in the settings textarea.
   • [supervised_ai_bot id="2"] targets the second URL, and so on.
2. Check URL Formatting: Ensure you have entered valid, full URLs (including https://) in the plugin settings. Each URL must be on its own line.
3. Shortcode Syntax: Ensure the shortcode is not wrapped in <pre> or <code> tags by your WordPress editor, as this can prevent it from executing.

Popup or Button Not Displaying

The plugin uses a fixed-position popup and a floating action button. If these are missing:

• Z-Index Conflicts: Some WordPress themes or other plugins may have elements with higher z-index values that cover the chatbot. The plugin uses a z-index of 9999 for the button and 1001 for the popup. If your theme's header or footer is appearing over the chat, you may need to add custom CSS to adjust your theme's layers.
• JavaScript Errors: If clicking the launcher button does nothing, check your browser's Console (F12) for JavaScript errors. Other plugins may be causing a script conflict that prevents the togglePopup() function from running.

Chatbot Content is Blank (IFrame Issues)

The chatbot is loaded via an iframe. If the popup opens but the content is blank:

• Mixed Content Warnings: If your site uses https:// but you provided an http:// URL for the chatbot, the browser will block the content for security reasons. Always use https://.
• X-Frame-Options: Ensure your Supervised AI bot URL allows embedding. If the bot's server sends a X-Frame-Options: DENY or SAMEORIGIN header, it will not display inside the WordPress plugin.

Appearance and Layout

If the chatbot looks cut off or is too small:

• The default popup width is 400px and the height is 670px.
• If your site is viewed on a very small mobile device, ensure your theme's responsive settings are not interfering with the .popup-container or .circle-button classes.

---

Support Resources

If your issue persists after following the troubleshooting steps above, please utilize the following resources:

Official Documentation

For the most up-to-date guides on configuration and advanced usage, visit the Supervised AI Website.

Technical Support

You can reach out to our support team for assistance with plugin-specific bugs or integration hurdles:

• Support Portal: Supervised AI Support

Reporting Bugs

When contacting support, please provide the following information to help us resolve your issue faster:

1. WordPress Version: (e.g., 6.4.x)
2. Plugin Version: (e.g., 1.0.0)
3. Shortcode Used: (e.g., [supervised_ai_bot id="1"])
4. Browser & Device: (e.g., Chrome on Windows 11)
5. Description of the Issue: Include screenshots or a link to the page where the issue is occurring.