Teams 集成注意事项
可以通过将Microsoft Teams 的社交和协作功能与 Teams 正确集成，使 Web 应用适合这些应用。
可与 Teams 集成的不同类型的应用如下所示：
- 独立应用：独立应用是单页或大型复杂应用。 用户可以在 Teams 中使用它的某些方面。
- 协作应用：为 Teams 固有的社交和协作功能构建的现成应用。
- Microsoft SharePoint：要在 Teams 中呈现的 SharePoint 页面。
可以映射并遵循适用于集成方案的相应准则。 本文档概述了 Teams 功能、文件和数据存储的 SharePoint 要求、API 要求、身份验证以及应用与 Teams 的深层链接。
了解 Teams 平台功能
重要
Microsoft 365 连接器 (以前称为 Office 365 连接器) 即将弃用，并且即将阻止创建新的 Microsoft 365 连接器。 有关计划以及工作流应用如何提供更灵活、更安全的体验的详细信息，请参阅 停用 Microsoft Teams 中的 Microsoft 365 连接器。
如何在 Teams 中创建 Webhook？
若要在收到 Webhook 请求时自动发布到聊天或频道，请使用预定义的工作流模板，或使用 收到 Teams Webhook 请求时 触发器从头开始创建工作流。 有关详细信息，请参阅 在 Microsoft Teams 中收到 Webhook 请求时发布工作流。
有关 收到 Teams Webhook 请求时 触发器的详细信息，请参阅 Microsoft Teams - Webhook。
如果已生成Office 365连接器：
创建 Power Automate 连接器：Power Automate 增强了 Teams 中广泛使用的工作流应用。 它是以编程方式将数据传入和传出 Teams 的可缩放且安全的方法。 如果采用此方法，则可以创建工作流模板，用于将产品中的警报发布到 Teams 频道。 此方法简化了用户采用新方法。 有关详细信息，请参阅 面向企业开发人员、ISV 和合作伙伴的 Power Automate。
更新 Teams 应用：可以增强当前 Teams 应用。 例如，可以让用户基于系统中的触发器事件设置主动消息。 有关详细信息，请参阅 机器人如何通过主动消息发布到通道。
已知问题
- 工作流应用不能作为流机器人在专用频道中发布。 但是，它可以代表用户发布。
- 工作流仅支持自适应卡片。 它不支持Office 365连接器使用的较旧消息卡格式。 工作流不支持使用消息卡格式。 有关详细信息，请参阅如何将连接器消息卡格式转换为自适应卡片。
- 工作流不提供 DataDog 和 Jenkins 等第三方连接器。
- 只能在默认环境中创建工作流。
限制
工作流仅链接到特定用户 (称为工作流) 所有者，而不是 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) 和由世纪互联运营的 Teams。 GCC 默认关闭第三方应用。 若要为 GCC 启用第三方应用，请参阅管理应用权限策略和管理应用。
对于 SharePoint 页面，只能使用 SSO，并且不能添加其他Microsoft Entra ID如果希望 SSO 适用于其他应用，因为 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 中。