Teams 集成注意事项
可以通过将Microsoft Teams 的社交和协作功能与 Teams 正确集成,使 Web 应用适合这些应用。
可与 Teams 集成的不同类型的应用如下所示:
- 独立应用:独立应用是单页或大型复杂应用。 用户可以在 Teams 中使用它的某些方面。
- 协作应用:为 Teams 固有的社交和协作功能构建的现成应用。
- Microsoft SharePoint:要在 Teams 中呈现的 SharePoint 页面。
可以映射并遵循适用于集成方案的相应准则。 本文档概述了 Teams 功能、文件和数据存储的 SharePoint 要求、API 要求、身份验证以及应用与 Teams 的深层链接。
了解 Teams 平台功能
集成方案:独立应用、协作应用、SharePoint
Teams 应用必须包含必需和预期的协作功能。 若要使用应用集成,请务必熟悉 Teams 开发术语。
常见应用功能 | Teams 平台功能 |
---|---|
内嵌网页、主页或 Web 视图 |
选项卡 跨 Microsoft 365 扩展的选项卡 |
共享快捷方式和扩展 |
消息扩展 Outlook 的邮件扩展 |
操作快捷方式和扩展 | 消息扩展 |
聊天机器人 | 机器人 |
频道通知 |
机器人 传入 Webhook 用于 Microsoft 365 组的连接器 |
消息外部服务 |
机器人 传出 Webhook |
模式 | 对话 (TeamsJS v1.x) 中称为任务模块 |
内容丰富的卡片 | 自适应卡 |
确定功能子集
集成方案:独立应用
将现有应用程序的所有功能集成到 Teams 通常会导致生硬或突兀的用户体验,尤其是大型应用。 要先从最具影响力的功能和与 Teams 集成更自然的功能开始。 你可以允许用户启动主应用并访问其完整功能集。
以下是将应用与 Teams 集成的先决条件。
- 将应用用例映射到 Teams 平台功能。
- 确定应用的入口点。 是供个人使用、协作还是二者兼顾?
了解 SharePoint 要求和选项
集成方案:SharePoint
若要将现有 SharePoint 页面集成为 Teams 选项卡,必须考虑以下事项:
- 它必须是新式 SharePoint Online 页面。
- 仅支持个人选项卡。 无法将页面集成为频道选项卡。
或者,可以使用 SharePoint 框架生成 Teams 选项卡。
面向多组织
集成方案:独立应用、协作应用、SharePoint
如果应用由多个组织使用,请考虑多组织托管。 这会使产品可缩放并简化分发。
审查 API
集成方案:独立应用、协作应用
与 Teams 集成时,应用的 API 和数据结构必须支持应用。 若要扩展支持,必须使用有关 Teams 的上下文信息来增强 API 和数据结构,用于标识映射、深层链接支持以及整合 Microsoft Graph。
了解身份验证选项
集成方案:独立应用、协作应用、SharePoint
Microsoft Entra ID 是 Teams 的标识提供者。 如果应用使用不同的标识提供者,则必须执行标识映射练习,或与Microsoft Entra ID 结合使用。
Teams 具有单一登录 (SSO) 机制,其中包含第三方应用的 Microsoft Entra ID。 它还提供了使用 OAuth 和 OpenID Connect(称为 OIDC)等标准向其他标识提供者进行身份验证流的指导。
重要
第三方应用在政府社区云 (GCC) 中可用,但不适用于 GCC-High 和国防部 (DOD) 。 GCC 默认关闭第三方应用。 若要为 GCC 启用第三方应用,请参阅管理应用权限策略和管理应用。
对于 SharePoint 页面,如果希望 SSO 适用于其他应用,则只能使用 SSO,并且不能添加其他Microsoft Entra ID,因为该 ID 是 SharePoint 应用程序。
详细了解 Teams 中的身份验证。
遵循 Teams 机器人设计准则
集成方案:独立应用、协作应用
请确保遵循 Teams 设计准则,以便应用原生支持 Teams。 无法将现有应用内容迁移到 Teams 选项卡。有关应用设计的详细信息,请参阅 Fluent Design System。
最大程度地运用深层链接
集成方案:独立应用、协作应用、SharePoint
你可以创建 Teams 中的信息和功能的链接。 使用深层链接将应用与 Teams 链接在一起,因为这些链接将应用的多个部分绑定在一起,以获得更原生的 Teams 体验。
向用户智能发送消息
集成方案:独立应用、协作应用、SharePoint
在 Teams 应用中使用机器人进行多线程会话,因为这比 Webhook 更具灵活性。
机器人还允许向单个用户或频道发送主动消息。 主动消息是由外部事件(而非发送给机器人的消息)触发的无提示消息。 例如,机器人在安装或新用户加入频道时发送欢迎消息。
发送主动消息需要特定于 Teams 的标识符。 可以通过提取名单或用户配置数据、订阅聊天事件或使用 Microsoft Graph 来获取该信息。
不要对用户发送过多邮件的垃圾邮件。 如果 Teams 功能支持,用户可以为应用配置通知设置。 通知消息示例如下:请勿向我发送无提示消息。
使用 SharePoint 进行文件和数据存储
集成方案:独立应用、协作应用、SharePoint 页面
创建团队时,还会预配 SharePoint 网站集,以支持该团队的文件和数据存储。 如果应用与文件交互,则应用必须利用此功能。 使用该网站集将原始数据存储在 SharePoint 列表和 Microsoft Excel 中。