Managing Bot URLs
Adding Bot URLs
To display your Supervised AI chatbots on your WordPress site, you must first register their unique source URLs within the plugin settings. The plugin uses a line-based configuration system to manage multiple bot instances simultaneously.
Configuration Steps
- Log in to your WordPress Admin dashboard.
- Navigate to the Supervised AI Bots settings page in the sidebar menu.
- Locate the text area labeled for chatbot URLs.
- Enter your chatbot URLs, ensuring that each URL is placed on its own line.
- Click Save Changes.
Understanding URL Mapping
The plugin automatically assigns an id to each chatbot based on its row position in the settings text area. This ID is used within the shortcode to identify which bot to render on the frontend.
| Line Number (Row) | Example URL | Corresponding Shortcode |
| :--- | :--- | :--- |
| Line 1 | https://supervised.co/bot/sales-assistant | [supervised_ai_bot id="1"] |
| Line 2 | https://supervised.co/bot/customer-support | [supervised_ai_bot id="2"] |
| Line 3 | https://supervised.co/bot/product-guide | [supervised_ai_bot id="3"] |
Best Practices for Organization
To ensure your chatbots load correctly and maintain consistent IDs, follow these formatting guidelines:
- Avoid Empty Lines: Do not leave blank lines between URLs. An empty line may be counted as a row, which can lead to broken iframes or incorrect ID mapping.
- Sequential Ordering: If you remove a URL from the middle of the list, the IDs for all subsequent bots will shift upward. Always double-check your page/post shortcodes if you reorder the list in the settings.
- One URL per Line: Do not use commas, semicolons, or any other delimiters. The plugin relies strictly on the newline character to separate bot entries.
Usage Example
Once you have added your URLs in the settings, you can embed a specific bot into any post, page, or widget area using the shortcode:
<!-- Displays the bot listed on the first line of your settings -->
[supervised_ai_bot id="1"]
<!-- Displays the bot listed on the second line of your settings -->
[supervised_ai_bot id="2"]
When the shortcode is processed, the plugin will generate a floating action button (a circle button at the bottom right of the screen) that opens the corresponding Supervised AI bot URL in a secure popup container.