Teams 会議の会議内通知を作成する
会議内通知は、参加者を関与させ、会議中に情報やフィードバックを収集するために使用されます。 会議中の通知をトリガーするには、会議中の通知ペイロードを使用します。 通知ペイロード要求の一部として、表示するコンテンツがホストされている URL を含めます。
会議中の通知を表示するには、外部リソース URL を使用します。 会議チャットでデータを送信するには、submitTask メソッドを使用します。
また、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"
}
ユーザーの種類別の機能の互換性
次の表に、ユーザーの種類と、各ユーザーが会議でアクセスできる機能の一覧を示します。
| ユーザーの種類 | スケジュールされた会議またはインスタント 予定表会議 | 1 対 1 の呼び出し | グループ呼び出し | スケジュールされたチャネル会議 |
|---|---|---|---|---|
| テナント内 | 使用可能 | 使用可能 | 使用可能 | 使用可能 |
| Guest | 使用可能 | 使用可能 | 使用可能 | 使用可能 |
| フェデレーションまたは外部 | 使用可能 | 使用不可 | 使用不可 | 使用可能 |
| 匿名 | 使用可能 | 使用不可 | 使用不可 | 使用不可 |
対象の会議内通知
対象の会議内通知を使用すると、アプリは会議ステージ上の特定の参加者に通知を送信できます。 通知はプライベートであり、特定の参加者または対象の参加者にのみ送信されます。 対象を絞った会議内通知は、会議のエクスペリエンスを向上させ、Teams 会議でのユーザー エンゲージメント アクティビティを開発するのに役立ちます。
注:
対象の会議内通知は、スケジュールされた会議、インスタント 会議 (今すぐ会議)、1 対 1 通話、グループ通話でサポートされます。
次の図では、支払いを要求する会議通知が会議の参加者のいずれかに送信されます。 会議通知は、対象の参加者にのみ表示されます。
対象の会議内通知のアプリ マニフェスト設定を有効にする
対象の会議内通知を送信するには、アプリ マニフェストのフィールドのプロパティと プロパティと typename プロパティをresourceSpecific次のように構成authorizationする必要があります。
"webApplicationInfo": {
"id": "<<MICROSOFT-APP-ID>>",
"resource": "https://RscBasedStoreApp" },
"authorization": {
"permissions": {
"resourceSpecific": [
{
"name": "OnlineMeetingNotification.Send.Chat",
"type": "Application" }
]
}
}
対象の会議内通知を有効にする
注:
対象となる会議内通知は、1 回の API 呼び出しで 50 人の会議参加者にのみ送信できます。 対象の会議内通知を 50 人以上の参加者に送信する場合は、もう一度 API を targetedMeetingNotification 呼び出す必要があります。
対象の会議内通知は、ユーザー アクションによってトリガーできます。
対象の会議内通知を有効にするには:
Get participant API と Get members API を使用して 、参加者 のユーザー ID を取得します。
注:
対象の会議内通知では、Microsoft Entraユーザー ID 形式のユーザー ID はサポートされません。
ユーザー ID の例を次に示します。
id=29:1I12M_iy2wTa97T6LbjTh4rJCWrtw2PZ3lxpD3yFv8j2YPnweY2lpCPPAn3RIOPP7rghfHauUz48I1t7ANhj4CA要求パラメーターにユーザー 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」を参照してください。
アプリの会議内通知を作成したら、API を使用して、会議アプリの targetedMeetingNotification アプリ アイコンのバッジを有効にすることができます。 これにより、会議参加者は、アプリに新しいアクティビティがあるたびに通知を受け取ることができます。 詳細については、「 Teams アプリのアプリ アイコンのバッジを有効にする」を参照してください。
コード サンプル
| サンプルの名前 | 説明 | .NET | Node.js | マニフェスト |
|---|---|---|---|---|
| 会議中の通知 | ボットを使用して会議内通知を実装する方法を示します。 | 表示 | 表示 | 表示 |
ステップ バイ ステップのガイド
詳細なガイドに従って、Teams 会議で会議内通知を生成します。
関連項目
Platform Docs
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示