为 Teams 会议生成会议内通知

项目
11/14/2023

会议内通知用于在会议期间吸引参与者并收集信息或反馈。使用会议内通知有效负载触发会议内通知。作为通知有效负载请求的一部分，包括托管要显示内容的 URL。

外部资源 URL 用于显示会议内通知。可以使用该 submitTask 方法在会议聊天中提交数据。

桌面设备
移动设备

下图显示了 Teams 桌面客户端中的会议内通知：

屏幕截图显示了 Teams 桌面上的会议内通知。

还可以将用户的 Teams 显示图片和人员卡添加到会议内通知中，具体取决于onBehalfOf具有用户 MRI 的令牌以及传入有效负载的显示名称。下面是一个示例有效负载：

    {
       "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 中的显示图片和人员卡。

按用户类型分类的功能兼容性

下表提供了用户类型，并列出了每个用户都可以在会议中访问的功能：

用户类型	计划会议或即时日历会议	一对一通话	群组呼叫	计划的频道会议
租户内	可用	可用	可用	可用
Guest	可用	可用	可用	可用
联合或外部	可用	不可用	不可用	可用
匿名	可用	不可用	不可用	不可用

目标会议内通知

有针对性的会议内通知允许应用在会议阶段向特定参与者发送通知。通知是专用的，仅发送给特定或目标参与者。有针对性的会议内通知有助于在 Teams 会议中增强会议体验和开发用户参与活动。

注意

计划会议、即时会议 (现在会议) 、一对一呼叫和群组呼叫支持有针对性的会议内通知。

在下图中，请求付款的会议通知将发送给会议中的一个参与者。会议通知仅对目标参与者可见：

屏幕截图显示了向请求付款的目标参与者发送的会议通知的示例。

为目标会议内通知启用应用清单设置

若要发送有针对性的会议内通知，必须在应用清单的字段下resourceSpecific配置 authorization 属性和 name 和 type 属性，如下所示：


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

启用有针对性的会议内通知

注意

在单个 API 调用中，只能向 50 个会议参与者发送有针对性的会议内通知。如果要向超过 50 名参与者发送有针对性的会议内通知，则必须再次调用 API targetedMeetingNotification 。

用户操作可以触发有针对性的会议内通知。

若要启用目标会议内通知，请执行以下操作：

通过获取参与者 API 和获取成员 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。

为应用生成会议内通知后，可以使用 targetedMeetingNotification API 为会议应用启用应用图标标记。这有助于会议参与者在应用中有新活动时收到通知。有关详细信息，请参阅为 Teams 应用启用应用图标标记。

代码示例

示例名称	Description	.NET	Node.js	清单
会议内通知	演示如何使用机器人实现会议内通知。	View	View	View

分步指南

按照分步指南在 Teams 会议中生成会议内通知。