ID & Row Mapping
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:
| Bot Purpose | Row Number | Shortcode to Use |
| :--- | :--- | :--- |
| Marketing Assistant | 1 | [supervised_ai_bot id="1"] |
| Customer Support | 2 | [supervised_ai_bot id="2"] |
| Sales Lead Gen | 3 | [supervised_ai_bot id="3"] |
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.