このチュートリアルは、ボットからの情報を表示し、ボットとの対話を可能にするウィジェットをホストするために、Kore.ai ボット Web SDK のインスタンスを設定して実行するためのエンド ツー エンドのウォークスルーです。

ウィジェット SDK の概要

Kore.ai ウィジェット SDK をホストする方法は、2 種類あります:

• WebSDK と共同でホスティングし、Web/モバイル クライアントと ウィジェット SDK の両方のチャネルを有効にして設定します。
• 個別に ー ウィジェット SDK チャネルのみを有効にして設定します。

このチュートリアルでは、両方のバリエーションの手順を示します。

Kore.ai ウィジェット SDK のインストールと実行

このセクションでは、ウィジェット SDK を使用して Kore.ai ボットを実行する方法と、コンピュータのローカル ホスト サーバー上で動作するテスト アプリケーションの詳細な手順を説明します。必要条件

1. はじめに、テスト アプリケーションで実行するために、デジタル ビューでボットを構築する必要があります（デジタル ビューについてはこちらをご覧ください）。
2. 新しいクライアント アプリを作成するか、または既存のクライアント アプリを使用し、チャネル設定を行うことで、上記ボットの ウィジェット SDK チャネルを有効にする必要があります。詳しい手順についてはこちらをご覧ください 。
3. WebSDK とともに パネルとウィジェット を共同ホストする場合は、新規のクライアント アプリを作成するか、既存のクライアント アプリを使用して、上記ボットの Web/モバイル クライアント チャネルを有効にし、チャネル設定を定義する必要があります。詳しい手順についてはこちらをご覧ください 。
4. ボットの公開します。
5. [チャネル > 設定済みチャネル] をクリックして、設定されたウィジェット SDK チャネルを開きます。「設定」タブでは、以下の項目をメモします。のちほど、ウィジェット SDK のセットアップでこれらを使用します:
   • ボット名
   • ボット ID
   • クライアント ID
   • クライアント シークレット
6. パネルとウィジェット を Web/モバイル SDK と共同でホストする場合は、[チャネル > 設定済みチャネルチュートリアル] から、設定済みのWeb/モバイル クライアント チャネルを開きます。「設定」タブで、以下の項目をメモします。のちほど、ウィジェット SDK のセットアップでこれらを使用します:
   • ボット名
   • ボット ID
   • クライアント ID
   • クライアント シークレット

次の手順では、 ウィジェット SDK に必要なソフトウェア パッケージと、ローカル ホスト サーバー上でボットをローカルに実行するテスト アプリケーションをダウンロード、解凍、インストール、および設定します。ご要件に応じて、以下の適切なセクションをご覧ください:

• パネルを個別にホストするか、または
• Web SDK とパネルを共同ホストします。

パネルを個別ホストするためのセットアップ: Kore.ai ウィジェット SDK をダウンロードするには、https://github.com/Koredotcom/web-kore-sdkにアクセスして [ダウンロード] をクリックします。すべてのファイルを …/SDKApp/sdk フォルダに解凍します。

1. UI フォルダを開きます。
2. を見つけて開きます kore-widgets-config.js
3. ボット ビルダーで作成したウィジェット SDKチャネル設定を使用して、botOptions を設定します。
   • botOptions.botInfo
   • botOptions.clientId
   • botOptions.clientSecret
4. ブラウザで index_widgets.html のファイルを開くと、パネルが表示されます。この <div> 要素をウェブサイトの html ページに追加すると、そこでパネルをホストすることができます。

Web/モバイル SDKでパネルを共同ホストするための設定: Kore.ai ウィジェット SDK をダウンロードするには、https://github.com/Koredotcom/web-kore-sdk にアクセスして [ダウンロード] をクリックします。すべてのファイルを …/SDKApp/sdk フォルダに解凍します。

1. UI フォルダを開きます。
2. を見つけて開きます kore-config.js
3. botOptions を、Bot ビルダーで作成したWeb/モバイル クライアントチャネル設定を使用して、設定します。
   • botOptions.botInfo
   • botOptions.clientId
   • botOptions.clientSecret
4. 開きます。 kore-widgets-config.js
5. botOptions を、ボット ビルダーで作成した「ウィジェット SDK」チャネル設定を使用して、設定します。
   • botOptions.botInfo
   • botOptions.clientId
   • botOptions.clientSecret
6. index_widgets_chat.html ファイルをブラウザで開くと、ウィジェットとともにチャット ウィンドウが表示されます。

This tutorial is an end-to-end walkthrough for setting up and running an instance of the Kore.ai Bots Web SDK to host widgets for presenting information from your bots and enabling interaction with your bots.

Widget SDK Overview

There are two ways to host the Kore.ai Widget SDK:

• co-host them along with the WebSDK – enable and configure both Web/Mobile Client and Widget SDK channels; or
• independently – enable and configure just the Widget SDK channel.

In this tutorial, we will be listing the instructions for both the variations.

Installing and Running the Kore.ai Widget SDK

This section provides detailed steps on how to run a Kore.ai bot using the Widget SDK and a test application running on your computer localhost server.

Pre-requisites

1. To get started, you will need to build a bot with Digital Views to run in the test application (see here for more on Digital Views).
2. You need enable the Widget SDK channel for the above bot by either creating a new client app or use an existing client app and define the channel settings. See here for a detailed explanation of the steps.
3. If you want to co-host the Panels & Widgets along with the WebSDK, you need enable the Web/Mobile Client channel for the above bot by either creating a new client app or use an existing client app and define the channel settings. See here for a detailed explanation of the steps.
4. Publish the bot.
5. From the Channels -> Configured Channels click to open the configured Widget SDK channel. From the Configurations tab make a note of the following, we will be using them later in the Widget SDK setup:
   • Bot Name
   • Bot ID
   • Client ID
   • Client Secret
6. If you want to co-host Panels & Widgets with Web/Mobile SDK, then from the Channels -> Configured Channels click to open the configured Web/Mobile Client channel. From the Configurations tab make a note of the following, we will be using them later in the Widget SDK setup:
   • Bot Name
   • Bot ID
   • Client ID
   • Client Secret

Next step would be to download, uncompress, install and configure the software packages required for the Widget SDK and a test application to run the bot locally on your localhost server.

Based upon your requirement see the appropriate sections below:

• host Panels individually; or
• co-host Panels with Web SDK.

Setup to host Panels individually:

To download the Kore.ai Widget SDK, go to https://github.com/Koredotcom/web-kore-sdk, and then click Download. Extract all files to the …/SDKApp/sdk folder.

1. Open the UI folder.
2. Locate and open the kore-widgets-config.js
3. Configure your botOptions with the ‘Widget SDK’ channel configurations created in bot builder:
   • botOptions.botInfo
   • botOptions.clientId
   • botOptions.clientSecret
4. Open the index_widgets.html file in the browser and see the Panels displayed. You can add this <div> element to your website html page to host the Panels there.

Setup to co-host Panels with Web/Mobile SDK:

To download the Kore.ai Widget SDK, go to https://github.com/Koredotcom/web-kore-sdk, and then click Download. Extract all files to the …/SDKApp/sdk folder.

1. Open UI folder.
2. Locate and open the kore-config.js
3. Configure your botOptions with the ‘web/mobile client’ channel configurations created in bot builder
   • botOptions.botInfo
   • botOptions.clientId
   • botOptions.clientSecret
4. Open the kore-widgets-config.js
5. Configure your botOptions with the ‘Widget SDK’ channel configurations created in bot builder
   • botOptions.botInfo
   • botOptions.clientId
   • botOptions.clientSecret
6. Open the index_widgets_chat.html file in the browser and see the chat window along with the widgets.