Chatbot ID Mapping
Chatbot ID Mapping
The Supervised AI Bots plugin uses a sequential ID mapping system to determine which chatbot to display when using the shortcode. This mapping is directly tied to the order in which you enter your chatbot URLs in the plugin settings.
How IDs are Assigned
When you enter your chatbot URLs into the Supervised AI Bots settings textarea, the plugin assigns a numerical ID to each URL based on its row position.
- Line 1 in the text area corresponds to
id="1" - Line 2 in the text area corresponds to
id="2" - Line 3 in the text area corresponds to
id="3" - ...and so on.
Configuration Example
If your settings textarea looks like this:
https://app.supervised.co/bot/customer-support
https://app.supervised.co/bot/sales-inquiry
https://app.supervised.co/bot/technical-docs
The mapping will be established as follows:
| Row Number | Chatbot URL | Shortcode |
| :--- | :--- | :--- |
| 1 | .../customer-support | [supervised_ai_bot id="1"] |
| 2 | .../sales-inquiry | [supervised_ai_bot id="2"] |
| 3 | .../technical-docs | [supervised_ai_bot id="3"] |
Using the Shortcode
To deploy a specific bot on a WordPress page or post, use the assigned ID within the id attribute of the shortcode.
Example: Deploying the Sales Inquiry bot (Line 2)
[supervised_ai_bot id="2"]
Important Considerations
- Sequential Order: If you remove a URL from the middle of your list, the IDs of all subsequent bots will shift. For example, if you delete the URL on Line 1, the URL previously on Line 2 will now become ID 1.
- Empty Lines: Avoid leaving blank lines between URLs, as the plugin counts every line (including empty ones) when calculating the row index.
- One URL per Line: Ensure each Supervised AI bot URL is on its own dedicated line to maintain accurate ID mapping.