- \n
- To view the list of the existing virtual assistants and link one to your SearchAssist app, you must have the Kore.ai XO platform license activated for your organization.<\/li>\n
- To integrate a\u00a0 virtual assistant into the SearchAssist app,\u00a0 the virtual assistant has to be built on the Kore.ai XO Platform, published and active.<\/li>\n
- To view existing virtual assistants and link to your SearchAssist app, navigate to\u00a0Sources<\/b>\u00a0\u2192\u00a0Actions<\/b>\u00a0\u2192\u00a0Link Bot<\/b>.<\/li>\n<\/ol>\n<\/div>\n
<\/p>\n
Note<\/strong>: If you do not see any virtual assistants listed in the LinkBot window, you can create your virtual assistant catering to your business needs by subscribing to the Kore.ai XO Platform. To learn more, see\u00a0Kore.ai Virtual Assistant Builder Assistant<\/a>.<\/p>\n
\n<\/span><\/span>Summary of Integration<\/span><\/h2>\n
Keep both the SearchAssist app and the virtual assistant on the Kore.ai XO Platform open in separate browser tabs.
\nFrom the Link Bot configuration window of the SearchAssist app, fetch the following:<\/p>\n- \n
- POST URL, and<\/li>\n
- Access token<\/li>\n<\/ul>\n
And paste them into the respective fields in the webhook configurator window of the virtual assistant to generate the Webhook URL path for the channel.<\/p>\n
From the virtual assistant, webhook URL configurator window, fetch the following:<\/p>\n
- \n
- \n
- \n
- Webhook URL<\/li>\n
- Bot Client ID, and<\/li>\n
- Bot Secret ID<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n
And paste them into the respective fields in the Link Bot configuration window of the SearchAssist app.<\/p>\n
This exchange of values of the parameters between the platforms\/apps completes the integration procedure successfully.<\/p>\n
The following section details the steps with relevant screenshots and guides you to complete the linking of a virtual assistant with your Search Assist App.<\/p>\n
<\/span><\/span>Integrating Virtual Assistant With Your SearchAssist App<\/span><\/h2>\n
From the SearchAssist app, you can integrate or link an existing and active virtual assistant built on the Kore.ai XO platform.
\nTo integrate a virtual assistant with your SearchAssist app complete the following steps in both the Kore.ai XO and SearchAssist Platforms:<\/p>\n- \n
- Open the Kore.ai XO platform in a new browser tab.<\/li>\n
- Navigate to the virtual assistant that you intend to link to your SearchAssist app.<\/li>\n
- Navigate to\u00a0Deploy<\/b>\u00a0\u2192\u00a0Channel<\/b>\u00a0\u2192\u00a0Webhook<\/b><\/li>\n
- In the\u00a0Configurations<\/b>\u00a0tab click\u00a0\u00a0Create App<\/b>\u00a0to fetch webhook credentials
![\"\"](\"http:\/\/docs.kore.ai\/searchassist\/wp-content\/uploads\/sites\/4\/2022\/05\/xWH_create-app-1-300x215.png.pagespeed.ic.919Bt1y2QW.webp\")
<\/a><\/li>\n- Enter the app name (say myApp4Credentials2),\u00a0 select\u00a0 HS256 as the JWT signing algorithm from the drop-down, and click\u00a0Create<\/b>.
![\"\"](\"http:\/\/docs.kore.ai\/searchassist\/wp-content\/uploads\/sites\/4\/2022\/05\/xcreatenewapp4credentials-300x248.png.pagespeed.ic.hoDL3p6fvO.webp\")
<\/a><\/li>\n- In the next screen enter the Channel name (say myAsyncHook-1 ), and choose the app created in the previous step from the\u00a0\u00a0Select App<\/b>\u00a0dropdown.<\/li>\n
- Select Asynchronous Integration Method.<\/li>\n
- Keep the SearchAssist app open and click the\u00a0Sources<\/b>\u00a0menu tab.<\/li>\n
- Click\u00a0Actions<\/b>\u00a0in the left pane.<\/li>\n
- On the Bot Actions page, click\u00a0Link a Bot<\/b>.
\n![\"\"](\"http:\/\/docs.kore.ai\/searchassist\/wp-content\/uploads\/sites\/4\/2022\/05\/xlink_a_Bot-1-300x61.png.pagespeed.ic.S4mPjUJoXA.webp\")
<\/li>\n- On the next page, locate the virtual assistant you intend to integrate your SearchAssist app with.<\/li>\n
- Click\u00a0Link Bot<\/b>.
<\/a><\/li>\n
- Capture \u201cPost URL\u201d and \u201cAccess token\u201d values from the Searchassist Link Bot configuration window.
![\"\"](\"http:\/\/docs.kore.ai\/searchassist\/wp-content\/uploads\/sites\/4\/2022\/05\/xsourceSA_link_bot_access-and-post-URL-300x154.png.pagespeed.ic.1TVWR7cdXO.webp\")
<\/a><\/li>\n- In the Webhook configuration window enter the \u201cPost URL\u201d and \u201cAccess token\u201d values captured in the previous steps.<\/li>\n
- From the\u00a0Webhook configuration\u00a0<\/b>window\u00a0capture the \u201cClient-ID\u201d and \u201cBot Secret ID\u201d values.
\n![\"\"](\"http:\/\/docs.kore.ai\/searchassist\/wp-content\/uploads\/sites\/4\/2022\/05\/xsourceWH_Client-ID_secretID.png.pagespeed.ic.exOm14U_24.webp\")
<\/li>\n- Enter the \u201cClient-ID\u201d and \u201cBot Secret ID\u201d values into the respective target fields in the SearchAssist\u00a0Link Bot<\/b>\u00a0configuration window.
\n![\"\"](\"http:\/\/docs.kore.ai\/searchassist\/wp-content\/uploads\/sites\/4\/2022\/05\/xtarget-bot-client-ID_secret-ID-1-300x159.png.pagespeed.ic.1YpbNbpgoE.webp\")
<\/a><\/li>\n- Switch to the Webhook configuration window and click\u00a0Save<\/b>\u00a0the configuration to generate the webhook URL.
\n![\"\"](\"http:\/\/docs.kore.ai\/searchassist\/wp-content\/uploads\/sites\/4\/2022\/05\/xtarget-bot-client-ID_secret-ID-2-300x159.png.pagespeed.ic.1YpbNbpgoE.webp\")
<\/a><\/li>\n- Click\u00a0Ok\u00a0<\/b>on the confirmation message stating \u201cConfiguration Saved\u201d.
\n![\"\"](\"http:\/\/docs.kore.ai\/searchassist\/wp-content\/uploads\/sites\/4\/2022\/05\/config-saved-ok-300x101.png\")
<\/a><\/li>\n- From the Webhook configuration window copy the Webhook URL.
\n![\"\"](\"http:\/\/docs.kore.ai\/searchassist\/wp-content\/uploads\/sites\/4\/2022\/05\/sourceWH_Client-ID_secretID-1-212x300.png\")
<\/a><\/li>\n- Enter the Webhook URL captured in the previous step into the Webhook URL field in the SearchAssist Link bot configuration window.<\/li>\n
- In the Kore.ai XO platform publish the newly created channel (AsyncHook-1)<\/li>\n
- In SearchAssist Link Bot configuration window, click the \u201cLink\u201d button to save the configuration and link a bot.
![\"\"](\"http:\/\/docs.kore.ai\/searchassist\/wp-content\/uploads\/sites\/4\/2022\/05\/target-whURL_and-link-300x159.png\")
<\/a><\/li>\n<\/ol>\n<\/span><\/span>Managing Virtual Assistant Actions<\/span><\/h2>\n
Once you have linked a virtual assistant to your SearchAssist app, you can:<\/p>\n
- \n
- View the virtual assistant and the associated tasks it\u2019s capable of handling.<\/li>\n
- Open the virtual assistant in Kore.ai\u2019s Experience Optimization (XO) or bot platform.\n
- \n
![\"\"](\"https:\/\/multisite.korebots.com\/SearchAssist\/wp-content\/uploads\/sites\/18\/2022\/05\/bot-actions1.png\")
<\/a><\/li>\n<\/ul>\n<\/li>\n- Click Edit Configuration to capture any changes from Kore.ai\u2019s Experience Optimization (XO) or bot platform.<\/li>\n
- To link a new virtual assistant to the given SearchAssist app click Unlink Bot to unlink the currently linked virtual assistant.
\n![\"\"](\"https:\/\/multisite.korebots.com\/SearchAssist\/wp-content\/uploads\/sites\/18\/2022\/05\/unlink-or-edit.png\")
<\/a><\/li>\n<\/ol>\n<\/span><\/span>End-Users Experience Virtual Assistant Actions From Search<\/span><\/span><\/h2>\n
- \n
- \n
- \n
- End-user enters a query in the search interface, \u201cCan you reissue my debit card?<\/i>\u201d<\/li>\n
- The SearchAssist app detects the intent behind the query and maps it to the \u201crequest for reissuing a debit card\u201d task.<\/li>\n
- The SearchAssist app displays the following:\n
- \n
- related action, in this case, \u201cReissue debit card\u201d<\/li>\n
- related information in FAQs and web search results
\n![\"\"](\"https:\/\/multisite.korebots.com\/SearchAssist\/wp-content\/uploads\/sites\/18\/2022\/05\/linking1-bot-example.png\")
<\/a><\/li>\n<\/ul>\n<\/li>\n- Once you link with a bot or virtual assistant, the end-user can invoke virtual assistant actions inside the search interface. For example, if the linked virtual assistant is a BankAssistant, with the capability if reissuing a debit card, the following steps flow through<\/li>\n
- The BankAssistant handholds the end-user through the entire journey and<\/li>\n
- walks through the logical steps essential to complete the task:\n
- \n
- confirms customer address<\/li>\n
- accepts a One-Time-Password (OTP) to authenticate the request<\/li>\n
- acknowledges request that is accepted and\u00a0gives the customer a tentative delivery timeline<\/li>\n
- generates a shipment tracking number in the background and<\/li>\n
- provides a link to track the shipment tracking number<\/li>\n<\/ul>\n<\/li>\n
- Once the task completes, control returns to the search bar.
\n![\"\"](\"https:\/\/multisite.korebots.com\/SearchAssist\/wp-content\/uploads\/sites\/18\/2022\/05\/return-control-to-search.png\")
<\/a><\/li>\n<\/ol>\n<\/li>\n<\/ol>\n<\/div>\n","protected":false},"excerpt":{"rendered":"You can integrate an active virtual assistant capable of performing actions related to intents from your SearchAssist app. This integration allows end-users to invoke virtual assistant actions from the search interface. SearchAssist identifies and maps the intent behind user queries, if any, which trigger actions that the linked virtual assistant offers. Virtual assistant actions are…<\/p>\n","protected":false},"author":18,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[95],"tags":[],"jetpack_featured_media_url":"","_links":{"self":[{"href":"https:\/\/multisite.korebots.com\/SearchAssist\/wp-json\/wp\/v2\/posts\/4245"}],"collection":[{"href":"https:\/\/multisite.korebots.com\/SearchAssist\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/multisite.korebots.com\/SearchAssist\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/multisite.korebots.com\/SearchAssist\/wp-json\/wp\/v2\/users\/18"}],"replies":[{"embeddable":true,"href":"https:\/\/multisite.korebots.com\/SearchAssist\/wp-json\/wp\/v2\/comments?post=4245"}],"version-history":[{"count":3,"href":"https:\/\/multisite.korebots.com\/SearchAssist\/wp-json\/wp\/v2\/posts\/4245\/revisions"}],"predecessor-version":[{"id":4436,"href":"https:\/\/multisite.korebots.com\/SearchAssist\/wp-json\/wp\/v2\/posts\/4245\/revisions\/4436"}],"wp:attachment":[{"href":"https:\/\/multisite.korebots.com\/SearchAssist\/wp-json\/wp\/v2\/media?parent=4245"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/multisite.korebots.com\/SearchAssist\/wp-json\/wp\/v2\/categories?post=4245"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/multisite.korebots.com\/SearchAssist\/wp-json\/wp\/v2\/tags?post=4245"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
- End-user enters a query in the search interface, \u201cCan you reissue my debit card?<\/i>\u201d<\/li>\n
- In the\u00a0Configurations<\/b>\u00a0tab click\u00a0\u00a0Create App<\/b>\u00a0to fetch webhook credentials
- \n
![\"\"](\"https:\/\/docs.kore.ai\/searchassist\/wp-content\/uploads\/sites\/4\/2022\/05\/link_bot1-300x96.png)
<\/a><\/li>\n