GETTING STARTED
Kore.ai XO Platform
Virtual Assistants Overview
Natural Language Processing (NLP)
Concepts and Terminology
Quick Start Guide
Accessing the Platform
Navigating the Kore.ai XO Platform
Building a Virtual Assistant
Help & Learning Resources
Release Notes
Current Version
Recent Updates
Previous Versions
Deprecations
Request a Feature
CONCEPTS
Design
Storyboard
Overview
FAQs
Conversation Designer
Overview
Dialog Tasks
Mock Scenes
Dialog Tasks
Overview
Navigate Dialog Tasks
Build Dialog Tasks
Node Types
Overview
Intent Node
Dialog Node
Dynamic Intent Node
GenAI Node
GenAI Prompt
Entity Node
Form Node
Confirmation Node
Message Nodes
Logic Node
Bot Action Node
Service Node
Webhook Node
Script Node
Process Node
Agent Transfer
Node Connections
Node Connections Setup
Sub-Intent Scoping
Entity Types
Entity Rules
User Prompts or Messages
Voice Call Properties
Knowledge AI
Introduction
Knowledge Graph
Introduction
Terminology
Build a Knowledge Graph
Manage FAQs
Knowledge Extraction
Import or Export Knowledge Graph
Prepare Data for Import
Importing Knowledge Graph
Exporting Knowledge Graph
Auto-Generate Knowledge Graph
Knowledge Graph Analysis
Answer from Documents
Alert Tasks
Small Talk
Digital Skills
Overview
Digital Forms
Digital Views
Introduction
Widgets
Panels
Session and Context Variables
Context Object
Intent Discovery
Train
NLP Optimization
ML Engine
Overview
Model Validation
FM Engine
KG Engine
Traits Engine
Ranking and Resolver
Training Validations
NLP Configurations
NLP Guidelines
LLM and Generative AI
Intelligence
Introduction
Event Handlers
Contextual Memory
Contextual Intents
Interruption Management
Multi-intent Detection
Amending Entities
Default Conversations
Conversation Driven Dialog Builder
Sentinment Management
Tone Analysis
Default Standard Responses
Ignore Words & Field Memory
Test & Debug
Overview
Talk to Bot
Utterance Testing
Batch Testing
Conversation Testing
Conversation Testing Overview
Create a Test Suite
Test Editor
Test Case Assertion
Test Case Execution Summary
Glossary
Health and Monitoring
NLP Health
Flow Health
Integrations
Actions
Actions Overview
Asana
Configure
Templates
Azure OpenAI
Configure
Templates
BambooHR
Configure
Templates
Bitly
Configure
Templates
Confluence
Configure
Templates
DHL
Configure
Templates
Freshdesk
Configure
Templates
Freshservice
Configure
Templates
Google Maps
Configure
Templates
Here
Configure
Templates
HubSpot
Configure
Templates
JIRA
Configure
Templates
Microsoft Graph
Configure
Templates
Open AI
Configure
Templates
Salesforce
Configure
Templates
ServiceNow
Configure
Templates
Stripe
Configure
Templates
Shopify
Configure
Templates
Twilio
Configure
Templates
Zendesk
Configure
Templates
Agents
Agent Transfer Overview
Custom (BotKit)
Drift
Genesys
Intercom
NiceInContact
NiceInContact(User Hub)
Salesforce
ServiceNow
Configure Tokyo and Lower versions
Configure Utah and Higher versions
Unblu
External NLU Adapters
Overview
Dialogflow Engine
Test and Debug
Deploy
Channels
Publishing
Versioning
Analyze
Introduction
Dashboard Filters
Overview Dashboard
Conversations Dashboard
Users Dashboard
Performance Dashboard
Custom Dashboards
Introduction
Custom Meta Tags
Create Custom Dashboard
Create Custom Dashboard Filters
NLP Insights
Task Execution Logs
Conversations History
Conversation Flows
Conversation Insights
Feedback Analytics
Usage Metrics
Containment Metrics
Universal Bots
Introduction
Universal Bot Definition
Universal Bot Creation
Training a Universal Bot
Universal Bot Customizations
Enabling Languages
Store
Manage Assistant
Team Collaboration
Plan & Usage
Overview
Usage Plans
Templates
Support Plans
Invoices
Authorization
Conversation Sessions
Multilingual Virtual Assistants
Get Started
Supported Components & Features
Manage Languages
Manage Translation Services
Multiingual Virtual Assistant Behavior
Feedback Survey
Masking PII Details
Variables
Collections
IVR Settings
General Settings
Assistant Management
Manage Namespace
Data
Overview
Data Table
Table Views
App Definitions
Data as Service
HOW TOs
Build a Travel Planning Assistant
Travel Assistant Overview
Create a Travel Virtual Assistant
Design Conversation Skills
Create an ‘Update Booking’ Task
Create a Change Flight Task
Build a Knowledge Graph
Schedule a Smart Alert
Design Digital Skills
Configure Digital Forms
Configure Digital Views
Train the Assistant
Use Traits
Use Patterns
Manage Context Switching
Deploy the Assistant
Use Bot Functions
Use Content Variables
Use Global Variables
Use Web SDK
Build a Banking Assistant
Design Conversation Skills
Create a Sample Banking Assistant
Create a Transfer Funds Task
Create a Update Balance Task
Create a Knowledge Graph
Set Up a Smart Alert
Design Digital Skills
Configure Digital Forms
Configure Digital Views
Add Data to Data Tables
Update Data in Data Tables
Add Data from Digital Forms
Train the Assistant
Composite Entities
Use Traits
Use Patterns for Intents & Entities
Manage Context Switching
Deploy the Assistant
Configure an Agent Transfer
Use Assistant Functions
Use Content Variables
Use Global Variables
Intent Scoping using Group Node
Analyze the Assistant
Create a Custom Dashboard
Use Custom Meta Tags in Filters
Migrate External Bots
Google Dialogflow Bot
APIs & SDKs
API Reference
API Introduction
API List
koreUtil Libraries
SDK Reference
SDK Introduction
SDK Security
SDK Registration
Web Socket Connect and RTM
Installing the BotKit SDK
Using the BotKit SDK
SDK Events
SDK Functions
SDK Tutorials
BotKit - Blue Prism
BotKit - Flight Search Sample VA
BotKit - Agent Transfer
Widget SDK Tutorial
Web SDK Tutorial
ADMINISTRATION
Introduction to Admin Console
Administration Dashboard
User Management
Add Users
Manage Groups
Manage Roles
Data Tables and Views
Assistant Management
Enrollment
Invite Users
Send Bulk Invites
Import User Data
Synchronize Users from AD
Security & Control
Using Single-Sign On (SSO)
Two-Factor Authentication (2FA)
Security Settings
Cloud Connector
Analytics
Billing
  1. Home
  2. Integrations
  3. Configuring the ServiceNow Agent – Utah and Higher versions

Configuring the ServiceNow Agent – Utah and Higher versions

ServiceNow helps you build digital workflows on a single, unified platform. Kore.ai XO Platform’s ServiceNow Agent integration allows you to seamlessly hand off the virtual assistant conversations to your live agents on ServiceNow. 

This post provides the configuration steps to enable the ServiceNow Agent integration for Utah, Vancouver, and higher versions of the ServiceNow system. Use the configurations provided below as general guidelines, as there could be some differences based on the release and the specific version of the ServiceNow that you are using.

Overview

Kore.ai’s Virtual Assistant (VA) serves as the central point of interaction for the users. In addition to its regular capabilities, the VA acts as a proxy or intermediary between the users and the ServiceNow agents to hand over conversations seamlessly. The VA also allows you to integrate with the ServiceNow platform. The VA facilitates communication and interaction between the user and the ServiceNow agent using the chat module.

Configuration

Complete the following steps to configure the ServiceNow agent for Utah and higher versions: 

Step 1: Retrieve the ServiceNow Instance URL

  1. Log in to your ServiceNow account with admin user credentials. The ServiceNow account will have a unique URL for each developer instance in their Service Management or App Engine Studio, for example: https://devXXX67.service-now.com/.
  2. Copy the Instance ID from the URL and paste it into the Configurations tab of the ServiceNow Agent  page. Refer to step 2.

Step 2: Enable the ServiceNow Agent

  1. Log in to the Kore.ai XO Platform: https://bots.kore.ai/botbuilder
  2. Select a Virtual Assistant for which you want to configure the ServiceNow agent. 
  3. Navigate to Build > Integrations > Agent Transfer and click the ServiceNow button.
  4. On the Configurations tab, select your preferred authentication option (Basic vs. OAuth) and then provide the details as explained in the options below.
    Option 1: Basic Auth – Enter the ServiceNow Instance Credentials

      • Select the Agent Chat (Supported for Utah and higher versions) option.
      • Select the Basic Auth option for enabling ServiceNow Agent with the Basic Authentication.
      • Instance URL: The company’s URL where the ServiceNow instance is hosted, for example, https://devXXX67.service-now.com/.
      • User Name: The username of your ServiceNow account.
      • Password: The password of your ServiceNow account.
      • Queue ID: The unique queue identification number.
      • Webhook URL: The web URL for custom application function callbacks.

    Option 2: OAuth with Refresh Token – Follow the instructions in this ServiceNow Documentation to generate a refresh token.

    • Select the Agent Chat (Supported for Utah and higher versions) option.
    • Select the OAuth with Refresh Token option for enabling ServiceNow Agent with the Refresh Token Authentication.
    • Instance URL: The company’s URL where the ServiceNow instance is hosted, for example, https://devXXX67.service-now.com/.
    • Client ID: The client ID of your ServiceNow application copied in Step 2.
    • Client Secret: The client secret of your ServiceNow application copied in Step 2.
    • Refresh Token: The unique refresh token that you generated in Step 2.
    • Webhook URL: The web URL for custom application function callbacks.
  5. Click Authorize to authenticate and allow the XO platform to handover conversations to ServiceNow agent.
  6. If you want to make ServiceNow as the default agent, enable the Default Agent System for all bot channels option.
    Note: This option is enabled only when you have multiple agents configured for your VA.
  7. You can customize the channel mapping by clicking the Configure link as shown below:
  8. Once you click Configure, you can map the channels for which you want to use ServiceNow agent to  hand over the conversations. 

    For example, if you have configured a Genesys chat integration, Intercom and ServiceNow agents. You can make one of them as default and map channels to agent systems. In this case, the Web Client and WebHook are mapped to Genesys and Intercom. Slack is mapped to the default ServiceNow agent. To learn more about channel enablement, see Adding channels to your bot.
  9. After mapping channels, click Done.
  10. Click Save to enable the ServiceNow agent.
  11. Publish the VA. For more information, see Publishing Bot.

Step 3: Install the required plugins

  1. Log in to the ServiceNow Developer instance with Admin User Credentials.
  2. To create an application, search and select the System Definition under Plugins from the left menu.
  3. Search and install the following plugins:
    • Omni-experience Standard Feature Set

    • Advanced Work Assignment
    • Customer Service Management
    • Glide Virtual Agent
    • Virtual Agent API
  4. Verify that all required plugins are installed with the required permissions.

Step 4: Assign Agent roles to the Consumer Service Support Group

  1. Log in to the ServiceNow Developer instance with Admin User Credentials.
  2. To create an application, search and select the Advanced Work Assignment under Management > Groups from the left menu.
  3. Select the Consumer Service Support group and navigate to the group details screen.
  4. Select the Roles tab and click the Edit button to navigate to the roles screen.
  5. In the Roles collection, Search for awa_agent and  agent_workspace_user roles, assign them to the Consumer Service support, and save them.
  6. Navigate back to the group details screen, select the Group Members tab, click the edit button, and navigate to the Edit Members screen.
  7. In the Users Collection, Search for the required user. For example, select  Abel Tuter user, assign it to the Consumer Service support, and click Save.
  8. Navigate back to the group details screen and click Update.

Step 5. Update the Webhook Endpoint and enable the Integration

  1. Log in to the ServiceNow Instance  
  2. Select All menu and navigate to System Web Services >Outbound>REST messages.
  3. Select the VABot to Bot from the list to the VABot to Bot details.
  4. Edit the VABot to Bot details, Copy the Webhook URL from the Configuration tab of ServiceNow Agent page, and paste it into the EndPoint field on the VABot to Bot edit details.
  5. Scroll down and select the HTTP methods, update the same Webhook URL for the postMessage and click Update.
  6. Enable the ServiceNow Agent Integration by clicking the Save button.

Step 6: Testing Configuration

This section helps you verify how the conversations from the Kore.ai XO Platform are handed over to the ServiceNow agent after enabling it. 

To verify the data exchange between Kore.ai’s VA and ServiceNow agent, follow these steps:

  1. Open a virtual assistant for which you have enabled the ServiceNow agent.
  2. Create a new Agent Transfer Node task. For example, create a Platform Agenttask with the UserAgent node and configure it to use the ServiceNow agent. For more information, see Agent Transfer Node.
  3. Click the Talk to Bot icon to launch the VA and enter Help.
  4. Log in to the ServiceNow Instance, select the Impersonate User from the Profile option as shown:
  5. Enter the Username that you created. For example, select the Abel Tuter username.
  6. Select All and navigate to Workspace Experience>Workspaces>Agent Workspace Home.
  7. In the Agent Workspace page, select Inbox and set the Status to Available.
  8. When a user initiates the chat from the VA, it transfers the conversation to the ServiceNow agent and sends a message to the user.
  9. Agent receives a notification about this on ServiceNow.
  10. Now, the connection between the ServiceNow agent and the user has been established, and the conversation continues.

Additional Capabilities

Pass User Information to the ServiceNow Agent System

By default, when the Platform transfers an end user’s conversation to the ServiceNow Agent System, the end user appears as a Guest in the agent system.

You can pass on the user information from the Platform to the agent system using the “ServiceNowMetaData” object. You can set the values in the “ServiceNowMetaData” object using the “agentUtils.setMetaInfo” function in the context from all the places where you can define a javascript.

Subsequently, you can use the passed values to make required changes in the ServiceNow Agent System to populate the username in the agent chat.

Steps

  1. Configure Message Authentication for inbound communication in your ServiceNow instance as explained here – https://docs.servicenow.com/bundle/vancouver-servicenow-platform/page/administer/virtual-agent/task/set-up-message-auth-va-api.html
  2. Before the agent transfer node is executed, you must set the meta info (userId, emailId, and the static token generated in the previous step) in the context in a specific format.
    For example:

    1. The bot can collect the Servicenow UserId and Servicenow EmailId from the users as part of the entity nodes.
       
    2. Then, in the script node, you can add the “ServiceNowMetaData” object and set it in the context using the “agentUtils.setMetaInfo” in-built function.
      A sample script that can be added in the Script node:

      let metaData = {
          "payloadFields" : {
              "userId" : context.entities.UserID,   // ServiceNow user Id; it can be a dynamic or static value.
              "emailId" : context.entities.UserEmail   // ServiceNow user email; it can be a dynamic or static value.
          },
          "headerFields" : {
              "token" : "Token_generated_in_ServiceNow_Instance"
          }
      }
      agentUtils.setMetaInfo("ServiceNowMetaData", JSON.stringify(metaData))
      Note: By default, the context object may not include information such as user ID, email address, etc. You should explicitly capture the required details that need to be populated in the ServiceNow Agent System. Also, if the “ServiceNowMetaData” object is not defined, values are not included in the context object shared with the ServiceNow Agent System.

Route User Messages to Different Agent Groups by ‘streamId’

The Platform sends ‘streamId’ as a context variable in the request payload sent to ServiceNow. To route user messages to different agent groups by ‘streamId’ in the ServiceNow Agent System, you can define a Work Item Routing Condition in the Queue using the ‘streamId’ context variable.

Steps to access the ‘streamId’ while defining the Work Item routing condition:

  1. Go to the Conversational Interfaces Home and then create a new context variable with the name – streamId.
  2. Define a Work item routing condition in the Queue using the ‘streamId’ context variable, as shown in the screenshot below.
  3. You must configure the Work item routing condition based on the ‘streamId’ in each queue. For example, if the routing condition of queue 1 has a condition on ‘streamId’, but in queue 2, no condition is defined on ‘streamId’, both queues qualify for this work item. Therefore, to avoid this situation, ensure that the Work item routing conditions are defined in all the queues, as explained in the previous step.

For more information on the Work item routing condition and queue, see the following links and sample screenshots from the ServiceNow product documentation.

ServiceNow Documentation > Create a work item queue:

ServiceNow Documentation > Virtual Agent Bot Integration API:

Configuring the ServiceNow Agent – Utah and Higher versions

ServiceNow helps you build digital workflows on a single, unified platform. Kore.ai XO Platform’s ServiceNow Agent integration allows you to seamlessly hand off the virtual assistant conversations to your live agents on ServiceNow. 

This post provides the configuration steps to enable the ServiceNow Agent integration for Utah, Vancouver, and higher versions of the ServiceNow system. Use the configurations provided below as general guidelines, as there could be some differences based on the release and the specific version of the ServiceNow that you are using.

Overview

Kore.ai’s Virtual Assistant (VA) serves as the central point of interaction for the users. In addition to its regular capabilities, the VA acts as a proxy or intermediary between the users and the ServiceNow agents to hand over conversations seamlessly. The VA also allows you to integrate with the ServiceNow platform. The VA facilitates communication and interaction between the user and the ServiceNow agent using the chat module.

Configuration

Complete the following steps to configure the ServiceNow agent for Utah and higher versions: 

Step 1: Retrieve the ServiceNow Instance URL

  1. Log in to your ServiceNow account with admin user credentials. The ServiceNow account will have a unique URL for each developer instance in their Service Management or App Engine Studio, for example: https://devXXX67.service-now.com/.
  2. Copy the Instance ID from the URL and paste it into the Configurations tab of the ServiceNow Agent  page. Refer to step 2.

Step 2: Enable the ServiceNow Agent

  1. Log in to the Kore.ai XO Platform: https://bots.kore.ai/botbuilder
  2. Select a Virtual Assistant for which you want to configure the ServiceNow agent. 
  3. Navigate to Build > Integrations > Agent Transfer and click the ServiceNow button.
  4. On the Configurations tab, select your preferred authentication option (Basic vs. OAuth) and then provide the details as explained in the options below.
    Option 1: Basic Auth – Enter the ServiceNow Instance Credentials

      • Select the Agent Chat (Supported for Utah and higher versions) option.
      • Select the Basic Auth option for enabling ServiceNow Agent with the Basic Authentication.
      • Instance URL: The company’s URL where the ServiceNow instance is hosted, for example, https://devXXX67.service-now.com/.
      • User Name: The username of your ServiceNow account.
      • Password: The password of your ServiceNow account.
      • Queue ID: The unique queue identification number.
      • Webhook URL: The web URL for custom application function callbacks.

    Option 2: OAuth with Refresh Token – Follow the instructions in this ServiceNow Documentation to generate a refresh token.

    • Select the Agent Chat (Supported for Utah and higher versions) option.
    • Select the OAuth with Refresh Token option for enabling ServiceNow Agent with the Refresh Token Authentication.
    • Instance URL: The company’s URL where the ServiceNow instance is hosted, for example, https://devXXX67.service-now.com/.
    • Client ID: The client ID of your ServiceNow application copied in Step 2.
    • Client Secret: The client secret of your ServiceNow application copied in Step 2.
    • Refresh Token: The unique refresh token that you generated in Step 2.
    • Webhook URL: The web URL for custom application function callbacks.
  5. Click Authorize to authenticate and allow the XO platform to handover conversations to ServiceNow agent.
  6. If you want to make ServiceNow as the default agent, enable the Default Agent System for all bot channels option.
    Note: This option is enabled only when you have multiple agents configured for your VA.
  7. You can customize the channel mapping by clicking the Configure link as shown below:
  8. Once you click Configure, you can map the channels for which you want to use ServiceNow agent to  hand over the conversations. 

    For example, if you have configured a Genesys chat integration, Intercom and ServiceNow agents. You can make one of them as default and map channels to agent systems. In this case, the Web Client and WebHook are mapped to Genesys and Intercom. Slack is mapped to the default ServiceNow agent. To learn more about channel enablement, see Adding channels to your bot.
  9. After mapping channels, click Done.
  10. Click Save to enable the ServiceNow agent.
  11. Publish the VA. For more information, see Publishing Bot.

Step 3: Install the required plugins

  1. Log in to the ServiceNow Developer instance with Admin User Credentials.
  2. To create an application, search and select the System Definition under Plugins from the left menu.
  3. Search and install the following plugins:
    • Omni-experience Standard Feature Set

    • Advanced Work Assignment
    • Customer Service Management
    • Glide Virtual Agent
    • Virtual Agent API
  4. Verify that all required plugins are installed with the required permissions.

Step 4: Assign Agent roles to the Consumer Service Support Group

  1. Log in to the ServiceNow Developer instance with Admin User Credentials.
  2. To create an application, search and select the Advanced Work Assignment under Management > Groups from the left menu.
  3. Select the Consumer Service Support group and navigate to the group details screen.
  4. Select the Roles tab and click the Edit button to navigate to the roles screen.
  5. In the Roles collection, Search for awa_agent and  agent_workspace_user roles, assign them to the Consumer Service support, and save them.
  6. Navigate back to the group details screen, select the Group Members tab, click the edit button, and navigate to the Edit Members screen.
  7. In the Users Collection, Search for the required user. For example, select  Abel Tuter user, assign it to the Consumer Service support, and click Save.
  8. Navigate back to the group details screen and click Update.

Step 5. Update the Webhook Endpoint and enable the Integration

  1. Log in to the ServiceNow Instance  
  2. Select All menu and navigate to System Web Services >Outbound>REST messages.
  3. Select the VABot to Bot from the list to the VABot to Bot details.
  4. Edit the VABot to Bot details, Copy the Webhook URL from the Configuration tab of ServiceNow Agent page, and paste it into the EndPoint field on the VABot to Bot edit details.
  5. Scroll down and select the HTTP methods, update the same Webhook URL for the postMessage and click Update.
  6. Enable the ServiceNow Agent Integration by clicking the Save button.

Step 6: Testing Configuration

This section helps you verify how the conversations from the Kore.ai XO Platform are handed over to the ServiceNow agent after enabling it. 

To verify the data exchange between Kore.ai’s VA and ServiceNow agent, follow these steps:

  1. Open a virtual assistant for which you have enabled the ServiceNow agent.
  2. Create a new Agent Transfer Node task. For example, create a Platform Agenttask with the UserAgent node and configure it to use the ServiceNow agent. For more information, see Agent Transfer Node.
  3. Click the Talk to Bot icon to launch the VA and enter Help.
  4. Log in to the ServiceNow Instance, select the Impersonate User from the Profile option as shown:
  5. Enter the Username that you created. For example, select the Abel Tuter username.
  6. Select All and navigate to Workspace Experience>Workspaces>Agent Workspace Home.
  7. In the Agent Workspace page, select Inbox and set the Status to Available.
  8. When a user initiates the chat from the VA, it transfers the conversation to the ServiceNow agent and sends a message to the user.
  9. Agent receives a notification about this on ServiceNow.
  10. Now, the connection between the ServiceNow agent and the user has been established, and the conversation continues.

Additional Capabilities

Pass User Information to the ServiceNow Agent System

By default, when the Platform transfers an end user’s conversation to the ServiceNow Agent System, the end user appears as a Guest in the agent system.

You can pass on the user information from the Platform to the agent system using the “ServiceNowMetaData” object. You can set the values in the “ServiceNowMetaData” object using the “agentUtils.setMetaInfo” function in the context from all the places where you can define a javascript.

Subsequently, you can use the passed values to make required changes in the ServiceNow Agent System to populate the username in the agent chat.

Steps

  1. Configure Message Authentication for inbound communication in your ServiceNow instance as explained here – https://docs.servicenow.com/bundle/vancouver-servicenow-platform/page/administer/virtual-agent/task/set-up-message-auth-va-api.html
  2. Before the agent transfer node is executed, you must set the meta info (userId, emailId, and the static token generated in the previous step) in the context in a specific format.
    For example:

    1. The bot can collect the Servicenow UserId and Servicenow EmailId from the users as part of the entity nodes.
       
    2. Then, in the script node, you can add the “ServiceNowMetaData” object and set it in the context using the “agentUtils.setMetaInfo” in-built function.
      A sample script that can be added in the Script node:

      let metaData = {
          "payloadFields" : {
              "userId" : context.entities.UserID,   // ServiceNow user Id; it can be a dynamic or static value.
              "emailId" : context.entities.UserEmail   // ServiceNow user email; it can be a dynamic or static value.
          },
          "headerFields" : {
              "token" : "Token_generated_in_ServiceNow_Instance"
          }
      }
      agentUtils.setMetaInfo("ServiceNowMetaData", JSON.stringify(metaData))
      Note: By default, the context object may not include information such as user ID, email address, etc. You should explicitly capture the required details that need to be populated in the ServiceNow Agent System. Also, if the “ServiceNowMetaData” object is not defined, values are not included in the context object shared with the ServiceNow Agent System.

Route User Messages to Different Agent Groups by ‘streamId’

The Platform sends ‘streamId’ as a context variable in the request payload sent to ServiceNow. To route user messages to different agent groups by ‘streamId’ in the ServiceNow Agent System, you can define a Work Item Routing Condition in the Queue using the ‘streamId’ context variable.

Steps to access the ‘streamId’ while defining the Work Item routing condition:

  1. Go to the Conversational Interfaces Home and then create a new context variable with the name – streamId.
  2. Define a Work item routing condition in the Queue using the ‘streamId’ context variable, as shown in the screenshot below.
  3. You must configure the Work item routing condition based on the ‘streamId’ in each queue. For example, if the routing condition of queue 1 has a condition on ‘streamId’, but in queue 2, no condition is defined on ‘streamId’, both queues qualify for this work item. Therefore, to avoid this situation, ensure that the Work item routing conditions are defined in all the queues, as explained in the previous step.

For more information on the Work item routing condition and queue, see the following links and sample screenshots from the ServiceNow product documentation.

ServiceNow Documentation > Create a work item queue:

ServiceNow Documentation > Virtual Agent Bot Integration API:

Menu