Oracle Cloud Infrastructureドキュメント

Microsoft Teams

Microsoft Teamsチャネルを設定する際、ユーザーは、Microsoft Teams Chatウィンドウでデジタル・アシスタント(またはスタンドアロン・スキル)とチャットできます。

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

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

ステップ1: Microsoftへのチャネル登録の作成

デジタル・アシスタント(またはスタンドアロン・スキル)をMicrosoft Teamsで使用できるようにするには、次のいずれかに登録する必要があります:

Azureボットのチャネル登録

Azureを使用してボットのチャネル登録を作成するには、次のようにします:

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

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



  3. チャネル登録ページで、Microsoft Teamを介してデジタル・アシスタントにアクセスする際に使用する名前をボット名フィールドに入力します。

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

  5. MicrosoftアプリケーションのIDとパスワードセクションまでスクロールし、展開して新規作成をクリックします。

    新しいブラウザ・タブがオープンし、Azureポータルのアプリケーション登録ブレードにリダイレクトされます。

  6. 新規登録をクリックします。

  7. サポートされるアカウント・タイプセクションで、任意の組織ディレクトリ内のアカウント(任意のAzure ADディレクトリ) - マルチテナント)および個人Microsoftアカウント(Skype、Xboxなど)ラジオ・ボタンを選択します。

  8. 残りの必須フィールドに入力し、登録をクリックします。

    しばらくすると、アプリケーション登録を完了する必要があります。

  9. 概要ブレードで、アプリケーション(クライアント) IDの値をコピーし、システムの安全な場所に保存します。

  10. 証明書とシークレットブレードを選択します。

  11. +新規クライアント・シークレットをクリックし、説明を入力して、有効期限が切れる時間を選択し、追加をクリックします。

  12. クライアント・シークレットをコピーし、システムの安全な場所に保存します。

  13. Azure Portalはブラウザで開いたままにします。

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

「ステップ2: Digital Assistantでのチャネルの作成」に進んでください。

ボット・フレームワーク・チャネル登録

Microsoft Bot Frameworkを使用して登録を作成するには:

  1. https://dev.botframework.com/bots/newに移動し、Office 365ユーザー・アカウントを使用してログインします。 アカウントはE1計画以上に属する必要があります。

  2. Microsoft Teamsでデジタル・アシスタントを表すアイコンをアップロードします。

  3. 表示名ボット・ハンドルおよび詳細な説明の各フィールドに入力します。

    ノート

    ボット・ハンドルはすべてのグローバル・メタデータを通じて一意であるため、値にデジタル・アシスタント名とMicrosoft Teamsテナントの両方を組み込むことをお薦めします。
  4. ストリーミング・エンドポイント・チェック・ボックスは有効にしません。

  5. MicrosoftアプリケーションIDとパスワードを作成をクリックします。

    新しいブラウザ・タブがオープンし、Azureポータルのアプリケーション登録ブレードにリダイレクトされます。

    ノート

    AzureでアプリケーションIDを生成しても、ボット登録自体はMicrosoft Bot Frameworkを介して管理されます。
  6. 新規登録をクリックします。

  7. サポートされるアカウント・タイプセクションで、任意の組織ディレクトリ内のアカウント(任意のAzure ADディレクトリ) - マルチテナント)および個人Microsoftアカウント(Skype、Xboxなど)ラジオ・ボタンを選択します。

  8. 残りの必須フィールドに入力し、登録をクリックします。

    しばらくすると、アプリケーション登録を完了する必要があります。

  9. 概要ブレードで、アプリケーション(クライアント) IDの値をコピーし、システムの安全な場所に保存します。

  10. 証明書とシークレットブレードを選択します。

  11. +新規クライアント・シークレットをクリックし、説明を入力して、有効期限が切れる時間を選択し、追加をクリックします。

  12. クライアント・シークレットをコピーし、システムの安全な場所に保存します。

  13. 前のブラウザ・タブに戻ります。
  14. Microsoftアプリケーション登録ポータル・フィールドのMicrosoftアプリケーションIDで、アプリケーション登録からコピーしたアプリケーションIDを貼り付けます。
  15. 「ボット・フレームワーク」ページはブラウザで開いたままにします。

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

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

  1. 別のブラウザ・ウィンドウまたはタブでDigital Assistantを開き、左側のメニューのチャネルをクリックして、ユーザーを選択します。

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

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

  4. チャネル・タイプとしてMicrosoft Teamsを選択します。

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

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

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

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

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

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

ステップ3: Microsoft TeamsのWebフックURLの構成

  1. ボットをAzureに登録した場合:

    1. ボット登録を設定したブラウザ・タブで、検索フィールドを使用してボット登録を復旧します。

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

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

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

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

  2. ボットをMicrosoftボット・フレームワークに登録した場合:

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

    2. アナリティクスを使用可能にしないでください。

    3. 同意ボックスを選択し、登録をクリックします。

    4. 登録したボットを選択します。

    5. チャネルタブで、Microsoft Teamsのアイコンをクリックして、Microsoft Teamsをチャネルとして追加します。

    6. 保存をクリックして、Microsoft Teamsの構成ダイアログを閉じます。

ステップ4: Office 365テナントでアプリケーションを有効化

次に、Office 365管理者が次の目的でテナントを構成する必要があります:

  • Microsoft Teamsの外部アプリケーションを許可します。
  • 外部アプリケーションのサイド・ロードを許可します。
  • デフォルトで新しい外部アプリケーションを有効化します。

具体的なステップは、https://docs.microsoft.com/en-us/microsoftteams/platform/get-started/get-started-tenantを参照してください。

ステップ5: Microsoft Teamsでのボットのテスト

Microsoft Teamsチャネルとメッセージの構成が完了したら、Microsoft Teamsでボット(デジタル・アシスタントまたはスキル)をテストできます。

  1. Microsoft Teamsを開き、チャット・ウィンドウを選択します。

  2. メッセージ・フィールドで、ボット・チャネルを選択し、通信を開始します。

    ボットのチャネルのエントリが表示されない場合、ボットのチャネル登録のMicrosoftアプリidをチャット画面の終了セクションにペーストできます。 詳細は、https://docs.microsoft.com/en-us/microsoftteams/platform/concepts/bots/bots-test#adding-a-bot-for-personal-chatを参照してください。

サポートされている機能

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

  • テキスト(送信と受信の両方)
  • イメージ(送信と受信の両方)
  • ファイル(送信と受信の両方)
  • フィールド(送信と受信の両方)
  • links
  • ポストバック
  • カスタム・プロパティ
  • carouselコンポーネント
  • リスト・コンポーネント

メッセージの制約

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

  • テキスト・メッセージ
    • テキスト・アクション・ラベルの最大長: 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

Microsoft Teams拡張機能

Microsoft Teamsのチャネルの場合は、Microsoft Teamsに固有のカード・タイプおよびその他のメタデータを使用するように、System.CommonResponseコンポーネントを拡張できます。 使用可能なコンテンツ・タイプは次のとおりです。

  • application/vnd.microsoft.card.thumbnail
  • application/vnd.microsoft.card.hero
  • application/vnd.microsoft.teams.card.list
  • application/vnd.microsoft.card.adaptive
  • application/vnd.microsoft.teams.card.o365connector
  • application/vnd.microsoft.teams.file.download.info
  • application/vnd.microsoft.com.card.receipt
  • application/vnd.microsoft.com.card.signin

System.CommonResponseコンポーネントのchannelCustomProperties要素を使用し、contentTypeプロパティをカード・タイプに設定して、カード・タイプを宣言します。 コードの書式は次のとおりです:

...
          cards:
            ...
            channelCustomProperties:
            - channel: "msteams"
              properties:
                contentType: "contentTypeValue"
...

たとえば、次のコードを含むサムネイル・カードを構成できます:

...
          cards:
          - title: "${ateam.firstName} ${ateam.lastName}"
            description: "${ateam.title}"
            imageUrl: "${ateam.photo}"
            cardUrl: "${ateam.linkedin}"
            name: "PersonCard"
            iteratorVariable: "ateam"
            channelCustomProperties:
            - channel: "msteams"
              properties:
                contentType: "application/vnd.microsoft.card.thumbnail"
            actions:
...

サムネイルおよびカードについては、カードが機能するようにcontentTypeプロパティを設定するだけで済みます。 その他のコンテンツ・タイプの場合は、他のメタデータも設定する必要があります。