{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":4458,"path":"conversational-interfaces/ac-configure-bot-portal.md","title":"Add your bot to a portal","bundle":null,"doc_type":null,"release":"australia","body":"\n# Add your bot to a portal\n\nGive your users a place to interact with your bot and human agents. Choose a Service Portal chat configuration provided with your base system, such as the Service Portal Agent Chat configuration used for Agent Chat and Virtual Agent. Your end users can initiate and maintain a bot or Agent Chat conversation in any page of the portal.\n\n## Before you begin\n\nActivate the Glide Virtual Agent \\(com.glide.cs.chatbot\\) or the Agent Chat \\(com.glide.interaction.awa\\) plugin. You can activate the Glide Virtual Agent plugin only if you have a subscription.\n\nRole required: admin\n\n## Procedure\n\n1. Navigate to **All** > **Conversational Interfaces** > **Home**.\n\n2. Under **Add your bot to a portal**, select **Add to portal** to configure the base system portal.\n\n For example, to configure the portal used for Agent Chat and Virtual Agent, select Service Portal Agent Chat Config.\n\n3. On the form, update the portal configuration.\n\n\n
\n\nField\n\n\n\nDescription\n\n
\n\nActive\n\n\n\nOption to make the configuration active. The base system Service Portal configurations are automatically active.\n\n
\n\nName\n\n\n\nUnique name for the configuration record.\n\n
\n\nPortals\n\n\n\nThe portals in which you would like to use this chat configuration. If no portal is selected, the configuration applies to all portals in the system.\n\n
\n\nApplication\n\n\n\nRead-only application scope for the record.\n\n
\n\nPublic\n\n\n\nOption to make the portal available to users before they log in.\n\n
\n\nRoles\n\n\n\nRoles that a user must have to use the portal. If you don't select a role, Agent Chat and Virtual Agent is available to all users regardless of their role.\n\n
\n\nOrder\n\n\n\nNumber that indicates the order in which the configurations should run. Only one configuration applies per portal. If there are multiple configurations on a portal, the system runs the first configuration found from lowest to highest.\n\n
\n\nServer script\n\n\n\nA script that passes page and widget data to an Agent Chat conversation when a user initiates the conversation. For example, pass a field to the chat conversation to enable Agent Chat to access the value. Data passed in this script is available to every page in the portal associated with this record. This script has access to the [GlideSPScriptable](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/api-reference/server-api-reference/c_GlideSPScriptableScopedAPI.md) API.\n\n **Note:** The portal suffix, page ID, and language are automatically available to Agent Chat and do not require a custom script. Sys ID and table are automatically available to Agent Chat when they are present in the URL.\n\n The following example returns an object containing the list of catalogs associated with the portal to the current conversation.\n\n ```\n(function ($sp) { \n return { \n catalogs: $sp.getValue(‘catalogs’) \n };\n})($sp);\n```\n\n When Agent Chat opens in an `iframe` HTML element, the list of catalogs is included in the `iframe` URL. Parameters from this field override any conflicting page data passed to Agent Chat.\n\n
4. Select **Update**.\n\n\n## Result\n\nYour end users can initiate and maintain an Agent Chat or Virtual Agent conversation from any page in the selected portal.\n\n## What to do next\n\n- **See your portal in action**\n\n Return to Conversational Interfaces Home and under **Add your bot to a portal**, select the second navigation dot at the bottom of the card. When the card changes to **Interact with your bot**, use the **Open portal** menu to select the portal to view. When the specified portal page opens, select the chat icon in the lower right corner to start a bot conversation.\n\n- **Configure other Service Portal Agent Chat features**\n\n In Service Portal, you can customize the Agent Chat button and pass page data to Agent Chat. For more information, see [Configure Agent Chat in Service Portal](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/platform-user-interface/configure-va-in-sp.md).\n\n\n**Parent Topic:**[General chat settings](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/conversational-interfaces/ci-configuring-chat-features.md)\n\n"}}