Introduction
Overview
The wpai (Supervised AI Bots) plugin is the official WordPress integration for Supervised AI. It provides a streamlined way to deploy intelligent, supervised chatbots across your WordPress website, enhancing visitor engagement and automating customer interactions.
By bridging the gap between your Supervised AI instances and your WordPress frontend, this plugin allows you to manage multiple chatbot configurations from a centralized dashboard and deploy them to specific pages, posts, or site-wide areas using intuitive shortcodes.
Key Features
- Multi-Bot Management: Configure and maintain multiple Supervised AI chatbot URLs within a single administrative interface.
- Shortcode Integration: Easily embed specific chatbots into any WordPress content area using a simple
[supervised_ai_bot]shortcode. - Interactive Popup Interface: Chatbots are presented in a modern, non-intrusive floating popup triggered by a circular action button, ensuring a seamless user experience that doesn't disrupt page content.
- Customizable Deployment: Choose exactly which bot appears on which page by referencing its unique ID.
- Responsive Design: The chatbot interface is styled to be mobile-friendly and persists in a fixed position for easy access.
Core Concepts
The Admin Interface
After installation, the plugin adds a Supervised AI Bots menu to your WordPress dashboard. This is where you input the source URLs for your Supervised AI chatbots. Each URL corresponds to a specific bot instance you have created on the Supervised AI platform.
The plugin interprets these URLs as a list, where the first line is ID 1, the second line is ID 2, and so on. These IDs are essential for frontend deployment.
Frontend Display
Once a shortcode is placed on a page, the plugin renders:
- A Floating Action Button: A circular button (usually positioned at the bottom-right) that users click to open the chat.
- A Chat Popup: A sleek iframe container that loads your Supervised AI chatbot interface directly on the page without requiring a reload.
Usage
The primary way to interact with the plugin as a user is through the WordPress Shortcode API.
Displaying a Chatbot
To display a specific chatbot, use the following syntax in the WordPress block editor, classic editor, or within your theme's PHP files:
[supervised_ai_bot id="1"]
Parameters
| Attribute | Type | Description |
| :--- | :--- | :--- |
| id | Integer | The row number of the bot URL as entered in the plugin settings page (e.g., 1 for the first URL). |
Example Implementation
If you have configured three different bots for Sales, Support, and FAQ, you can deploy them to their respective pages as follows:
On the "Contact Us" page:
[supervised_ai_bot id="2"]
On the "Product Documentation" page:
[supervised_ai_bot id="3"]
Technical Support
For further assistance regarding chatbot configuration or account-related inquiries, please visit the Supervised AI Support Portal.