Install the Virtual Agent API app to integrate any chat interface or a bot with ServiceNow® Virtual Agent or Agent Chat.

Before you begin

If you're upgrading from a version prior to version 2 and if authentication is required for your instance, you must revert the customization before upgrading. For these versions, the upgrade skips the Scripted REST Service when authentication is turned on. For more information, see Revert a customization.
You must meet the following requirements:
  • Ensure that the application and all of its associated ServiceNow Store applications have valid ServiceNow entitlements. For more information, see Get entitlement for a ServiceNow product or application.
  • Review the Virtual Agent API application listing in the ServiceNow Store for information on dependencies, licensing or subscription requirements, and release compatibility.
  • Ensure that you activated the Glide Virtual Agent (com.glide.cs.chatbot) plugin, which activates the Conversational Custom Chat Integration (com.glide.cs.custom.adapter) plugin.

    For more information about this plugin, see Activate Virtual Agent.

Note: The Virtual Agent API requires a Pro license similar to that of Virtual Agent.

Role required: admin or virtual_agent_admin

About this task

The Bot to Bot Control [sys_cs_bot_to_bot_control] table is installed with the Virtual Agent API. This table tracks the number of times that a particular task in a topic is executed. You can use this table for debugging. For example, use it to determine whether Virtual Agent is stuck on a particular control or topic.

Procedure

  1. Navigate to All > System Applications > All Available Applications > All.
  2. Find the Virtual Agent API application using the filter criteria and search bar.

    You can search for the application by its name or ID. If you cannot find the application, you may have to request it from the ServiceNow Store.

    Visit the ServiceNow Store website to view all the available apps and for information about submitting requests to the store. For cumulative release notes information for all released apps, see the ServiceNow Store version history release notes.

  3. Select a version from the list and select Install.

    In the Review Installation Details dialog box that is displayed, any dependencies that are installed with your application are listed.

  4. If you're prompted, follow the links to the ServiceNow Store to get any additional entitlements for dependencies.

What to do next

Review the inbound REST endpoint and configure inbound authentication