次の方法で共有

Teams 会議の会議内通知を作成する

  • [アーティクル]

会議内通知は、参加者を関与させ、会議中に情報やフィードバックを収集するために使用されます。 会議中の通知をトリガーするには、会議中の通知ペイロードを使用します。 通知ペイロード要求の一部として、表示するコンテンツがホストされている URL を含めます。

会議中の通知を表示するには、外部リソース URL を使用します。 会議チャットでデータを送信するには、submitTask メソッドを使用します。

次の図は、Teams デスクトップ クライアントの会議内通知を示しています。

Teams デスクトップでの会議内通知を示すスクリーンショット。

また、Teams の表示画像と連絡先カードを、ユーザーのMRI とペイロードで渡された表示名を持つトークン onBehalfOf に基づいて、会議中の通知に追加することもできます。 ペイロードの例を次に示します:

    {
       "type": "message",
       "text": "John Phillips assigned you a weekly todo",
       "summary": "Don't forget to meet with Marketing next week",
       "channelData": {
           onBehalfOf: [
             { 
               itemId: 0, 
               mentionType: 'person', 
               mri: context.activity.from.id, 
               displayname: context.activity.from.name 
             }
            ],
           "notification": {
           "alertInMeeting": true,
           "externalResourceUrl": "https://teams.microsoft.com/l/bubble/APP_ID?url=<url>&height=<height>&width=<width>&title=<title>&completionBotId=BOT_APP_ID"
            }
        },
       "replyToId": "1493070356924"
    }

Teams の表示画像とユーザー カードが会議内ダイアログでどのように使用されるかを示すスクリーンショット。

ユーザーの種類別の機能の互換性

次の表に、ユーザーの種類と、各ユーザーが会議でアクセスできる機能の一覧を示します。

ユーザーの種類 スケジュールされた会議またはインスタント 予定表会議 1 対 1 の呼び出し グループ呼び出し スケジュールされたチャネル会議
テナント内 使用可能 使用可能 使用可能 使用可能
Guest 使用可能 使用可能 使用可能 使用可能
フェデレーションまたは外部 使用可能 使用不可 使用不可 使用可能
匿名 使用可能 使用不可 使用不可 使用不可

対象の会議内通知

対象の会議内通知を使用すると、アプリは会議ステージ上の特定の参加者に通知を送信できます。 通知はプライベートであり、特定の参加者または対象の参加者にのみ送信されます。 対象を絞った会議内通知は、会議のエクスペリエンスを向上させ、Teams 会議でのユーザー エンゲージメント アクティビティを開発するのに役立ちます。

注:

対象の会議内通知は、スケジュールされた会議、インスタント 会議 (今すぐ会議)、1 対 1 通話、グループ通話でサポートされます。

次の図では、支払いを要求する会議通知が会議の参加者のいずれかに送信されます。 会議通知は、対象の参加者にのみ表示されます。

支払いを要求する対象の参加者に送信される会議通知の例を示すスクリーンショット。

対象の会議内通知のアプリ マニフェスト設定を有効にする

対象の会議内通知を送信するには、アプリ マニフェストの [resourceSpecific] フィールドで、authorization プロパティと name プロパティと type プロパティを次のように構成する必要があります。


"webApplicationInfo": {
    "id": "<<MICROSOFT-APP-ID>>",
    "resource": "https://RscBasedStoreApp"  },
  "authorization": {
    "permissions": {
      "resourceSpecific": [
        {
          "name": "OnlineMeetingNotification.Send.Chat",
          "type": "Application"        }
      ]
    }
  }

対象の会議内通知を有効にする

注:

対象となる会議内通知は、1 回の API 呼び出しで 50 人の会議参加者にのみ送信できます。 対象の会議内通知を 50 人以上の参加者に送信する場合は、 targetedMeetingNotification API をもう一度呼び出す必要があります。

対象の会議内通知は、ユーザー アクションによってトリガーできます。

対象の会議内通知を有効にするには:

  1. Get participant API と Get members API を使用して 、参加者 のユーザー ID を取得します。

    注:

    対象の会議内通知では、Microsoft Entra ユーザー ID 形式のユーザー ID はサポートされていません。

    ユーザー ID の例を次に示します。 id=29:1I12M_iy2wTa97T6LbjTh4rJCWrtw2PZ3lxpD3yFv8j2YPnweY2lpCPPAn3RIOPP7rghfHauUz48I1t7ANhj4CA

  2. 要求パラメーターにユーザー ID を含めます。

    要求の例を次に示します。

     POST /v1/meetings/{meetingId}/notification

    ペイロードの例を次に示します。

    {
  "type": "targetedMeetingNotification",
  "value": {
    "recipients": [ 
    "29:1I12M_iy2wTa97T6LbjTh4rJCWrtw2PZ3lxpD3yFv8j2YPnweY2lpCPPAn3RI0PP7rghfHauUz48I1t7ANhj4CA"
     ], 
    "surfaces": [ 
      { 
        "surface": "meetingStage", 
        "contentType": "task", 
        "content": { 
          "value": { 
            "height": "300", 
            "width": "400", 
            "title": "Targeted meeting Notification", 
            "url": "https://somevalidurl.com"           
            }
        } 
      } 
    ] 
  },
  "channelData": { // optional if a developer doesn't want to support user attributes.
    "onBehalfOf": [ 
      { 
        "itemid": 0, 
        "mentionType": "person", 
        "mri": "29:1mDOCfGM9825lMHlwP8NjIVMJeQAbN-ojYBT5VzQfPpnst1IFQeYB1QXC8Zupn2RhgfLIW27HmynQk-4bdx_YhA", 
        "displayName": "yunny chung"      } 
    ] 
  }
}

    対象の会議内通知が有効になっています。

targetedMeetingNotificationの詳細については、「対象の会議の通知とアプリ アイコンのバッジ API」を参照してください。

アプリの会議内通知を作成したら、 targetedMeetingNotification API を使用して、会議アプリのアプリ アイコンのバッジを有効にすることができます。 これにより、会議参加者は、アプリに新しいアクティビティがあるたびに通知を受け取ることができます。 詳細については、「 Teams アプリのアプリ アイコンのバッジを有効にする」を参照してください。

コード サンプル

サンプルの名前 説明 .NET Node.js マニフェスト
会議中の通知 ボットを使用して会議内通知を実装する方法を示します。 表示 表示 表示

ステップ バイ ステップのガイド

詳細なガイドに従って、Teams 会議で会議内通知を生成します。

関連項目