Bot ID Mapping
Bot ID Mapping
To display a specific chatbot on your WordPress site, the plugin uses a sequence-based ID system. This system maps the position of a URL in your settings to a specific numeric ID in the shortcode.
How Mapping Works
The mapping is determined by the line number of the URL you enter in the Supervised AI Bots settings page. The plugin reads the list from top to bottom, assigning IDs starting from 1.
| Line Number | URL Example | Shortcode ID |
| :--- | :--- | :--- |
| Row 1 | https://bot.supervised.co/bot-alpha | [supervised_ai_bot id="1"] |
| Row 2 | https://bot.supervised.co/bot-beta | [supervised_ai_bot id="2"] |
| Row 3 | https://bot.supervised.co/bot-gamma | [supervised_ai_bot id="3"] |
Implementation Steps
- Configure URLs: Navigate to the Supervised AI Bots settings in your WordPress dashboard. In the provided textarea, enter your chatbot URLs. Ensure there is only one URL per line.
- Identify the ID: Note the row number of the bot you wish to embed.
- Insert Shortcode: Use the
supervised_ai_botshortcode in any post, page, or widget area, specifying theidattribute.
<!-- To display the chatbot from the first row -->
[supervised_ai_bot id="1"]
<!-- To display the chatbot from the second row -->
[supervised_ai_bot id="2"]
Important Considerations
- Order Matters: If you rearrange the URLs in the settings textarea, the IDs will automatically update based on their new positions. For example, if you move the URL from Row 2 to Row 1, the shortcode
[supervised_ai_bot id="1"]will now display that bot. - Sequential Numbering: Ensure there are no empty lines between URLs, as the plugin counts every line in the textarea to determine the ID mapping.
- Global Appearance: The chatbot will appear as a floating popup (toggleable via a circular button) on the specific page where the shortcode is placed.