Admin Settings Interface
Accessing the Settings Interface
To configure your chatbots, log in to your WordPress admin dashboard and navigate to the Supervised AI Bots menu item located in the sidebar. This page provides a centralized interface for managing all your chatbot integrations.
Configuring Chatbot URLs
The primary function of the settings interface is the management of your Supervised AI chatbot source URLs. These URLs connect the WordPress plugin to your specific bot instances hosted on the Supervised AI platform.
Adding Chatbots
In the provided textarea, enter the full URL of your Supervised AI chatbots.
- Format: Enter one URL per line.
- Order Matters: The position of the URL determines its unique ID, which is required for the shortcode implementation.
https://supervised.co/bot/example-bot-1
https://supervised.co/bot/example-bot-2
ID Assignment Logic
The plugin automatically assigns an integer ID to each chatbot based on its row number in the settings field:
- Row 1 =
id="1" - Row 2 =
id="2" - Row N =
id="n"
[!TIP] Keep a record of the order of your URLs. If you rearrange the lines or delete a middle row, the IDs for subsequent bots will change, which may affect chatbots already embedded on your site.
Shortcode Integration
Once you have saved your URLs in the admin interface, you can display the chatbots anywhere on your site using the WordPress shortcode system.
Basic Syntax
Use the following shortcode within the WordPress block editor, classic editor, or inside template files:
[supervised_ai_bot id="YOUR_BOT_ID"]
Implementation Example
If you want to display the chatbot listed on the first line of your settings:
<!-- Display the chatbot from the first URL line -->
[supervised_ai_bot id="1"]
Saving Changes
After entering or updating your chatbot URLs, click the Save Settings button.
- Validation: Ensure there are no empty lines between URLs, as this may result in skipped IDs.
- Updates: Changes saved in the admin interface take effect immediately across all pages where the corresponding shortcodes are active.
Technical Preview
The admin interface manages the backend configuration for a frontend popup component. When a shortcode is triggered:
- The plugin identifies the URL associated with the provided
id. - It generates a floating chat trigger (circle button) on the bottom right of the page.
- The chatbot URL is loaded securely within an iframe inside a responsive popup container.