Bot Management Settings
Configuring Bot URLs
To manage your AI chatbots, navigate to the Supervised AI Bots menu in your WordPress Admin Dashboard. This interface allows you to register multiple bot instances by providing their source URLs.
Adding New Bots
- Locate the Chatbot URLs textarea field.
- Enter the full URL of your Supervised AI chatbot (e.g.,
https://supervised.co/bot/your-unique-id). - To add multiple bots, enter each URL on a new line.
- Click Save Changes to register the bots.
Understanding Bot IDs
The plugin assigns a unique ID to each bot based on its line number in the settings textarea. This ID is required when using shortcodes to display the bot on your site.
| Line Number | Bot ID | Shortcode Example |
| :--- | :--- | :--- |
| Line 1 | 1 | [supervised_ai_bot id="1"] |
| Line 2 | 2 | [supervised_ai_bot id="2"] |
| Line 3 | 3 | [supervised_ai_bot id="3"] |
Note: If you remove a URL from the middle of the list, the IDs of the bots listed below it will shift. Ensure your shortcodes are updated if you reorder the list.
Shortcode Implementation
Once your URLs are saved, you can embed the chatbots into any Page, Post, or Widget area using the supervised AI shortcode.
Basic Usage
To display the first bot in your list:
[supervised_ai_bot id="1"]
Usage in PHP Templates
If you need to hardcode a specific bot into a WordPress theme template, use the do_shortcode function:
<?php echo do_shortcode('[supervised_ai_bot id="1"]'); ?>
UI and Appearance
When a bot is successfully configured and added via shortcode, the following behavior occurs on the frontend:
- Launcher Button: A blue circular floating button appears at the bottom-right corner of the page.
- Chat Popup: Clicking the button toggles a responsive chat window (400px width, 670px height).
- Embedded Frame: The Supervised AI interface is loaded securely via an iframe within the popup container.
Troubleshooting Settings
- Bot not appearing: Ensure the URL entered in the settings is valid and that the ID in your shortcode matches the line number of the URL.
- Display issues: The plugin uses a fixed
z-indexof9999for the launcher to ensure it stays above most theme elements. If your theme has elements covering the bot, you may need to adjust your theme's CSS.