Oracle Cloud Infrastructureドキュメント

Skype for Business

Skype for Businessチャネルを設定すると、ユーザーは、Skype for Businessユーザー・インタフェースを通じてデジタル・アシスタント(スタンドアロン・スキル)とチャットできます。

チャネルを設定するプロセスを次に示します:

  1. Microsoft Azureでボット登録を作成して、デジタル・アシスタントと統合します。
  2. ボット登録からアプリケーションIDとパスワードを使用して、Digital Assistantにチャネルを作成します。
  3. チャネルの作成時に生成されたwebフックURLをコピーして、ボット登録に追加します。
  4. Skype for Businessテナント管理者がボットをテナントに追加します。
  5. デジタル・アシスタントは、Skypeユーザー・インタフェースのチャット・ウィンドウでテストします。

ステップ1: Azureでのボットのチャネル登録の作成

Skype for Businessでデジタル・アシスタント(またはスタンドアロン・スキル)を使用可能にするには、Azure Bot Serviceを使用して登録しておく必要があります。

この登録を作成する前に、Microsoftアカウントが必要です。

登録を作成する手順は、次のとおりです:

  1. https://portal.azure.com/に移動し、Microsoftアカウントでログインします。

  2. 検索フィールドで、チャネル登録を検索して選択します。

  3. チャネル登録ページで、Skype for Businessのチャット・ウィンドウにエントリとして表示する名前をボット名フィールドに入力します。

  4. 残りの必須フィールドに入力します。

  5. 下にスクロールしてアプリケーションIDとパスワードを自動作成を選択し、表示されたパネルでアプリケーションIDとパスワードを自動作成のボタンをクリックします。

  6. 「作成」(コールバック)をクリックします。

  7. ボット登録の作成とデプロイを1分または2時間待機します。

    完了すると、デプロイメントが成功したことが通知されます。

  8. 通知で、リソースに移動をクリックします。

    通知がクリックされる前に消えた場合は、ページの上部にある通知アイコンをクリックして、再び通知を開くことができます。
    azure-notification.pngの説明は以下のとおりです
    図azure-notification.pngの説明

  9. 左側のナビゲーション・バーのBot Managementの下にある設定を選択します。
  10. MicrosoftアプリIDの値をコピーし、安全な場所に保存します。

  11. クライアント・シークレットを生成し、保存します。 これには次のようにします。
    1. アプリケーションIDの横にあるManageボタンをクリックします。

      Microsoft Bot Frameworkコンソールが表示されます。

    2. Azureポータルでこのアプリケーションを表示をクリックします。

      これで、Azureに戻ります。

    3. 左側のナビゲーションで、証明書&のシークレットをクリックします。
    4. +新規クライアント・シークレットをクリックします。
    5. 追加をクリックします。
    6. クライアント・シークレットをコピーし、システムの安全な場所に保存します。

    チャネルをDigital Assistantで構成するには、アプリIDとクライアント・シークレットの両方が必要です。

  12. クライアント・シークレットがコピーされたので、証明書&のシークレットダイアログを閉じます。
  13. Azure Portalはブラウザで開いたままにします。

    Digital Assistantでチャネルを作成するときに表示されるWebフックURLの登録を、後で完了します。

ステップ2: Digital Assistantでのチャネルの作成

  1. Digital Assistantの左側のメニューでチャネルをクリックして、ユーザーを選択します。

  2. +チャネルをクリックして「チャネルの作成」ダイアログを開きます。

  3. チャネルの名前を指定してください。

  4. チャネル・タイプとしてSkype For Businessを選択します。

  5. Azureにボット登録を作成したときに取得したMicrosoftアプリケーションIDをMicrosoftアプリケーションidに入力します。

  6. ボット登録から取得したクライアント・シークレットを使用して、Microsoftアプリケーション・パスワードに入力します。

  7. 「作成」(コールバック)をクリックします。

  8. チャネル・ページで、WebHook URLをコピーして、システム上の都合のよい場所に貼り付けます。

  9. ルート先...ドロップダウンのアイコンをクリックし、チャネルに関連付けるデジタル・アシスタントまたはスキルを選択します。

  10. チャネル有効コントロールに切り替えます。

ステップ3: Skype for BusinessのWebフックURLの構成

  1. Azure Portalを開いているブラウザ・タブで、検索フィールドを使用してボット登録に戻ります。

  2. 左側のナビゲーション・バーで、設定を選択します。

  3. メッセージング・エンドポイントフィールドに、Digital Assistantでチャネルを作成したときに取得したwebフックURLを貼り付けます。

  4. 左側のナビゲーション・バーのBot Service内で、「Bot管理」セクションまでスクロールし、チャネルをクリックします。

  5. Skypeのアイコンをクリックし、保存をクリックします。

ステップ4: Skype for Businessテナントにボットを追加

Azureでボット登録を作成し、Digital Assistantのチャネルを作成した後は、その両方をSkype for Businessテナントに追加する必要があります。 https://docs.microsoft.com/en-us/skype-sdk/skype-for-business-bot-framework/docs/overview#add-a-bot-to-skype-for-businessを参照してください。

ステップ5: Skype for Businessでのボットのテスト

Skype for Businessに追加されたボット(デジタル・アシスタントまたはスキル)で、Skype for Businessでテストできるようになりました。

  1. Skype for Businessを開きます。

  2. チャットをクリックし、チャットボタンをクリックして、新規チャットを選択します。

  3. 新規チャット・ウィンドウで、検索フィールドを使用してボットを見つけます。

  4. ここにメッセージを入力フィールドで、デジタル・アシスタントと通信を開始します。

サポートされている機能

Digital AssistantのSkype for Businessチャネルでは、次の機能がサポートされています:

  • テキスト(送信と受信の両方)
  • emojis (送信の部分サポート、受信の完全サポート)
  • links
  • カルーセル・コンポーネント(部分サポート)
  • リスト・コンポーネント(部分サポート)

メッセージの制約

Digital AssistantのSkype for Businessチャネルには、次のメッセージ制約があります:

  • テキスト・メッセージ
    • テキスト・アクション・ラベルの最大長: 1行(約50文字)
    • 許可されるテキスト・アクションのタイプ: ポストバック、コール、URL
  • 水平カード
    • タイトルの最大長: 2行(約80文字)
    • 摘要の最大長: 25,000文字
    • カード処理ラベルの最大長: 1行(約50文字)
    • カードの最大数: 10
    • カード処理の最大数: 6。 カード処理の数が6を超える場合、カードが複製され、残りのカード処理がレンダリングされます。
    • カード処理の最小数: 0
    • カード・リスト・アクションの最大数: 6
    • 少なくとも1つの説明、イメージまたはアクションが必要ですか: いいえ
    • 許可されているカード処理のタイプ: ポストバック、コール、URL
    • カード・リスト処理のタイプ許可: ポストバック、コール、URL
  • 垂直カード
    • タイトルの最大長: 2行(約80文字)
    • 摘要の最大長: 25,000文字
    • カード処理ラベルの最大長: 1行(約50文字)
    • カードの最大数: 10
    • カード処理の最大数: 3
    • カード処理の最小数: 0
    • カード・リスト・アクションの最大数: 6
    • 少なくとも1つの説明、イメージまたはアクションが必要ですか: いいえ
    • 許可されているカード処理のタイプ: ポストバック、コール、URL
    • カード・リスト処理のタイプ許可: ポストバック、コール、URL
  • アタッチメント・メッセージ
    • サポート対象: Yes
    • 許可されるアクションのタイプ: ポストバック、コール、URL
  • 処理ボタン
    • グローバル・アクション・ラベルの最大長: 1行(約50文字)
    • グローバル・アクションの最大数: 6
    • 許可されるグローバル・アクションのタイプ: ポストバック、コール、URL