Admin Settings Page

Accessing the Administration Page

Once the plugin is activated, you can manage your chatbots through a dedicated settings page in the WordPress dashboard.

1. Log in to your WordPress Admin area.
2. Locate Supervised AI Bots in the left-hand sidebar menu.
3. Click the menu item to open the configuration interface.

Configuring Chatbot URLs

The administration interface features a simple, centralized text area for managing your bot integrations. This plugin uses a line-based indexing system to identify individual chatbots.

Adding Bots

To add your chatbots, enter the full URL of the Supervised AI bot into the Bot URLs textarea.

• Format: Enter one URL per line.
• Protocol: Ensure you include the full protocol (e.g., https://).
• Ordering: The order in which you list the URLs determines their id for shortcode usage.

Example Configuration:

https://app.supervised.co/bot/example-bot-1
https://app.supervised.co/bot/customer-service-bot
https://app.supervised.co/bot/sales-assistant

URL to ID Mapping

The plugin automatically assigns a numerical ID based on the line number of the URL in the settings field.

| Line Number | URL Content | Shortcode ID | | :--- | :--- | :--- | | Line 1 | https://app.supervised.co/bot/1 | id="1" | | Line 2 | https://app.supervised.co/bot/2 | id="2" | | Line 3 | https://app.supervised.co/bot/3 | id="3" |

[!IMPORTANT] If you remove a URL from the middle of the list or change the order, the IDs for existing shortcodes on your site may shift. Always verify your shortcode IDs after updating the list.

Shortcode Implementation

After saving your settings, you can display a specific bot on any Page or Post using the [supervised_ai_bot] shortcode.

Usage Syntax

[supervised_ai_bot id="YOUR_BOT_ID"]

Examples

• To display the first bot in your list: [supervised_ai_bot id="1"]
• To display the third bot in your list: [supervised_ai_bot id="3"]

Visual & Behavior Defaults

The settings page configures the source data, while the plugin's internal styles and scripts handle the presentation. When a bot is rendered via shortcode, the following default behaviors are applied:

• Trigger: A circular blue floating action button (FAB) appears at the bottom-right of the screen.
• Dimensions: The chat interface opens in a popup container with a fixed height of 670px and a standard width of 400px (expandable up to 800px on supported screens).
• Placement: The popup is fixed to the bottom-right corner to ensure it does not interfere with primary site content.
• Interface: The bot URL is loaded within a secure iframe inside the popup container.