Teams 集成注意事项

  • 项目

通过将 Web 应用与 Teams 正确集成，可以使 Web 应用适合 Teams 的社交和协作功能。

可与 Teams 集成的不同类型的应用如下所示：

  • 独立应用：独立应用是单页或大型复杂应用。 用户可以在 Teams 中使用它的某些方面。
  • 协作应用：为 Teams 固有的社交和协作功能构建的现成应用。
  • 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 集成的先决条件。

  1. 将应用用例映射到 Teams 平台功能。
  2. 确定应用的入口点。 是供个人使用、协作还是二者兼顾？

了解 SharePoint 要求和选项

集成方案：SharePoint

若要将现有 SharePoint 页面集成为 Teams 选项卡，必须考虑以下事项：

  • 它必须是新式 SharePoint Online 页面。
  • 仅支持个人选项卡。 无法将页面集成为频道选项卡。

或者，可以使用 SharePoint 框架生成 Teams 选项卡。

面向多组织

集成方案：独立应用、协作应用、SharePoint

如果应用由多个组织使用，请考虑多组织托管。 这会使产品可缩放并简化分发。

审查 API

集成方案：独立应用、协作应用

与 Teams 集成时，应用的 API 和数据结构必须支持应用。 若要扩展支持，必须使用有关 Teams 的上下文信息来增强 API 和数据结构，用于标识映射、深层链接支持以及整合 Microsoft Graph。

了解如何获取 Teams 选项卡或机器人的上下文。

了解身份验证选项

集成方案：独立应用、协作应用、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 中。

另请参阅