ID & Row Mapping

The Supervised AI Bots plugin uses a simple row-based indexing system to link your chatbot URLs to specific pages or posts via shortcodes. Understanding how this mapping works is essential for displaying the correct bot on your site.

How Mapping Works

When you enter your Supervised AI chatbot URLs in the plugin settings, the plugin assigns an id to each URL based on its line position in the configuration textarea.

Row 1 corresponds to id="1"
Row 2 corresponds to id="2"
Row 3 corresponds to id="3"
...and so on.

Configuration Example

If your "Supervised AI Bots" settings page contains the following list:

https://supervised.co/bot/marketing-assistant
https://supervised.co/bot/customer-support
https://supervised.co/bot/sales-lead-gen

You would use the corresponding shortcodes to display those specific bots:

Usage in Content

To embed a bot, simply paste the shortcode into the WordPress block editor (Shortcode block) or the classic editor:

<!-- Display the Customer Support bot -->
[supervised_ai_bot id="2"]

Important Considerations

URL Order: If you rearrange the URLs in the settings textarea, the IDs will change. For example, if you move the URL from Row 2 to Row 1, any page using id="2" will now display the bot that was previously on Row 3 (or nothing if Row 3 is empty).
One URL Per Line: Ensure there are no empty lines between URLs, as the plugin counts every line.
Global IDs: The IDs are global across your entire WordPress site. Using id="1" on "Page A" and "Page B" will load the exact same chatbot URL.