Kore.ai ボットがアプリケーション サーバーと Kore.ai サーバーとの間で通信できるようにするには、Kore.ai ボットビルダーでアプリを作成して登録する必要があります。このアプリは、アプリケーションのコールバック URLを指定し、アプリケーションと開発者アカウントにあるすべてのボット間の安全な通信に必要なクライアント IDおよびクライアント シークレット認証トークンを生成します。このトピックでは、Kore.ai SDK を使用してアプリを作成し、登録の資格情報を生成する方法について説明します。ダイアログ タスクの Webhook とメッセージにアクセスするには、ボット用のアプリをサブスクライブする必要があります。ボットとユーザーからのメッセージはすべて、メッセージ イベントとして SDK に送信されます。Webhook ノードがダイアログ タスクに定義されると、実行時に Webhook イベントが SDK に送信されます。ボット イベント メッセージ、Webhook、およびアプリケーションの間の通信を許可するには、Kore.ai SDK をネットワークにインストール、ホスト、設定する必要があります。

アプリを作成するには

1. トップメニューから、[デプロイ] タブを選択します。
2. 左側のメニューで、[システム連携 > BotKit] をクリックします。
3. BotKit SDK ページです。
4. BotKit SDK ページで、[アプリ名] ドロップダウン リストの横にある [追加] ボタンをクリックします。"アプリの作成" ダイアログが開きます。
5. 「アプリ名" フィールドに、「TestApp」などのアプリ登録の名前を入力し、 [次へ] をクリックします。
6. 「アプリの作成に成功しました」というメッセージが表示されたら、[完了] をクリックします。 
7. 以下のフィールドが表示されます。
   1. クライアント IDとクライアント シークレットが生成されました
   2. 表示された "コールバック URL" フィールドへ、Kore.ai にデータを追加したいアプリケーションの URL を入力します。例: https://koremessenger.com/postURL
   3. [イベント] セクションで、以下のうち 1 つ以上を選択します。
      1. OnMessageー ユーザーからのメッセージを受信したときに、イベントをトリガーします。
      2. OnHookNode ー ダイアログのタスク フローで Webhook ノードが検出されときに、イベントをトリガーします。
      3. onEvent ー ダイアログや FAQ が終了するたびに、イベントをトリガーします。
      4. onAlert ー ユーザーが警告メッセージを受信したときに、イベントをトリガーします。
      5. onVariableUpdate ー ボットが公開されたときに、イベントをトリガーします。
   4. [保存] をクリックします。

新しいアプリの登録が、資格情報とともに BotKit セクションに表示されます。

To enable your Kore.ai Bot to communicate between your application servers and Kore.ai servers, you need to create and register an app in Kore.ai Bot Builder that specifies the callback URL for your application and generates the Client ID and Client Secret authentication tokens required for secure communications between your application and any Bots in your developer account.

This topic describes how to create an app and generate registration credentials when using the Kore.ai SDK.

To access webhooks and messages in Dialog tasks, you need to subscribe to an app for your bot. All messages from the bot and user are sent to the SDK as message events. When a Webhook node is defined in a Dialog task, the webhook event is sent to the SDK at runtime. You must install, host, and configure the Kore.ai SDK in your network to allow communications between the bot event messages and webhooks, and your application.

To create an app

1. Select the Deploy tab from the top menu
2. From the left menu click Integrations -> BotKit.
3. The BotKit SDK page.
   
4. On the BotKit SDK page, click the Add button next to the App Name drop-down list. The Create App dialog opens.
5. In the App Name field, enter the name of the app registration, for example, TestApp, and then click Next.
6. Once the App Created Successfully message appears, click Done. 
7. The following fields appear.
   1. The Client ID and Client Secret are generated
   2. In the Callback URL field displayed, enter the URL for your application that you want Kore.ai to push data to, for example, https://koremessenger.com/postURL.
   3. In the Events section, select one or more of:
      1. OnMessage – Triggers an event when a message from a user is received.
      2. OnHookNode – Triggers an event when a WebHook node is encountered in the Dialog task flow.
      3. onEvent – Triggers an event every time a Dialog or FAQ is finished.
      4. onAlert – Triggers an event when the user receives an alert message.
      5. onVariableUpdate – Triggers an event when the bot is published
   4. Click Save.

The new app registration along with credentials is displayed in the BotKit section.