Microsoft Teams自定义应用实现in-app/bubble气泡通知的方法咨询
MS Teams 应用内气泡/角标通知实现方案
你需要的两类通知都有对应的官方原生实现能力,不需要通过Bot发送频道/聊天消息,具体实现逻辑如下:
1. 应用导航项未读角标(类似聊天栏的未读数气泡)
该能力对应Teams官方的应用徽标角标能力,展示在用户侧边栏固定的应用图标、应用内tab导航入口位置,实现步骤:
- 首先在应用配置清单
manifest.json中,配置对应staticTabs/configurableTabs时添加"showBadge": true字段,开启角标展示权限 - 应用前端接入Teams JS SDK,调用对应API更新角标数值即可,核心代码参考:
// 先初始化SDK完成应用加载通知 microsoftTeams.appInitialization.notifyAppLoaded(); // 设置角标数值,传0即可清空角标 microsoftTeams.menus.setAppBadgeCount(待办数量);
- 支持服务端主动触发更新,无需用户打开应用即可同步角标状态。
2. 活动中心(铃铛图标)待处理通知
该能力对应Teams的用户活动通知能力,发送后仅在顶部铃铛的活动列表展示,不会出现在任何聊天/频道场景,实现步骤:
- 在应用配置清单
manifest.json中声明activityTypes字段,预定义通知类型模板,示例如下:
"activityTypes": [ { "type": "todoReminder", "description": "待办事项提醒", "templateText": "你有1条待办待处理:{todoName}" } ]
- 应用申请
TeamsActivity.Send的Graph API权限,调用/users/{用户ID}/teamwork/sendActivityNotification接口,指定提前定义的通知类型和模板参数即可完成推送,推送成功后铃铛图标就会展示对应的未读活动数。
注意事项
- 两类能力都完全符合你要求的in-app气泡通知逻辑,不会产生额外的聊天/频道消息
- 所有API的参数规则、权限配置要求可直接参考Teams官方开发文档的对应模块
内容的提问来源于stack exchange,提问作者Lakshay Gupta
相关产品推荐
相关产品推荐

