Cisco Webex Teams（以前のCisco Spark）チャネルをボットに追加するには、開発者はCisco Webex Teamsでボットアプリとシステム連携アプリを作成する必要があります。Kore.aiボットにCisco Sparkチャネルを追加して、ボットのエンドユーザーが“Cisco Spark”アカウントを使用してボットと対話できるようにするためには、4つのステップのプロセスが必要です。ボットにCisco Sparkチャネルを追加するには、以下のステップに従います。

  1. Cisco Sparkアプリの作成―“Spark開発者向け”アカウントで、“Cisco Spark”とKore.aiボット間の通信の承認を提供するアプリを作成する必要があります。 “Cisco Spark”アプリを作成するには、Spark for Developersポータルで無料アカウントを作成して登録しておく必要があります。
  2. アクセストークンの取得―Kore.aiボットのチャネルとしてCisco Sparkを使用するには、有効なSparkボットユーザー名を取得し、アクセストークンを生成してコミュニケーション用の認証を提供します。
  3. システム連携のセットアップ―コールバックURLをKore.aiに追加し、Cisco Sparkとの間でメッセージを送受信するようにCisco Sparkアプリのスコープを設定することにより、Kore.aiボットへのCisco Sparkシステム連携を定義します。
  4. 有効化―Cisco Sparkアプリをセットアップし、ボットビルダーに構成データを入力した後、チャネルを有効化する必要があります。

Cisco Webexチームでボットを作成

  1. Cisco Webex Developer Portalにログインし、[Start Building Apps]ページまたは [My Webex Apps] ページに進みます。
  2. Create a New Appオプションをクリックし、Create a Botオプションを選択します。
  3. ボットを作成するために必要なすべての情報を入力し、Add Botをクリックします。
  4. このステップにより、“ボットユーザー”が作成され、このボットにアクセスするための“アクセストークン”も生成されます。
  5. このページからボットのユーザー名とアクセストークンをメモします。

ボットビルダーからCisco Webexチームチャネルを有効にする

  1. ボットビルダーのボットセクションで、Cisco Sparkチャネルを追加したいボットをクリックします。
  2. チャネルタブで、Cisco Webex Teamsチャネルを選択して、対応するチャネルページを開きます。
  3. 前のステップのボットユーザー名とアクセストークンを入力します。
  4. リダイレクトURLをメモします。

Cisco Webex Teamとのシステム連携を設定

  1. Cisco Webex Team開発者ポータルで、右上のProfileドロップダウンリストをクリックして、My Webex Appsページに移動します。
  2. Create a New Appをクリックし、Create an Integrationオプションを選択して、Sparkの新しいシステム連携アプリを追加します。
  3. システム連携の名前、説明、ロゴなど、システム連携を作成するために必要なすべての詳細を提供します。この情報は、アクセス許可ダイアログでエンドユーザーに表示されるため、ユーザー向けである必要があります。
  4. リダイレクトURIの場合は、前のステップから“リダイレクトURL”をコピーします。
  5. Scopeで、ボット通信を有効にするために“spark:all”を選択します。
  6. 必要な情報をすべて入力したら、Add Integrationをクリックして新しいシステム連携アプリを作成します。
  7. このステップでは、新しいシステム連携アプリを作成し、このアプリのクライアントIDとクライアントシークレットも生成します。
  8. クライアントIDとクライアントシークレットをメモします。

ボットビルダーからCisco Webex Team Channel構成を完了

  1. ボットビルダープラットフォームのチャネル構成ページで、前のステップでメモしたクライアントIDとクライアントシークレットを入力します。
  2. チャネルを有効にして構成を完了します。
  3. 構成を保存します。

Cisco Spark Channelを編集

Cisco Sparkチャネルを編集するには、変更するチャネルにカーソルを合わせ、表示された設定アイコンをクリックしてコマンドメニューを表示します。チャネルを変更するには、次のコマンドのいずれかを選択します：

  • 編集―クリックしてCisco Spark Channelセットアップページを開きます。
  • 無効化/有効化―無効化をクリックして、ボットのCisco Sparkチャネルの使用を一時的に無効にします。チャネルが無効になっている場合は、有効化をクリックしてCisco Sparkチャネルが使用できるようにします。
  • 削除―削除をクリックします。削除の確認ダイアログボックスで、OKをクリックして、ボットチャネル構成を完全に削除します。

    警告：この操作は永久的で、元に戻す、ことはできません。

봇에 Cisco Webex Teams (이전의 Cisco Spark)를 추가하려면, 개발자는 Cisco Webex Teams에서 봇 앱 및 통합 앱을 생성해야 합니다. Kore.ai 봇에 Cisco Spark 채널을 추가하는 것은 봇의 최종 사용자가 사용자의 Cisco Spark 계정을 사용하여 상호 작용할 수 있도록 하는 4단계 과정으로 이루어집니다. Cisco Spark 채널을 봇에 추가하려면 다음 단계를 따르세요.

  1. Create a Cisco Spark App – Spark for Developers 계정에서, Cisco Spark와 Kore.ai 봇 간의 통신에 대한 인증을 제공하기 위한 앱을 생성해야 합니다. Cisco Spark 앱을 생성하려면, Spark for Developers 포털에서 무료 계정을 생성하고 등록해야 합니다.
  2. Get an Access Token – Kore.ai 봇에 대한 채널로서 Cisco Spark를 이용하려면, 유효한 Spark Bot Username을 가지고 액세스 토큰을 생성하여 통신에 대한 인증을 제공합니다.
  3. Setup Integration – Kore.ai에 콜백 URL을 추가하고 Cisco Spark에서 메시지를 송수신하기 위한 Cisco Spark 앱 범위를 설정하여 Kore.ai 봇에 대한 Cisco Spark 통합을 정의합니다.
  4. Enable – Cisco Spark 앱을 설정하고 봇 빌더에서 설정 데이터를 입력한 후, 채널을 사용할 수 있도록 설정해야 합니다.

Cisco Webex Teams으로 봇 생성

  1. Log in to the Cisco Webex Developer Portal하고 Start Building Apps 페이지 또는 My Webex Apps 페이지로 이동하세요.
  2. Create a New App 옵션을 클릭하고 Create a Bot 옵션을 선택하세요.
  3. 봇을 생성하는 데 필요한 모든 정보를 제공하고 Add Bot를 클릭하세요.
  4. 이 단계에서는 Bot User를 생성하고 이 봇에 액세스하기 위한 Access Token도 생성합니다.
  5. 이 페이지에서 Bot Username 및 Access Token을 기록합니다.

봇 빌더에서 Cisco Webex Teams 채널을 사용할 수 있도록 설정

  1. 봇 빌더의 봇 섹션에서 Cisco Spark 채널을 추가하려는 봇을 클릭하세요.
  2. Channels 탭에서 Cisco Webex Teams 채널을 선택하여 해당하는 채널 페이지를 엽니다.
  3. 이전 단계의 Bot Username 및 Access Token을 입력합니다.
  4. Redirect URL을 기록합니다.

Cisco Webex Teams으로 통합(integration) 설정

  1. Cisco Webex Teams 개발자 포털에서, 오른쪽 상단의 Profile 드롭다운 목록을 클릭하고 My Webex Apps 페이지로 이동합니다.
  2. Create a New App을 클릭하고 Create an Integration 옵션을 선택하여 Spark에 새 통합 앱을 추가합니다.
  3. 통합 이름, 설명, 로고 등 통합 생성에 필요한 모든 세부 정보를 입력하세요. 이 정보는 권한 대화 상자에서 최종 사용자에게 표시되므로 사용자 지향적이어야 합니다.
  4. Redirect URI(s)의 경우 이전 단계에서 Redirect URL을 복사합니다.
  5. Scopes에서 spark:all을 선택하여 봇 통신을 활성화합니다.
  6. 필요한 모든 정보를 입력한 후 Add Integration를 클릭하여 새 통합 앱을 생성합니다.
  7. 이 단계에서는 새 통합 앱을 생성하고 이 앱의 클라이언트 ID와 클라이언트 시크릿도 생성합니다.
  8. Client ID 및 Client Secret을 기록합니다.

봇 빌더에서 Cisco Webex Teams 채널 설정 완료

  1. 봇 빌더 플랫폼의 채널 설정 페이지에서 이전 단계에 기록된 Client ID 및 Client Secret을 입력합니다.
  2. 설정을 완료하려면 Enable Channel를 합니다.
  3. 설정을 Save합니다.

Cisco Spark 채널 편집

Cisco Spark 채널을 편집하려면, 수정하기 위해 채널 위로 마우스를 이동한 후 표시된 Settings 아이콘을 클릭하여 명령 메뉴를 표시합니다. 채널을 수정하려면 다음과 같은 명령 중 하나를 선택하세요.

  • Edit – 클릭하여 Cisco Spark Channel 설정 페이지를 엽니다.
  • Disable/Enable – Disable을 클릭하여 봇의 Cisco Tropo 채널 사용을 일시적으로 비활성화하세요. 채널이 사용 안 함으로 설정된 경우, Cisco Tropo 채널 사용을 활성화하려면, Enable을 클릭하세요.
  • Delete – Delete를 클릭하세요. Delete Confirmation 대화 상자에서, OK를 클릭하여 봇 채널 설정을 영구적으로 삭제합니다.

    경고: 이 작업은 영구적이므로, 취소할 수 없습니다.

To add the Cisco Webex Teams (formerly Cisco Spark) channel to your bot, the developer must create a bot app and an integration app in Cisco Webex Teams.

Adding the Cisco Spark channel to your Kore.ai bot is a four-step process to allow end-users of your bot to interact with your bot using their Cisco Spark accounts. To add the Cisco Spark channel to your bot, follow the below steps:

  1. Create a Cisco Spark App – In your Spark for Developers account, you must create an app to provide authorization for communication between Cisco Spark and your Kore.ai bot. To create a Cisco Spark app, you must have created and registered for a free account in the Spark for Developers portal.
  2. Get an Access Token – To use Cisco Spark as a channel for your Kore.ai bot, have a valid Spark Bot Username and generate an access token to provide authentication for communications.
  3. Setup Integration – Define the Cisco Spark integration to your Kore.ai bot by adding the Call Back URL to Kore.ai and setting the Cisco Spark app Scopes to receive and send messages to and from Cisco Spark.
  4. Enable – After setting up the Cisco Spark app and entering configuration data in Bot Builder, you must enable the channel.

Create Bot with Cisco Webex Team

  1. Log in to the Cisco Webex Developer Portal and proceed to the Start Building Apps page or to the My Webex Apps page.
  2. Click the Create a New App option and choose the Create a Bot option.
  3. Provide all the required information to create the bot and click on Add Bot.
  4. This step will create a Bot User and an Access Token is also generated for accessing this bot.
  5. Make a note of the Bot Username and Access Token from this page.

Enable Cisco Webex Team channel from Bot Builder

  1. In Bot Builder, under the Bots section, click the bot that you want to add the Cisco Spark channel to.
  2. On the Channels tab, select the Cisco Webex Teams channel to open the corresponding channel page.
  3. Enter the Bot Username and Access Token from the previous step.
  4. Make a note of the Redirect URL.

Set Up Integration with Cisco Webex Team

  1. On the Cisco Webex Team Developer portal, click the Profile drop-down list on the top-right and go to the My Webex Apps page.
  2. Click Create a New App and choose the Create an Integration option to add a new integration app for Spark.
  3. Provide all the required details to create the integration like integration name, description, logo, etc. This information must be user-facing as this is displayed to end-users in the permissions dialog.
  4. For Redirect URI(s), copy Redirect URL from the previous step.
  5. Under Scopes, select spark:all for enabling bot communication.
  6. After providing all the required information, click the Add Integration to create the new integration app.
  7. This step creates a new integration app and also generates the Client ID and Client Secret for this app.
  8. Make a note of the Client Id and Client Secret.

Complete Cisco Webex Team Channel Configuration from Bot Builder

  1. In the Bot Builder platform, on the Channel Configuration page, enter the Client ID and Client Secret noted in the previous step.
  2. Enable Channel to complete the configuration.
  3. Save the configuration.

Edit Cisco Spark Channel

To edit the Cisco Spark channel, hover over the channel to modify, and then click the Settings icon displayed to show the command menu.

Select one of the following commands to modify the channel:

  • Edit – Click to open the Cisco Spark Channel setup page.
  • Disable/Enable – Click Disable to temporarily disable the use of the Cisco Spark channel for your bot. When the channel is disabled, click Enable to enable the use of the Cisco Spark channel.
  • Delete – Click Delete. On the Delete Confirmation dialog box, click OK to permanently delete the bot channel configuration.

    Warning: This operation is permanent, and cannot be undone.