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:
- Verify the Bot ID: Ensure the
idused 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.
- Check URL Formatting: Ensure you have entered valid, full URLs (including
https://) in the plugin settings. Each URL must be on its own line. - 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-indexvalues that cover the chatbot. The plugin uses az-indexof9999for the button and1001for 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 anhttp://URL for the chatbot, the browser will block the content for security reasons. Always usehttps://. - X-Frame-Options: Ensure your Supervised AI bot URL allows embedding. If the bot's server sends a
X-Frame-Options: DENYorSAMEORIGINheader, 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
400pxand the height is670px. - If your site is viewed on a very small mobile device, ensure your theme's responsive settings are not interfering with the
.popup-containeror.circle-buttonclasses.
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:
- WordPress Version: (e.g., 6.4.x)
- Plugin Version: (e.g., 1.0.0)
- Shortcode Used: (e.g.,
[supervised_ai_bot id="1"]) - Browser & Device: (e.g., Chrome on Windows 11)
- Description of the Issue: Include screenshots or a link to the page where the issue is occurring.