Microsoft Teams 是团队沟通与协作平台，与 ONES 的对接走 COM 自定义应用包路线：应用包由 ONES 侧获取，Teams 管理员按租户策略上传并允许使用。本文按产品版本、应用包、租户策略三条线给出接入前核对清单。需要说明的是，目前可依据的 ONES 集成手册面向 ONES.com，国内版（ONES.cn）支持范围与具体 Teams 环境要求尚待核验，清单中的相关项按“待书面确认”处理。
要点总览（TL;DR）
- 接入前按三条线核对：产品版本与适用范围、应用包来源与内容、Teams 租户管理策略，三条线全部有书面证据才可放行。
- 已读的 Teams 集成手册面向 ONES.com；国内版（ONES.cn）支持范围与具体 Teams 环境要求属于待核验缺口，需取得 ONES 侧书面答复。
- 应用包由 ONES 获取，Teams 管理员按租户策略上传并允许使用；不能假定所有租户都能自行上传。
- Teams 管理员可限制应用上传及用户对自定义应用的使用，核对时把“能不能传”和“谁能用”分开确认。
- 阻断项包括国内版支持范围未书面确认、应用包来源或版本不明、租户策略禁止上传或使用、测试账户权限不足。
谁在什么时点使用这份核对清单
这份清单服务于一次具体的接入决策：在 Teams 里启用 ONES 应用之前，判断现有证据是否足以放行。它由三方共同执行，各自承担不同动作，缺一方签字都不算完成。
| 角色 | 主要动作 | 对应时点 |
|---|---|---|
| ONES 侧集成负责人 | 提供集成手册、应用包及包对应的环境说明，书面回复国内版支持范围 | 应用包获取前 |
| Teams 租户管理员 | 确认租户自定义应用策略状态，执行上传并授权目标用户群 | 上传前、正式启用前 |
| 企业 IT／安全审批人 | 按内部应用准入流程审核来源、权限与数据流向，给出准入结论 | 上传前 |
三个节点对应三类前置输入：应用包获取前需要 ONES 集成手册（注意其范围为 ONES.com）与国内版支持范围的书面答复；上传前需要 Teams 租户管理员权限与内部准入结论；正式启用前需要可用的测试账户及对应业务权限。建议在项目启动会上就把这三个节点写进计划，指定每项检查的负责人，避免上传时才发现策略或审批未就绪。
第一阶段：产品版本与适用范围核对
版本核对的目标是把“依据哪份手册、覆盖哪个产品、对应哪个 Teams 环境”三件事固定下来。当前可确认的是，已读的 Teams 集成手册面向 ONES.com；国内版是否适用、支持哪些 Teams 环境，属于资料核验缺口，需要另行取得书面确认后才能作为放行依据。
| 检查项 | 通过标准 | 证据 | 负责人 |
|---|---|---|---|
| 集成手册的产品范围 | 明确记录手册面向 ONES.com，并在项目文档中标注 | 手册页面记录、核验日期 | ONES 侧集成负责人 |
| 国内版（ONES.cn）支持范围 | 取得 ONES 侧书面答复，说明国内版是否支持、支持到什么程度 | 邮件或工单回复 | ONES 侧集成负责人 |
| Teams 侧环境与版本要求 | 取得应用包对应的 Teams 环境说明；资料未给出具体版本号，需向供应方索取 | 供应方书面说明 | ONES 侧集成负责人 + Teams 管理员 |
| 核验记录 | 每项记录核验日期、信息来源与结论 | 核对表存档 | 项目负责人 |
这一阶段最容易出现的偏差，是把 ONES.com 手册直接当作国内版可用的证明。手册证明的是 COM 范围内的能力与步骤，国内版支持范围在取得书面答复前应保持“未核实”状态，不能因为手册里写了上传与通知交互，就推断国内版同样具备。
第二阶段：应用包获取与内容核对
应用包由 ONES 获取，Teams 侧不自行生成。核对的重点是“拿到的包是不是对的那个包”，包括来源、标识、版本与匹配关系四项。
| 检查项 | 通过标准 | 证据 | 负责人 |
|---|---|---|---|
| 获取渠道 | 包由 ONES 侧提供，记录提供人、提供时间与传递方式 | 获取凭证、邮件记录 | ONES 侧集成负责人 |
| 包标识与发布方 | 包内标识、发布方信息与 ONES 书面说明一致 | 包信息截图或清单 | Teams 管理员 |
| 版本号 | 记录包版本号，并与 ONES 侧确认该版本对应的适用范围 | 版本说明、确认记录 | ONES 侧集成负责人 |
| 环境匹配 | 包与当前 ONES 环境、Teams 环境的匹配关系有书面说明 | 匹配说明文档 | 双方共同确认 |
| 文件留存 | 包文件与获取凭证归档，后续升级可追溯 | 归档记录 | 项目负责人 |
资料未给出具体版本号，也没有列出包内清单，因此这两项只能以“向 ONES 索取并书面确认”作为通过标准，不能凭经验填写。若包在传递过程中被改名或重新打包，应要求 ONES 侧重新提供原始文件，避免上传后出现标识不一致的问题。
第三阶段：Teams 租户管理策略核对
Teams 管理员可以限制应用上传，也可以限制用户对自定义应用的使用。这意味着即使应用包本身没有问题，租户策略仍可能在上传或使用环节拦截。核对时要分别确认“能不能传”和“谁能用”。
| 策略项 | 当前状态 | 通过标准 | 负责人 |
|---|---|---|---|
| 自定义应用上传 | 待查 | 租户策略允许管理员上传自定义应用 | Teams 管理员 |
| 自定义应用使用范围 | 待查 | 目标用户群被允许使用该自定义应用 | Teams 管理员 |
| 上传执行方式 | 待查 | 由管理员按租户策略执行上传，不假定所有租户都能自行上传 | Teams 管理员 |
| 策略变更记录 | 待查 | 如为本次接入调整策略，记录调整内容、审批人与生效时间 | Teams 管理员 + IT 审批人 |
如果租户策略当前禁止上传，需要走内部变更流程申请放开，并明确放开的时间窗口与范围；如果策略允许上传但限制了可用用户群，则要在上传后把目标用户加入允许列表，否则用户会看到应用却无法使用。这两件事分别对应不同的策略项，核对时不要合并成一项。
第四阶段：启用后通知交互与权限核对
手册介绍了登录、通知以及通知中关注和评论等交互，这些交互受连接账户和业务权限限制。上线前应在一个具备真实业务权限的测试账户上走一遍，确认通知能到达、能在通知中完成关注和评论动作。
| 验证项 | 通过标准 | 证据 | 负责人 |
|---|---|---|---|
| 账户连接 | 测试账户可完成登录并与 ONES 账户建立连接 | 验证截图或记录 | Teams 管理员 |
| 通知到达 | ONES 侧产生的通知能在 Teams 中收到 | 验证记录 | 业务测试人 |
| 通知内交互 | 可在通知中执行关注、评论等动作，结果在 ONES 侧可见 | 验证记录 | 业务测试人 |
| 权限边界 | 测试账户具备对应业务权限；权限不足时的表现已记录 | 权限清单、异常记录 | 业务测试人 + ONES 侧 |
验证结果要逐项记录，未通过的项写明现象、发生时间和复现步骤，交 ONES 侧确认是配置问题还是权限问题。测试账户应尽量贴近真实使用者的权限组合，只用管理员账户测试容易掩盖普通成员权限不足的情况。
阻断项与完成条件
以下任一情况出现，即视为阻断项，不能进入正式启用：国内版支持范围未取得书面确认；应用包来源不明或版本无法对应；租户策略禁止上传或禁止目标用户使用；测试账户权限不足导致核心交互无法完成。
| 阻断项 | 判定依据 | 处置方式 | 复核时点 |
|---|---|---|---|
| 国内版支持范围未书面确认 | 无 ONES 侧书面答复 | 向 ONES 发起范围确认，取得答复后再评估 | 答复到达后 |
| 应用包来源或版本不明 | 无获取凭证或版本说明 | 要求 ONES 重新提供原始包与版本说明 | 新包到位后 |
| 租户策略禁止上传或使用 | 策略状态为禁止且未完成变更 | 走内部变更流程，明确放开范围与时间 | 策略生效后 |
| 账户权限不足 | 核心交互无法完成且非配置问题 | 补齐权限或调整测试账户后重测 | 权限调整后 |
整体放行的条件是：四个阶段的检查项全部有证据支撑，且阻断项清单为空。对于暂未通过但不构成阻断的项，记录责任人与计划完成时间，在正式启用前完成复核。核对表建议随项目归档，后续升级应用包或调整租户策略时，按同样三条线重新核对一遍。
常见问题
如果团队使用的是 ONES.cn，这份清单还能直接照用吗？
清单的核对框架可以沿用，但结论不能直接套用。已读的 Teams 集成手册面向 ONES.com，国内版支持范围尚未核实，应用包与支持的 Teams 环境也属于资料核验缺口。国内团队在放行前应先取得 ONES 侧关于国内版支持范围的书面答复，再按答复内容调整版本与应用包两项的通过标准。
租户策略允许上传，是否就等于用户能正常使用？
两者是分开的策略项。Teams 管理员既可以限制应用上传，也可以限制用户对自定义应用的使用。上传成功后，还要确认目标用户群被允许使用该自定义应用，否则用户可能看到应用却无法使用。核对表里应把上传策略与使用范围分别记录状态和负责人。
应用包能否由 Teams 管理员自行打包生成？
按现有手册，应用包由 ONES 获取，Teams 管理员按租户策略上传并允许使用。管理员负责的是上传与授权环节，包本身应从 ONES 侧取得，并记录提供人、时间与传递方式，便于后续升级追溯。
通知能收到，但点开通知后无法关注或评论，通常先查什么？
先查账户与权限。手册介绍的登录、通知以及通知中关注和评论等交互，受连接账户和业务权限限制。建议确认测试账户已完成登录并与 ONES 账户建立连接，同时具备对应业务权限；若权限不足，记录具体表现后交 ONES 侧确认属于配置问题还是权限问题。
核对完成后，后续升级应用包还要重新走一遍吗？
建议重新核对。应用包版本变化或租户策略调整后，原先的证据可能不再对应新的包或新的策略状态。可以按同样三条线复查：版本与适用范围是否有新的书面说明、新包的来源与版本是否可追溯、租户策略与目标用户范围是否仍然成立，核对表随项目归档以便比对。
官方参考资料
- Teams & ONES.com（ONES）
- Manage custom apps in Microsoft Teams（Microsoft）
