{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":4863,"path":"conversational-interfaces/virtual-agent/configure-watson-assistant-topic.md","title":"Integrating Virtual Agent with IBM Watson Assistant","bundle":null,"doc_type":null,"release":"australia","body":"\n# Integrating Virtual Agent with IBM Watson Assistant\n\nSet up the IBM Watson Assistant topic to run dialog skills \\(conversations created in IBM Watson Assistant\\) in the web-based chat client. This topic returns information exchanged during the Virtual Agent conversation to IBM Watson Assistant.\n\n## Before you begin\n\n**Note:** An updated Assistant Designer Asset library user interface is available when you install ServiceNow Otto in Virtual Agent. This content assumes that you can see the list view. If ServiceNow Otto in Virtual Agent is not installed, you see the legacy UI and topics page. For more information, see [Virtual Agent Designer legacy topics page](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/conversational-interfaces/virtual-agent/vad-prev-topics-page.md).\n\n-   In IBM Watson Assistant:\n    -   Create the dialog skill \\(conversation\\) in your IBM Watson Assistant workspace. The skill includes the dialog and any intents and entities that you define.\n    -   Navigate to your skill tile and in the tile menu, select **View API Details**. View the Skill Details and Service Credentials. Copy the following items: **Skill ID**, **Workspace ID**, **Username**, and **Password**. You need these items when setting up this integration.\n-   Activate the IBM Watson Assistant Integration plugin \\(com.glide.cs.ibm.watson.assistant\\).\n\nRole required: virtual\\_agent\\_admin or admin\n\n## About this task\n\nThis topic runs an IBM Watson Assistant dialog in Virtual Agent. It doesn't require enabling Natural Language Understanding \\(NLU\\) or setting IBM Watson Assistant NLU as the NLU service provider for Virtual Agent.\n\n## Procedure\n\n1.  In your ServiceNow instance, update the watson\\_assistant.workspaceID system property.\n\n    1.  In the navigation filter, enter `sys_properties.list`.\n\n    2.  In the System Properties \\[sys\\_properties\\] table, locate the watson\\_assistant.workspaceID property.\n\n    3.  Replace the existing **Value** with the **Workspace ID** for your skill, and select **Update**.\n\n2.  Verify that the REST message for IBM Watson Assistant provides the correct authentication endpoint for your IBM skill:\n\n    1.  Navigate to **System Web Services** &gt; **Outbound** &gt; **REST Message**.\n\n    2.  Select the IBM Watson Assistant record to open the REST Message IBM Watson Assistance form.\n\n    3.  Confirm that the **Endpoint** field and the **Endpoint** column displayed on the **Authentication** tab have the correct endpoint URL for your IBM Watson account.\n\n        \\[Omitted image \"REST-msg-Watson.png\"\\] Alt text: REST Messages form for IBM Watson Assistant with IBM endpoint URLs highlighted.\n\n3.  In the **Basic auth profile** field on the **Authentication** tab, open the Assistant Profile record.\n\n4.  In the Basic Auth Configuration form, enter the **Username** and **Password** values from your IBM Watson Assistant Service Credentials, then select **Update**.\n\n    \\[Omitted image \"Basic-auth-config-assistant-profile.png\"\\] Alt text: Basic Auth Configuration form for IBM Watson Assistant assistant profile.\n\n5.  Publish the IBM Skill topic:\n\n    1.  Navigate to **Conversational Interfaces** &gt; **Virtual Agent** &gt; **Designer**, and then slide the discovery type toggle switch to **NLU/keyword**.\n\n    2.  On the Virtual Agent Designer home page, select the IBM Watson Assistant topic to open the Topic Properties page.\n\n        Notice that the **Keyword** for this topic is IBM Watson Assistant and the **Category** is IBM.\n\n    3.  In the Topic Properties page, select **Publish** to deploy the topic to your Virtual Agent chat widget.\n\n6.  Configure the default topic for the Virtual Agent chat widget in one of the following ways:\n\n    -   Provide the URL that specifies the IBM Watson Assistant topic as the default topic that opens in the Service Portal client:\n\n        For example: `https://<Your instance URL>$sn-va-web-client-app.do?sysparm_skip_load_history=true&sysparm_topic=*&lt;sys\\_id&gt;*` where *&lt;sys\\_id&gt;* is the sys\\_id of the published IBM Watson Assistant topic. The `sysparm_skip_load_history` parameter doesn't load the conversation history in the chat widget.\n\n    -   Configure the Service Portal widget by selecting the edit \\(pencil\\) icon in the upper right corner of the Virtual Agent widget.\n\n        To set the default topic using the widget instance parameters, enter `sysparm_topic=sys_id` \\(where *&lt;sys\\_id&gt;* is the sys\\_id of the published IBM Watson Assistant topic\\) in the **Virtual Agent Client URL Parameters** field, and select **Save**.\n\n        **Note:** You can find the sys\\_id of a topic in the Topics \\[sys\\_cs\\_topic\\] table.\n\n    **Important:**\n\n    Use the `sysparm_topic` parameter only to load the given topic in the Service Portal chat client or when using the IBM Watson Assistant chat integrations \\(com.glide.cs.ibm.watson.assistant.topic and com.glide.cs.ibm.watson.assistant.topicV2 plugins\\). This parameter doesn’t allow users to start a new conversation or transfer to a live agent. It also disables the context menu and doesn't support other third-party chat clients.\n\n\n**Parent Topic:**[Integrating IBM Watson Assistant conversations](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/conversational-interfaces/virtual-agent/va-ibm-watson-assistant-config.md)\n\n"}}