Connecting Bot URLs
Connecting Bot URLs
To display a chatbot on your WordPress site, you must first link your Supervised AI instances within the plugin settings. This process maps your external bot URLs to specific IDs that can be called via shortcodes.
Configuring the Bot List
- Navigate to the Supervised AI Bots settings page in your WordPress admin dashboard.
- Locate the Bot URLs textarea.
- Enter the full URL of each Supervised AI chatbot you wish to use.
- Important: Place each URL on its own line. Do not use commas, semicolons, or other delimiters to separate them.
Example Configuration:
https://app.supervised.co/widget/your-bot-id-1
https://app.supervised.co/widget/your-bot-id-2
https://app.supervised.co/widget/your-bot-id-3
URL to ID Mapping
The plugin automatically assigns an ID to each bot based on its row number in the textarea. This ID is used in the shortcode to determine which bot to render on a specific page.
| Line Number | Assigned 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"] |
Usage in Content
Once you have saved your URLs, you can embed the bots into any Post or Page using the following shortcode structure:
[supervised_ai_bot id="YOUR_BOT_ID"]
Replace YOUR_BOT_ID with the corresponding row number from your settings. For example, to display the chatbot listed on the second line of your settings, use:
[supervised_ai_bot id="2"]
Best Practices for URLs
- Full Protocols: Always include the
https://prefix to ensure the iframe loads correctly and securely. - Avoid Empty Lines: Do not leave empty lines between URLs, as this may shift the ID mapping for subsequent bots.
- Validation: Ensure the URL is the direct "Widget" or "Public" URL provided by your Supervised AI dashboard.