Teams 应用商店验证准则
遵循这些准则会增加应用通过Microsoft Teams 应用商店提交过程的机会。 这些特定于 Teams 的准则是对 Microsoft 商业市场认证策略 的补充,并经常更新以反映新功能、用户反馈和业务规则更改。
注意
- 某些准则可能不适用于你的应用。 例如,如果应用不包含机器人,则可以忽略与机器人相关的准则。
- 我们已将这些准则交叉引用到 Microsoft 商业认证策略,并添加了注意事项,其中包含验证过程中遇到的通过或失败情况的示例。
- 某些准则标记为 “必须修复”。 如果你的应用提交不符合这些强制性准则,你将收到来自我们的失败报告,其中包含缓解措施。 你的应用提交仅在修复问题后通过 Teams 应用商店验证。
- 其他准则标记为 “可修复”。 为了获得理想的用户体验,我们建议修复这些问题,但是,如果你选择不修复这些问题,则不会阻止应用提交在 Teams 应用商店上发布。
价值主张
本部分符合 Microsoft商业认证策略 1140.1 ,并为Microsoft Teams 应用的开发人员提供更多关于其产品/服务价值主张的指导。
应用必须让用户完成鼓励重复使用的功能工作流,从而为用户提供价值。 展开以下部分,详细了解价值主张:
制表符
选项卡必须提供价值,而不仅仅是托管现有网站。 [必须修复]
通知机器人
在以下的情况下,通知在 Teams 中提供值:- 已发布的卡片或文本提供了足够的详细信息,无需进一步的用户操作。
- 已发布的卡片或文本提供足够的预览信息,供用户执行操作或决定在 Teams 外部打开的链接中查看更多详细信息。
仅提供包含内容(例如, “你拥有新通知 或 单击查看”)的通知,并且要求用户在 Teams 外部导航其他所有内容的应用不会在 Teams 中提供重要的价值。
消息扩展
[必须修复]
由基于搜索的消息扩展组成的应用通过共享允许上下文对话而无需上下文切换的卡片为用户提供价值。
若要通过仅基于搜索的消息扩展应用的验证,需要将以下内容作为基线,以确保用户体验不会中断。 如果满足以下情况,通过消息扩展共享的卡片将在 Teams 中提供价值:
已发布卡片提供了足够详细的信息,无需用户进一步操作。
已发布卡片为用户提供了足够的预览信息,以便进行操作或决定在 Teams 外部打开的链接中进一步查看详细信息。
链接展开
链接仅展开应用不会在 Teams 中提供重大价值。 如果应用仅支持链接展开且没有其他功能,请考虑在应用中构建更多工作流。
应用名称
[必须修复]
本部分符合Microsoft 商业认证策略编号 1140.1.1 ,并为开发人员提供了有关命名其应用的更多指导。
展开以了解详细信息
应用名称在用户在 Teams 应用商店中发现它的方式中起着关键作用。 使用以下准则命名应用:
该名称必须包括与用户相关的术语。 [必须修复]
使用开发人员姓名作为常用名词的前缀或后缀。 例如,Contoso Tasks 而不是 Tasks。 [必须修复]
不得使用 Teams 或其他Microsoft产品名称,例如 Excel、PowerPoint、Word、OneDrive、SharePoint、OneNote、Azure、Surface 和 Xbox,这些名称可能错误地指示联合品牌或联合销售。 有关引用 Microsoft 软件产品和服务的详细信息,请参阅 Microsoft 商标和品牌准则。 [必须修复]
不得复制 Teams 应用商店或商业市场中其他产品/服务中列出的应用的名称。 [必须修复]
不得包含亵渎或贬损性的词汇。 该名称也不得包含对种族或文化不敏感的语言。 [必须修复]
必须是唯一的。 如果你的应用 (Contoso) 在 Teams 应用商店中列出,Microsoft AppSource,并且你想要列出特定于某个地理位置的另一个应用(如 Contoso 墨西哥),则提交必须满足以下条件:
- 在标题、元数据、首次响应应用体验和帮助部分中,强调应用的特定区域功能。 例如,标题必须是 Contoso Mexico。 应用标题必须与出自同一开发人员的现有应用明确区分,以避免最终用户混淆。 [必须修复]
- 在合作伙伴中心上传应用包时,请在“可用性”部分选择应用可用的正确市场。 [必须修复]
应用名称不得与核心 Teams 功能(如聊天、联系人、日历、通话、文件、活动、Teams 和帮助)一起领先。 应用名称不会缩短为左侧导航栏中的“聊天”、“联系人”、“日历”、“通话”、“文件”、“活动”、“Teams”和“安装帮助”。 [必须修复]
如果你的应用是与 Microsoft 的官方合作关系的一部分,则应用的名称必须首先出现。 例如, 适用于 Microsoft Teams 的 Contoso 连接器。
应用名称不得引用Microsoft或Microsoft产品。 除非应用与 Microsoft 正式合作,否则不要在应用名称中使用 Teams 或Microsoft。 在这种情况下,应用名称必须首先引用Microsoft。 例如, 适用于 Microsoft Teams 的 Contoso 连接器。 [必须修复]
命名时不要使用括号来包含Microsoft产品。 [必须修复]
开发人员名称在应用清单 (之前称为 Teams 应用清单) 和 AppSource 中必须相同。 [必须修复]
提交的应用清单必须是生产清单。 因此,应用名称不得指示该应用是预生产应用。 例如,应用名称不得包含 Beta、Dev、Preview 和 UAT 等字词。 [必须修复]
应用清单中的应用名称与 AppSource 必须匹配。 [必须修复]
提示
你的应用在 Teams 应用商店和 AppSource 上的品牌,包括你的应用名称、开发人员名称、应用图标、AppSource 屏幕截图、视频、简短说明和网站(单独或一起)不得模拟官方Microsoft产品/服务,除非你的应用是官方Microsoft 1P 产品/服务。
重复应用
提供相同功能的同一开发人员的应用必须共享应用列表,除非隐私合规性要求要求需要单独的应用列表或单独的应用列表来支持政府云。 必须构建到业务逻辑中,并且只发布一个列表。 [必须修复]
- 若要满足多个区域支持要求,必须在业务逻辑中构建并仅发布一个列表。
- 若要满足本地部署和云部署的多个终结点要求,必须构建到业务逻辑中,并仅发布一个列表。
适用于工作区使用
[必须修复]
本部分符合Microsoft商业认证策略 编号 1140.1.2、 100.8 和 100.10 ,并为开发人员提供有关构建工作场所适当应用的其他指导。
展开以了解详细信息
应用内容必须适用于一般工作场所使用,并遵循商业市场认证策略中列出的所有限制。 禁止与宗教、政治、赌博和长时间娱乐相关的内容。 [必须修复]
你的应用必须增进团队协作、提高个人工作效率,或同时满足两者。 用于团队联系和社交的应用必须是协作的,并且专为多个参与者设计。 应用不需要每次会话超过 60 分钟的大量时间投资,也不会影响工作效率。 [必须修复]
内容聚合器应用必须具有一种机制,使用户能够向应用发布者报告问题或不适当的内容。 [必须修复]
类似的平台和服务
[必须修复]
本部分符合 Microsoft商业认证政策编号 1140.1.3。
应用必须专注于 Teams 体验,并且应用内容或应用元数据中不应包括其他类似的基于聊天的协作平台或服务的名称、图标或图像,除非应用提供特定的互操作性。
功能名称
按钮和其他 UI 文本中的应用功能名称不得使用为 Teams 和其他Microsoft产品保留的术语。 例如,“开始会议”、“发起呼叫”或“开始聊天”是 Microsoft Teams 中Microsoft使用的功能名称。 如有必要,请包括应用名称以明确区分,例如 “开始 Contoso 会议”。
身份验证
[必须修复]
本部分符合 Microsoft商业认证策略 1140.1.4 ,并为开发人员提供有关使用外部服务对其应用进行身份验证的指导。
若要详细了解如何实施应用身份验证,请参阅 Teams 中的身份验证。
展开以了解详细信息
与外部服务进行身份验证
如果你的应用使用外部服务对用户进行身份验证,请遵循以下准则:
登录、注销和注册体验:
- 依赖于外部帐户或服务的应用必须提供清晰且简单的登录、注销和注册体验。 [必须修复]
- 当用户注销时,他们必须仅从应用中注销并保持登录到 Teams。 [必须修复]
- 依赖外部帐户或服务的应用必须为新用户提供一种前进的方法,以便注册或联系应用发布者,以了解有关服务以及获取服务访问权限的方法。 应用清单、AppSource 长说明和应用首次运行体验 (机器人欢迎消息、选项卡设置或配置页) 中必须提供前进方向。 [必须修复]
- 需要租户管理员完成一次性设置的应用必须调用租户管理员的依赖项来配置应用 (,然后任何其他租户用户才能安装和使用应用) 。 必须在应用的清单、AppSource 长说明、所有首次运行体验接触点 (机器人欢迎消息、选项卡设置或配置页面) 、帮助文本(在机器人响应、撰写扩展或静态选项卡内容时认为有必要)中调出依赖项。 [必须修复]
内容共享体验: 需要通过外部服务进行身份验证以便在 Teams 频道中共享内容的应用,必须在帮助文档 (或类似资源) 中清楚地说明用户如何断开连接或取消共享内容 (如果外部服务支持此功能)。 这并不意味着你的 Teams 应用中必须有取消共享内容功能。
音频
如果应用的主要目的是听音乐,它必须支持至少一个协作范围,并具有特定于应用的端到端工作流。 例如,共享播放列表、配置或固定播放列表以及同步收听音乐。 [必须修复]
建议发布的主要意图是让用户在 Teams 中听音乐的应用包含协作共同收听体验。 [修复良方]
安全性
本部分符合 Microsoft商业认证政策编号 1140.3。
财务信息
[必须修复]
本部分符合 Microsoft商业认证策略 1140.3.1, 并提供有关在 Teams 界面中传输财务信息的指导,并通知开发人员移动版 (Android 和 iOS) Teams 应用的受限支付方案。
展开以了解详细信息
应用不得要求用户在 Teams 界面中付款并通过机器人界面向用户传输财务信息。 [必须修复]
只有在用户同意使用应用之前,在使用条款、隐私策略、配置文件页面或网站中披露外部付款服务,你才能提供安全外部付款服务的链接。 [必须修复]
请勿通过应用为 常规策略编号 100.10 不适当的内容禁止的商品或服务提供付款。 [必须修复]
在 iOS 或 Android 版本的 Teams 上运行的应用必须遵循以下准则:
应用不得包括应用内购买、试用产品/服务或 UI,旨在将用户追加销售到付费版本或在线商店以购买其他内容、应用或加载项。[必须修复]
如果应用需要帐户,则用户必须能够免费注册帐户。 禁止使用 免费 或 免费帐户 的术语。 [必须修复]
你可以决定帐户是无限期处于活动状态还是仅在有限时间内处于活动状态。 当帐户过期时,应用不得显示 UI、文本或指示需要付款的链接。 [必须修复]
应用的隐私策略和使用条款页面必须不含任何与商业相关的 UI 或链接。 [必须修复]
机器人
[必须修复]
本部分符合 Microsoft商业市场策略 1140.3.2。
展开以了解详细信息
对于使用 Microsoft Azure 机器人服务的应用(如机器人和消息扩展),必须遵循 Microsoft 在线服务条款中定义的所有要求。
机器人必须始终请求上传文件的权限并显示确认消息。
外部域
[必须修复]
本部分符合 Microsoft商业市场策略编号 1140.3.3 ,并提供有关在应用清单属性中使用受限域的 validDomains
开发人员指南。
展开以了解详细信息
不要包含组织控制范围之外的域 (在应用的域配置中包括通配符) 和隧道服务。 以下的例外情况包括:
如果应用依赖于 SharePoint,则可以使用
{teamSiteDomain}
上下文属性将关联的根 SharePoint 站点作为有效域包含。 [必须修复]不要将顶级域(如 .com、 .in 和 .org )用作有效域。 [必须修复]
请勿使用 .onmicrosoft.com 或 作为 onmicrosoft 不受你控制的有效域。 但是,可以将 yoursite.com 用作有效域,即使域包含通配符,您的 站点 也受您的控制。 [必须修复]
如果你的应用是基于 Microsoft Power Platform 构建的 PowerApp,则必须将 apps.powerapps.com 作为有效的域包括在内,以使你的应用能够在 Teams 中访问并正常运行。
为提交声明的外部域不得包含 URL。 例如,www 或 https。 [必须修复]
如果应用使用 Azure 机器人服务的 OAuthCard,则必须将 token.botframework.com 作为有效域包括在内,否则“登录”按钮将不起作用。 不得将 .botframework.com 声明为不允许使用此域名使用通配符。 [必须修复]
OpenAPI URL 必须受合作伙伴控制。
不允许以下外部域:[必须修复]
- *.azurewebsites.net
- *.azureedge.com
- *.microsoft.com
- *.microsoftonline.com
- *.onmicrosoft.com
- go.microsoft.com
- teams.microsoft.com
使用通配符 (*
) 时,以下规则适用:
- 如果子域段包含通配符,则它必须是段中的唯一字符。
- 通配符段之前的任何段也必须是通配符段。
例如, *..domain.com 有效,但 foo.*.myteam.domain.com 无效。
敏感内容
[必须修复]
你的应用不得向不打算查看内容的受众发布敏感数据,例如信用卡、财务付款详细信息、运行状况、联系人跟踪或其他个人身份信息, (PII) 。
应用必须在将任何文件或可执行文件 (.exe) 下载到用户计算机或环境中之前警告用户。
常规功能和性能
本部分符合 Microsoft商业市场策略编号 1140.4。
- 管理员和现有用户必须提供前进指南。 你可以添加前进指南作为超链接,用于注册、入门、联系我们、帮助链接或电子邮件。
- 不需要在应用功能下调用帐户依赖项或限制,但必须在应用清单长说明和 AppSource 应用列表中添加帐户依赖项或限制。
- 对于新用户,必须调用租户管理员的任何依赖项。 如果没有依赖项,必须提供注册、联系我们、入门链接或电子邮件。
正在启动外部功能
[必须修复]
对于核心用户方案,应用不得将用户从 Teams 中取出。 应用内容和交互必须在 Teams 功能中发生,例如机器人、自适应卡片、选项卡和对话框 (TeamsJS v1.x) 中称为任务模块。
注意
若要通过具有协议(例如 、 或 )tel:
的深层链接将用户从 Teams 应用重定向到其本机体验,mailto:
请通过调用 window.open
方法或使用定位点标记来target="_blank"
启动新窗口中的深层webex:
链接。
展开以了解详细信息
应在 Teams 应用内链接用户,而不是链接到外部网站或应用。 对于需要外部功能的情况,你的应用必须获得明确的用户权限才能启动该功能。 [必须修复]
启动外部功能的按钮 UI 文本必须包含指示用户已退出 Teams 实例的内容。 例如,包括如下文本,由此转到 Contoso.com 或 在 Contoso.com 中查看。 [必须修复]
添加 弹出 图标,让用户知道他们正在 Teams 外部导航。 可以使用链接右侧的弹出图标 。 [必须修复]
如果无法添加 弹出 图标,可以实现以下任一选项,让用户知道他们正在 Teams 外部导航:[必须修复]
- 在自适应卡片中添加一条注释,指出当用户选择 “使用此应用获取帮助”时,它会将用户带到 Teams 之外。
- 添加间隙对话框。
兼容性
[必须修复]
应用必须能够在以下操作系统和浏览器的最新版本上正常运行:
- Microsoft Windows
- macOS
- Microsoft Edge
- Google Chrome
- iOS
- Android
你的应用必须在不受支持的浏览器和操作系统上显示得体的失败消息。
答复时间
[必须修复]
Teams 应用必须在合理的时间范围内做出响应,或者显示加载或键入指示器、消息或警告。
- 选项卡必须在两秒钟内响应,或显示正在加载的消息或警告。 [必须修复]
- 机器人必须在两秒内响应用户命令或显示键入指示器。 [必须修复]
- 消息扩展必须在两秒钟内响应用户命令。 [必须修复]
- 通知必须在用户操作后两秒钟内显示。 [必须修复]
由人工智能提供支持的应用
浏览旨在帮助你在创新的每个阶段(例如Microsoft RAI 工具包 和 HAX 工具包项目)中负责的人工智能 (AI) 实践的资源。
本部分符合 Microsoft具有 AI 生成内容的应用的商业市场策略 ,以及 使用面部识别功能的应用Microsoft商业市场策略。
具有 AI 生成内容的应用
应用不得生成、包含或提供与 100.10 中所述的现有商业市场策略一致的不适当、有害或冒犯性 AI 生成的内容的访问权限。 [必须修复]
- 请考虑使用以下任一项:
- 使用 Teams AI 库,以 Teams 为中心的界面连接到基于 GPT 的公共语言模型和用户意向引擎。 [修复良方]
- 使用审核挂钩,可用于通过审查 API 来调节机器人响应。 [修复良方]
- 添加对话扫描功能,这有助于监视对话并在对话误入歧途时进行干预。 [修复良方]
- 请考虑使用以下任一项:
应用必须提供机制,让应用用户通过以下任何机制向开发人员报告不当、有害或冒犯性内容: [必须修复]
- 应用说明,包括邮件 ID 或指向门户的链接,以记录问题。
- 在应用机制中,用于记录问题以及对不当内容的特定引用。
必须及时对报告的问题采取措施。 [必须修复]
在客户获取符合策略 100.1.3 的产品/服务之前,应用必须清楚地描述 AI 功能,并提示用户查看作为应用内功能的一部分的信息。 [必须修复]。
使用面部识别功能的应用
注意
此类别中的应用可能会因遵守Microsoft负责任的 AI 原则而接受进一步审查。
- 应用不得允许使用面部识别功能来识别美国警察局使用或用于的人员。 [必须修复]
- 对于使用面部识别或情感推理技术的应用,必须在应用说明中提供其中每个功能的醒目标记或指示。 [必须修复]
- 使用面部表情或面部运动推断情感状态(如愤怒、厌恶、幸福、悲伤、惊讶、恐惧或其他通常用于描述某人情绪状态的术语)的应用可能会根据评论进行限制。
- 允许使用面部表情和动作来检测和分类单个面部元素,例如微笑或抬起的眉毛。 关键区别在于检测作为视觉信号的面部表情或动作与情感状态的推理。
应用包和 Teams 应用商店一览
[必须修复]
必须正确设置应用包的格式,并包含所有必需的信息和组件。
提示
必须确保提供的测试帐户或测试环境永久有效,即直到应用在商业市场上上线为止。
必须包含以下详细的测试说明来验证应用提交:
- 在应用依赖于外部帐户进行身份验证的情况下,配置应用测试帐户的步骤。
- Teams 内核心工作流的预期应用行为摘要。
- 在应用长说明和相关材料中明确描述功能、特性和可交付结果的限制、条件或例外。
- 在验证应用提交时,为测试人员强调注意事项。
- 使用虚拟数据预填充测试帐户 ,以帮助测试。
- 如果要提供测试帐户,请确保启用第三方集成。
应用部件清单
[必须修复]
应用清单定义应用的配置。
- 应用清单必须符合公开发布的应用清单架构。 有关详细信息,请参阅 应用清单参考。 不要使用应用清单的预览版本提交应用。
- 如果应用包括机器人或消息扩展,则应用清单中的详细信息必须与机器人框架元数据保持一致,包括机器人名称、徽标、隐私策略链接和服务条款链接。
- 如果应用使用 Microsoft Entra ID 进行身份验证,请在应用清单中包含 Microsoft Entra 应用程序 (客户端) ID。 有关详细信息,请参阅 应用清单参考。
使用最新的应用清单架构
如果应用使用单一登录 (SSO) ,则必须在应用清单中声明Microsoft Entra ID进行用户身份验证。 [必须修复]
必须使用公开发布的应用清单架构。 可以更新应用包,以使用公共版本的应用清单架构 1.10 或更高版本。 [必须修复]
提交应用更新时,仅增加应用版本号。 更新的应用的应用 ID 必须与已发布应用的应用 ID 匹配。 [必须修复]
应用包中存在其他文件是不可接受的。 [必须修复]
版本号在应用清单文件架构和其他语言应用清单架构中必须相同。 [必须修复]
必须使用应用清单架构版本 1.5 或更高版本来本地化应用。 若要在 manifest.json 文件中使用应用架构版本 1.5 或更高版本,请将 属性
$schema
更新为 1.5 或更高版本。 在本例中,将manifestVersion
属性更新到$schema
版本 (1.5) 。 [必须修复]添加、更新或删除现有功能、添加或删除应用清单或合作伙伴中心元数据时,必须增加应用版本号,并在合作伙伴中心帐户中提交新的应用清单以供验证。 [必须修复]
版本字符串必须遵循语义版本控制规范 (SemVer) 标准 (MAJOR。次要。PATCH) 。 [必须修复]
如果应用要求管理员在 Teams 管理中心中查看权限并授予许可,则必须在应用清单中声明
webapplicationinfo
。 如果未webapplicationinfo
在应用清单中声明 ,则 Teams 管理中心中应用的 “权限 ”页显示为 ... [必须修复]作为 Teams 应用认证的一部分,必须提交应用清单的生产版本。 [必须修复]
建议在应用清单中声明Microsoft云合作伙伴计划 ID (CCP ID) (以前称为 Microsoft 合作伙伴网络 (MPN ID) )。 CCP ID 有助于标识生成应用的合作伙伴组织。 [修复良方]
应用清单中声明的范围和/或上下文必须在应用中可见。 [必须修复]
应用图标
[必须修复]
图标是用户浏览 Teams 应用商店时看到的main元素之一。
展开以了解详细信息
图标必须传达应用的品牌和用途,同时遵循以下要求:
应用一览中提交的应用的颜色和轮廓图标必须匹配。 [必须修复]
应用包必须包含两个 PNG 版本的应用图标:彩色图标和大纲图标。 [必须修复]
合作伙伴中心帐户中作为应用市场列表的一部分上传的市场图标必须与应用包中提供的颜色图标相匹配。 [必须修复]
图标的颜色版本必须为 192x192 像素。 图标符号可以是任何颜色,但必须位于纯色或完全透明的方形背景上。 [必须修复]
以下情况中将显示图标的轮廓版本:
- 你的应用正在使用并托管在 Teams 左侧应用栏上。
- 当用户固定应用的消息扩展时。
轮廓版本必须为 32x32 像素,并且可以是白色(背景透明)或透明(白色背景)。 图标周围不得有任何额外的填充。 [必须修复]
你的应用包必须包含大小正确且格式正确的图标。 这些图标必须与 Teams 应用商店一览元数据中的信息匹配。 [必须修复]
有关详细信息,请参阅 图标准则。
应用说明
必须为应用提供简短和较长的说明。 应用说明有助于提高 Teams 应用商店中的应用可发现性。 应用配置和合作伙伴中心中的说明必须相同。
展开以了解详细信息
描述不得直接或通过建议贬低其他品牌 (Microsoft拥有或其他) 。 确保说明不包含无法证实的声明。 例如,保证效率提高 200%。
应用说明不得包含比较营销信息。 例如,请勿在产品/服务一览中使用竞争对手徽标或商标,包括引用竞争产品/服务或市场的标记或其他元数据。 [必须修复]
在应用说明中超链接联系人详细信息、入门、帮助或注册。 [修复良方]
应用说明必须识别目标受众,简要且清楚地说明其独特和独特的价值,确定受支持的Microsoft产品和其他软件,并包括其使用的任何先决条件或要求。 在客户获得产品/服务之前,必须清楚地描述产品/服务清单和相关材料中所述的功能、特性和可交付结果的任何限制、条件或例外。 声明的功能必须与产品/服务的核心函数和说明相关。 [必须修复]
如果更新应用名称,请将旧应用名称替换为应用清单、AppSource 中产品/服务元数据中的新应用名称,并尽可能适用。 [必须修复]
必须在清单“应用说明”、“AppSource”和“合作伙伴中心”中指出限制和帐户依赖项。 例如:
- 企业帐户
- 付费订阅
- 另一个许可证或帐户
- 语言
- 公用电话交换网 (PSTN) 拨号
- 区域依赖项
- 预订翻译员或实时代理的提前期
- 基于角色的功能
- 本机应用的依赖项
如果特定区域或地理位置支持你的应用,则必须在应用清单、合作伙伴中心和该套餐的 AppSource 中的应用说明中标注该特定区域依赖项。
如果需要引用 Teams,请将应用列表中的第一个引用编写为 Microsoft Teams。 以后的引用可以缩短为 Teams。 [必须修复]
简短说明
简短说明必须是应用的简明摘要,突出其价值主张,并面向目标受众。
应做:
- 将简短说明保留为一句话。
- 首先放置最重要的信息。
- 包括客户可能搜索的关键字。
- 有效使用可用字符限制。 例如,不要重复应用名称。
不应做:
[修复良方]
在简短说明中使用 应用 一词。
较长说明
长说明必须提供引人入胜的叙述,突出应用的价值主张、主要受众和目标行业。 虽然说明可以长达 4,000 个字符,但我们建议你提供大约 1000 个字符的简明说明。
应做:
使用 Markdown 设置说明的格式。
使用主动语音并直接与用户交谈。 例如,可以...。
列出主要优势,以突出显示使用应用的优势。 最多添加三个权益。
在 Teams 中添加应用的关键价值主张。
列出带项目符号点的功能,以便更轻松地扫描说明。
在用户安装应用之前,请在列表和相关材料中清楚地描述功能以及可交付结果的限制、特性、条件或例外情况。 这些 Teams 功能必须与列表中描述的核心功能相关。
确保应用说明与 Teams 应用中可用的功能匹配。 对 Teams 应用外部工作流的任何引用都必须受到限制,并且必须在 Teams 应用功能中明确强调。
包括帮助或支持链接。
请参阅 Microsoft 365,而不是 Office 365。
在描述应用如何与 Teams (或 Microsoft 365) 配合使用时,请使用以下语言:
- “... 可用于 Microsoft Teams。”
- “... 正用于 Microsoft Teams。”
- “... 在 Microsoft Teams 内。”
- “... 适用于 Microsoft Teams。”
- “... 与 Microsoft Teams 集成。”
- “...专为...构建”
- “...专为...开发”
- .. 专为...
不应做:
[必须修复]
超过 500 字。
将 Microsoft 缩写为 MS 或 MSFT。
指示应用是来自 Microsoft 的产品/服务,包括使用 Microsoft 的标语或标志行。
除非你是经认证的 Microsoft 合作伙伴,否则请使用以下语言:
- “ ...通过...认证”
- “...由...提供支持”
包括拼写错误、语法错误。
不必要地将整个应用清单或 AppSource 长说明或应用内容大写。
包括指向 AppSource 的链接。
作出未经验证的声明。 例如,最好、顶级和排名,除非附带声明的来源。
将产品/服务与其他市场产品/服务进行比较。
有关如何创建准确、简洁且信息丰富的简短和长说明的指导,请参阅 用于编写应用说明的清单。
屏幕截图
屏幕截图提供了应用的突出视觉预览,以补充应用名称、图标和说明。
展开以了解详细信息
请记住以下事项:
- 每个列表最多可以有五个屏幕截图。
- 支持的文件类型包括 PNG、JPEG 和 GIF。
- 尺寸必须为 1366x768 像素。
- 最大尺寸为 1,024 KB。
应做:
专注于应用的功能。 例如,用户如何与机器人通信。
包括能准确代表应用程序的内容。
谨慎使用文本。
使用反映品牌和包含营销内容的颜色作为屏幕截图的边框。
使用清晰且包含清晰可读文本的高分辨率屏幕截图。 [必须修复]
至少一个屏幕截图必须描述你的应用在移动设备上的功能。 [必须修复]
每个列表最多可以有五个屏幕截图。 应用列表中必须至少有 3 个和最多 5 个屏幕截图。 [必须修复]
为了最终用户的利益,使用准确描述应用的实际 UI 的模型。 屏幕截图必须准确描述与应用相关的应用的实际 UI 或方案。 [必须修复]
必须描述应用功能或与 Teams 的集成。 [必须修复]
提供的屏幕截图不能错误地将Microsoft Teams 引用为 MS、MSFT 或 MS Teams。 [必须修复]
如果你的 Teams 应用可扩展Microsoft 365 客户端 (Microsoft 365、Outlook 和 Microsoft Teams) ,则提供的屏幕截图必须描述其他 Microsoft 365 客户端中的应用功能。 [必须修复]
必须在屏幕截图中提供标题,以便用户清楚地了解应用功能。 [必须修复]
如果你的应用支持选项卡作为一项功能,那么在应用列表的 Teams 选项卡上下文中展示应用的屏幕截图必须包含 Team 的版式。 [必须修复]
不应做:
包括无法准确反映应用实际 UI 的模型,例如显示你的应用在 Teams 外部使用。
视频
应用一览中的视频是传达人们为何必须使用你的应用的最有效方法之一。 可以添加提供应用值的 YouTube 或 Vimeo 视频 URL。 此外,作为最佳做法,我们建议你添加一个视频,用于提供应用的演示或方案演练。 [修复良方]
如果选择在合作伙伴中心帐户中将视频作为应用列表的一部分提交,请确保满足以下条件:
视频必须简短、清晰、引人入胜且质量良好。
该视频必须演示如何设置和使用应用。
视频必须采用叙述形式。
对于值视频,视频的持续时间必须在 60-90 秒内,并且演练视频的建议持续时间为 3-5 分钟。 [修复良方]
在应用一览中提交视频链接之前,必须关闭 YouTube 或 Vimeo 帐户设置中的广告。 [必须修复]
该视频必须突出显示你的应用的功能和 Teams 中的集成。 [必须修复]
视频必须作为功能链接提供。 [必须修复]
视频的格式必须为
https://www.youtube.com/watch?v=:id
YouTubehttps://youtu.be/:id
和https://vimeo.com/:id
Vimeo 格式或 。视频可以显示在应用详细信息的第一位置, (Teams 应用商店和管理员中心) 和 AppSource 页面的屏幕截图或视频轮播。 [修复良方]
演示或方案演练的视频必须旨在教育用户,而不是推广你的应用。
有关创建应用价值视频或演练视频的条件的详细信息,请参阅 创建视频的清单。
隐私策略
[必须修复]
隐私策略可以特定于 Teams 应用或所有服务的整体策略。
- 如果使用通用隐私策略模板,则必须添加对隐私策略范围中的服务、应用程序或平台的引用。 如果包含对服务、应用程序和平台的引用,则无需在范围内指定 Teams 应用。 应用验证过程将这些引用解释为包含 Teams 应用以及其他服务或网站。
- 必须包括处理用户数据存储、保留和删除的方式。 你必须描述用于数据保护的安全控件。
- 必须包含联系人信息。
- 不得包括已损坏、用于 beta 或暂存目的的 URL。
- 不得包含指向 AppSource 的链接。
- 不得要求身份验证来访问隐私策略。
- 不得包含任何商务 UI 或商店链接。
- 应用清单和 AppSource 中必须具有相同的链接。
使用条款
[必须修复]
使用以下准则编写使用条款:
- 必须具体且适用于你的产品/服务。
- 必须托管在你自己的域中。
- 必须具有安全的 (HTTPS) 链接。
- 对使用条款的访问不得要求身份验证。
- 应用清单和 AppSource 中必须具有相同的链接。
支持链接
[必须修复]
应用的支持 URL 必须不需要身份验证。 例如,必须允许用户在不登录的情况下联系你。
展开以了解详细信息
支持 URL 必须包含你的联系方式详细信息或供用户提出支持票证的方式。 例如,如果你的支持 URL 托管在 GitHub 上,GitHub 页面必须处于你的所有权下,并且必须包括你的联系方式详细信息或供用户提出支持票证的方式。
本地化
[必须修复]
如果应用支持本地化,则应用包必须包含基于 Teams 语言设置显示的语言翻译文件。 该文件必须符合 Teams 本地化架构。 有关详细信息,请参阅 Teams 本地化架构。 [必须修复]
应用元数据内容在 和其他本地化语言中
en-us
必须相同。 [必须修复]支持的语言必须显示在 AppSource 应用说明中。 例如,此应用以 X (X= 本地化语言) 提供。 [必须修复]
如果用户的客户端设置与任何其他语言不匹配,则默认语言将用作最终回退语言。 使用
localizationInfo
应用程序支持的正确默认语言更新 属性。 [必须修复]localizationInfo
使用应用程序支持的正确默认语言更新 属性,或者为应用清单和合作伙伴中心添加本地化内容长篇短说明。 [必须修复]
链接到 SaaS 产品/服务的应用
本部分符合 Microsoft商业市场策略编号 1140.5。 如果要构建链接到软件即服务 (SaaS) 产品/服务的 Teams 应用,请确保它遵循这些准则。
常规
- ISV 必须支持相同租户中的多个用户 (订阅者) 管理自己的订阅,并将许可证分配给租户中的用户。
- 产品/服务必须满足链接到 SaaS 产品/服务的 Teams 应用的所有技术要求。
- 链接到 SaaS 产品/服务的 Teams 应用必须满足1000 服务型软件 (SaaS) 中定义的所有要求。
-
subscriptionOffer
应用清单文件中提到的详细信息必须正确。 在应用清单中,使用值publisherId.offerId
添加或更新节点subscriptionOffer
。 例如,如果你的发布者 ID 是contoso1234
,并且你的产品/服务 ID 是offer01
,你在应用清单中指定的值必须是contoso1234.offer01
。 - Teams 应用的链接 SaaS 产品/服务必须在 AppSource 中实时提供,并且不接受预览版产品/服务进行 Teams 应用商店审批。
产品/服务元数据
- 产品/服务元数据必须跨应用清单、AppSource 中的 Teams 应用列表和 AppSource 中的 SaaS 产品/服务匹配。
- Teams 应用和 SaaS 产品/服务必须来自同一发布者或开发人员。 应用清单中引用的 SaaS 产品/服务必须与 Teams 应用提交到商业市场时属于同一发布者。
- 由于提交的产品/服务是链接到 SaaS 产品/服务的 Teams 应用,因此必须选择“ 其他购买 ”,因为 “是,我的产品需要购买服务”,或者在 产品/服务列表的合作伙伴中心产品设置部分中提供其他应用内购买。
- 计划说明和定价详细信息必须为用户提供足够的信息,以清楚地了解产品/服务列表。
- 必须在计划说明中准确指出任何限制、对附加服务的依赖关系和对提供的功能的例外。
- 链接到 SaaS 产品/服务的 Teams 应用旨在支持按姓名和用户分配许可证。 有时,SaaS 产品/服务是使用其他方法构建的,或者具有专门的购买流。 你必须在应用元数据和订阅计划详细信息中清楚地提及构建方法和购买流的详细信息。
- SaaS 产品/服务必须为购买流的所有适用状态中的所有用户提供消息和准则。
SaaS 产品/服务主页和许可证管理
向订阅者提供有关如何使用产品的介绍。
允许订阅者分配许可证。
提供与问题支持(例如常见问题解答、知识库和电子邮件)联系的不同方式。
验证用户以确保他们尚未通过其他用户分配许可证。
许可证分配后通知用户。
指导用户了解如何将应用添加到 Teams 并通过 Teams 聊天机器人或电子邮件入门。
如果 SaaS 应用使用 Microsoft许可证管理,在 ISV 登录页上确认应用订阅后,必须将用户重定向到 Teams 中的Microsoft许可证管理,以避免死胡同并允许用户在 Teams 中管理许可证。
可用性和功能
- 成功购买和分配许可证后,必须提供以下内容:
- 用户订阅计划功能的访问权限。
- 用户订阅计划的价值增加和显著优势。
- 从 Teams 应用中,提供指向 SaaS 应用程序主页的链接,以便订阅者将来管理许可证。
配置并测试 SaaS 应用程序
如果出于测试目的的应用设置很复杂,请在 认证说明中提供端到端功能文档、链接的 SaaS 产品/服务配置步骤以及许可证和用户管理说明。
提示
你可以添加一个有关应用和许可证管理工作原理的视频,以帮助团队进行测试。
选项卡
本部分符合 Microsoft商业市场策略编号 1140.4.2。 如果应用包含选项卡,请确保它遵循这些准则。
提示
有关创建高质量应用体验的详细信息,请参阅 Teams 设计指南。
设置
选项卡设置不能使新用户 死胡 子。 提供有关如何完成操作或工作流的信息。 [必须修复]
用户不得离开 Teams 中的选项卡配置体验,才能在 Teams 外部创建内容,然后返回到 Teams 进行固定。 选项卡配置屏幕必须说明配置值以及如何配置。 [必须修复]
选项卡配置屏幕不得嵌入整个网站。 使配置体验保持专注。 例如,如果要构建允许用户在频道中配置项目的项目管理应用,请保持选项卡配置屏幕专注于允许用户从应用中选择要在频道中配置的项目。 [必须修复]
要求用户在配置选项卡时输入 URL 的应用必须:
为用户获取或生成 URL 提供适当的前进指南。 [必须修复]
根据应用说明,检查与应用功能相关或适合的 URL。 [必须修复]
在配置屏幕中超链接“联系我们”信息(而不是纯文本),以帮助用户联系你了解支持要求。 [必须修复]
为了获得无缝的首次运行用户体验,建议在配置屏幕中超链接支持 URL 或电子邮件。 [修复良方]
视图
登录屏幕区域不得使用大徽标。 [必须修复]
可以通过跨多个选项卡进行分解来简化内容。
选项卡不应具有重复的标题。 从 I 框架中删除重复徽标,因为选项卡框架已显示应用图标和名称。 [修复良方]
导航
下面是导航准则:
选项卡不能提供与主要 Teams 导航冲突的导航。 如果在选项卡中提供左侧导航,则它不能仅包含带有堆积文本的图标或图标。 它不能是具有查看带有堆积文本的图标的选项的可折叠导轨, (模仿 Teams 导航栏) 。 包含带有行文本或仅文本的图标,或者使用汉堡菜单而不是左栏选项卡。 [必须修复]
如果选项卡的左侧栏上有一个不带任何导航组件的工具栏,则工具栏必须与 Teams 左侧导航保持 20 像素的间距。 [必须修复]
选项卡中的辅助和三级页面必须在第二级 (L2) 和三级 (L3) 视图中打开,main选项卡区域通过痕迹导航或左侧导航。 还可以使用以下组件来帮助在选项卡中导航:
后退按钮
页眉
汉堡菜单
选项卡中的深层链接不得链接到外部网页,而是在 Teams 中。 例如,对话框或其他选项卡。 [必须修复]
选项卡不得允许用户在 Teams 外部导航,以获取核心应用体验。 对于非核心工作流,选项卡可以重定向到 Teams 外部。 例如,提出支持票证。 [必须修复]
会议内选项卡中不得显示水平滚动。[必须修复]
应用中使用的会议内对话不得允许水平滚动。 请谨慎使用会议内对话,对于轻型和面向任务的场景。 可以在支持的大小范围内指定会议内对话 I 帧的宽度,以考虑不同的方案。 [必须修复]
应用中使用的对话框不得允许水平滚动。 对话框允许你选择不同的大小,使内容响应,而无需水平滚动。 如有必要,可以使用 Stageview (全屏 UI 组件来显示 Web 内容,) 完成工作流,而无需水平滚动。 [必须修复]
如果整个选项卡画布可滚动,则不允许在任何范围内的个人聊天、频道和会议中详细信息选项卡的选项卡中显示水平滚动,除非选项卡使用具有固定 UI 元素的无限画布。 [必须修复]
用户必须有一个选项才能转到以前的工作状态。 [必须修复]
Teams 中不得显示自适应卡片中的水平滚动。 [必须修复]
用于在选项卡中导航的底部栏不得与 Teams 本机移动应用导航冲突。 [必须修复]
可用性
内容不得在选项卡中截断或重叠。[必须修复]
用户必须能够在选项卡中撤消其最后一个操作。[必须修复]
个人上下文中的选项卡可以从应用的共享实例中聚合内容。 例如,具有可配置选项卡的项目管理应用程序(允许频道成员在看板卡上对项目进行注释)必须聚合此内容并显示在个人应用程序中。 [修复良方]
选项卡必须响应 Teams 主题。 当用户更改主题时,应用的主题必须反映所选内容。 [修复良方]
选项卡必须尽可能使用 Teams 样式的组件,例如 Teams 字体、类型渐变、调色板、网格系统、运动、语气。 有关详细信息,请参阅选项卡设计指南。 [修复良方]
如果应用功能需要更改设置,请包含 “设置” 选项卡。[修复良好]
选项卡必须遵循 Teams 交互设计,例如页面内导航、对话框的位置和使用、信息层次结构。 有关详细信息,请参阅 Microsoft Teams Fluent UI 工具包。 [修复良方]
选项卡体验必须在移动设备(Android 和 iOS)上完全响应。 [必须修复]
提示
- 将个人机器人与个人选项卡一起包含在一起。
- 允许用户从其个人选项卡中共享内容。
选项卡不得包含完全阻碍或阻碍选项卡中工作流的元素。例如,无法最小化的选项卡中的机器人。 [必须修复]
Tab 不能有损坏的功能。 产品/服务必须是一个可用软件解决方案,并且必须提供产品/服务和其他相关材料中所述的功能、功能和可交付结果。 [必须修复]
如果选项卡包含页脚,请确保从页脚中删除与应用功能无关的所有链接。 [必须修复]
范围选择
可配置选项卡的登陆页中的内容不得限定为个人使用范围,也不得包括个人内容,例如 “我的任务” 或 “我的仪表板”。 [必须修复]
配置体验后,登陆页面必须显示整个团队的协作视图。 [必须修复]
如果你的应用需要为用户提供个人范围视图以提高效率或工作场所的工作效率,请使用筛选视图、个人应用的深层链接,或导航到可配置选项卡内的 L2 或 L3 视图,并在使所有用户的登录页面保持上下文相同。 [必须修复]
对于频道的所有成员,可配置选项卡的登录页面中的内容必须上下文相同。 [必须修复]
可配置选项卡必须具有重点功能。 [必须修复]
机器人
本部分符合 Microsoft商业市场策略编号 1140.4.3。
如果应用包含机器人,请确保它遵循这些准则。
提示
有关创建高质量应用体验的详细信息,请参阅 Teams 机器人设计准则。
机器人设计指南
Teams 应用必须遵循 Teams 机器人设计准则。
当工作流涉及用户执行重复任务时,必须实现对话以避免多轮机器人响应。 例如,使用对话重复捕获姓名、出生日期、地点和指定,而不是使用多轮对话。 [必须修复]
必须修复应用中任何断开的链接、响应或工作流。 [必须修复]
机器人命令
很难分析用户输入和预测用户意向。 机器人命令为用户提供了一组供机器人理解的字词或短语。
机器人支持的所有命令必须正常工作,包括常规命令,如Hi、Hello和Help。 [必须修复]
机器人命令不能将用户引向死胡同,这些命令必须始终提供前进的道路。 [必须修复]
必须在应用清单的 部分中至少列出一个有效的机器人命令
items.commands.title
,并添加适当的说明,以便让用户清楚地了解机器人命令及其用法。 机器人命令在commandLists
应用清单图面的 部分中列为机器人命令菜单中的预填充命令,并为新用户提供与机器人交互的前进方式。 [修复良方]机器人响应不得包含任何官方Microsoft产品图像或头像。 在应用中使用自己的资产。 不允许在应用中使用Microsoft产品图像。 只有在 End-User 许可协议 (EULA) 、内容附带的许可条款或Microsoft 商标和品牌指南中,你才可复制、修改、分发、显示、许可或销售Microsoft受版权保护的产品图像。 [必须修复]
机器人必须响应用户命令,而不显示连续加载指示器。 [必须修复]
机器人帮助命令响应不得将用户重定向到 Teams 外部。 机器人帮助命令响应可以将用户重定向到 Teams 应用中的画布,或者在自适应卡片中提供转发响应的方式。 [必须修复]
即使输入不相关或不正确,机器人也必须始终向用户输入提供有效的响应。 [必须修复]
特殊字符(如斜杠 (/) )不得作为机器人命令的前缀。 [必须修复]
机器人必须对无效的用户命令提供有效的响应。 如果用户发送无效的机器人命令,机器人不得使用户死胡同或显示错误。 [必须修复]
机器人功能必须与安装机器人的范围相关,并且机器人必须在已安装的范围内提供值。 [必须修复]
机器人不能包含重复的命令。 [必须修复]
机器人在响应用户命令后不得显示键入指示器,但可以在响应用户命令时显示键入指示器。 [必须修复]
机器人必须对以小写或大写形式键入的 帮助 命令提供有效的响应,该命令为用户提供前进方式或允许用户访问与机器人用法相关的帮助内容。 即使用户尚未登录到应用,机器人也必须提供有效的响应。 [必须修复]
机器人必须提供有效的 响应来帮助命令 。
移动设备上的机器人响应必须具有响应性,并且没有任何数据截断,这妨碍了最终用户的机器人使用以完成所需的工作流。 [必须修复]
机器人响应自适应卡中的所有链接都必须具有响应性。 将用户带到 Teams 平台之外的任何链接都必须具有清晰的重定向文本,例如, “查看范围”。 或 “以这种方式访问”。、机器人响应操作按钮中的弹出图标,或者在机器人响应消息正文中具有合适的重定向文本。 [必须修复]
根据设计,如果机器人不响应或不支持任何用户命令,并且是一种单向机器人,仅用于通知用户。 必须在应用清单中将 设置为
isNotificationOnly
true。 [必须修复]在移动平台上,机器人用户体验不得中断。 机器人必须在移动设备上完全响应。 [必须修复]
提示
对于个人机器人,请包括一个 帮助 选项卡,进一步描述机器人可以执行的操作。
机器人首次运行用户体验
个人范围内的机器人必须始终发送欢迎消息或提供提示初学者。 [必须修复]
如果使用提示初学者,请确保满足以下准则:
提示初学者可帮助用户开始与机器人的对话。 若要启用提示初学者,
commands
需要定义应用清单中的 属性。- 机器人必须至少提供一个命令,使用户能够了解应用的价值主张。 [必须修复]
- 提示启动程序或命令必须正常运行并返回响应。 [必须修复]
- 命令说明必须连贯且清楚地传达命令的值。 [必须修复]
- 提示初学者或命令必须与应用的功能相关。 [必须修复]
- 机器人必须至少有三个唯一的提示初学者或命令。 [修复良方]
如果应用发送欢迎消息,请确保满足以下准则:
如果应用具有复杂的配置流 (需要企业许可证或缺少直观的注册流) ,则此类应用中的机器人必须始终包含配置相关信息,同时在首次运行期间发送欢迎消息。
为了获得最佳体验,欢迎消息必须包括机器人提供给用户的值、在通道中安装了机器人的用户、如何配置机器人,并简要描述所有支持的机器人命令。 可以使用带按钮的自适应卡片显示欢迎消息,以提供更好的可用性。 有关详细信息,请参阅 如何触发机器人欢迎消息。 对于没有复杂配置流的应用,你可以选择在机器人首次运行体验期间触发欢迎消息。 但是,如果触发欢迎消息,则必须遵循欢迎消息准则。
首次运行期间,频道和聊天中的机器人欢迎消息是可选的,尤其是在机器人可供个人使用并执行类似操作时。 机器人不得单独向用户发送欢迎消息, (它被视为 垃圾邮件) 。 消息还必须提及添加机器人的用户。
欢迎消息不能对用户造成死胡同。 欢迎消息必须包括机器人提供给在通道中安装机器人的用户的值、如何配置机器人,并简要描述所有支持的机器人命令。 可以使用带按钮的自适应卡片显示欢迎消息,以提供更好的可用性。 [必须修复]
安装在频道或群组聊天范围中的机器人不得向 1:1 聊天中的所有团队成员发送主动欢迎消息。 [必须修复]
仅通知机器人才能在通道中发送主动欢迎消息,前提是该消息包含任何用户完成机器人配置的重要信息,或阐明触发通知时的方案。 [必须修复]
安装在频道或群组聊天范围中的机器人不得发送主动消息 (不仅发送与频道或群组聊天中的所有用户无关的欢迎消息) ,还必须通过 1:1 聊天向用户发送主动消息。 [必须修复]
安装在频道或群组聊天范围中的机器人不得允许用户启动单个工作流。 机器人必须在与用户的 1:1 聊天中完成单个工作流。 [必须修复]
机器人欢迎消息必须明确指出与已安装范围内机器人使用相关的限制。 [必须修复]
欢迎消息必须在个人范围内安装应用时自动触发。 如果机器人未在个人范围内发送欢迎消息,则用户会导致死胡同。 如果应用不包含复杂的配置工作流,开发人员可以选择在频道或群聊范围内触发欢迎消息。 [必须修复]
在机器人安装时,欢迎消息必须仅触发一次。 用户每次调用 help 命令时,都不得触发欢迎消息。 必须重点处理帮助命令响应,以便用户能够访问与机器人相关的帮助。 [必须修复]
不得使用每个机器人命令触发欢迎消息。 这被视为垃圾邮件。 [必须修复]
欢迎消息内容必须与应用的长说明和安装范围中提到的机器人工作流相关。 欢迎消息必须包括机器人提供给在通道中安装机器人的用户的值、如何配置机器人,并简要描述所有支持的机器人命令。 [必须修复]
在应用安装时触发时,机器人不得发送多个欢迎消息。 [必须修复]
欢迎消息中的应用名称必须与应用清单中的应用名称匹配。 [必须修复]
除非应用提供特定的互操作性,否则欢迎消息不得显示基于竞争对手聊天的协作平台名称。
欢迎消息不得将用户重定向到另一个 Teams 应用,而欢迎消息必须轻推用户完成其第一个任务,并简要描述应用中所有受支持的机器人命令。 [必须修复]
欢迎消息不得包含指向任何应用市场的链接,包括 AppSource。 [必须修复]
如果你的应用具有复杂的配置工作流,需要管理员引导式安装,没有直观且随时可用的注册流,或者要求用户在 Teams 体验之外完成配置步骤并返回,则机器人必须在安装后在团队或群聊范围内发送主动欢迎消息。 [必须修复]
如果机器人在通道中发送欢迎消息,则它不得单独向用户发送 (它被视为垃圾邮件) 。 欢迎消息还必须提及添加机器人的人员。 [修复良方]
提示
在向单个用户发送的欢迎消息中,一次全方位介绍可以有效概述机器人和任何其他应用功能,鼓励用户尝试机器人命令。 例如,创建任务。
机器人消息垃圾邮件
机器人不能通过在短时间内发送多条消息来发送用户垃圾邮件。
频道和聊天中的机器人邮件: 请勿通过创建单独的帖子向用户发送垃圾邮件。 创建单一的帖子,并在同一线程中进行回复。 [必须修复]
个人应用中的机器人消息:
不要快速连续发送多个消息。 [必须修复]
发送一条包含完整信息的消息。 [必须修复]
避免通过多轮对话完成单个重复工作流。 [必须修复]
使用窗体 (或对话框) 一次收集用户的所有输入。 [必须修复]
基于 NLP 的对话聊天机器人可以使用多轮对话使讨论更具吸引力并完成工作流。
欢迎消息:不要定期重复相同的欢迎消息。 例如,将新成员添加到团队时,不要向其他成员发送显示为欢迎消息的垃圾邮件。 向新成员单独发送消息。 [必须修复]
机器人通知
机器人通知必须包含与你为机器人 (团队、聊天或个人) 定义的范围相关的内容。 [必须修复]
机器人和自适应卡片
自适应卡片是强烈建议显示机器人消息的方法。 卡片必须轻量,并且最多只包含六个操作。 若要显示更多内容,请考虑使用对话框或选项卡。
有关卡片的详细信息,请参阅:
机器人体验必须在移动设备上完全响应。 机器人响应必须提供一种前进方法(如果适用)。 机器人必须快速响应,并且失败时会显示一条得体的失败错误消息。 基于协作范围内触发器在个人范围内发送给用户的机器人消息必须提供上下文信息 (包括消息的来源)。
仅通知机器人
由仅通知机器人组成的应用通过基于核心应用或后端中的特定触发器或事件触发用户通知,从而为用户提供价值。 例如,添加了新的销售线索或潜在客户,供销售团队跟进。 高质量通知仅机器人会在某些事件完成(如工作流完成或警报)上定期通知用户。
提示
预览信息,并在发布的卡中提供基本的内联用户操作,以便用户无需在 Teams 外部导航所有操作, (无论) 的复杂性如何。
机器人元数据信息
应用清单中的机器人信息 (机器人名称、徽标、隐私链接和服务条款链接) 必须与 Bot Framework 元数据一致。 [必须修复]
确保应用清单中的机器人 ID 与应用上一个 Teams 应用商店发布版本中的机器人 ID 匹配。 更改应用更新中的机器人 ID 会导致应用现有用户与机器人的所有用户交互历史记录永久丢失,并使用新的机器人 ID 启动新的聊天链。 [必须修复]
对应用名称、元数据、机器人欢迎消息或机器人响应的任何更改都必须使用新名称进行更新。 [必须修复]
机器人欢迎消息或机器人响应中的应用名称必须与应用清单中的应用名称匹配。 [必须修复]
协作范围内的机器人
不允许在频道或群聊范围内安装机器人来获取团队名单,以便向用户发送主动通知,因为对于特定于团队的触发器进行 1:1 聊天。 例如,为会议配对人员的应用。 [必须修复]
频道或群聊中的机器人仅用于获取消息或帖子,以便向用户发送主动通知,因为 1:1 聊天是不允许的。 [必须修复]
安装在协作范围内的机器人必须在协作范围内提供用户值。 [必须修复]
消息扩展
本部分符合 Microsoft商业市场策略编号 1140.4.4。
如果应用包含消息扩展,请确保它遵守这些准则。
提示
有关创建高质量应用体验的详细信息,请参阅 Teams 消息扩展设计准则。
消息传递扩展设计准则
如果 Teams 应用使用消息传递扩展功能,则应用必须遵循 消息传递扩展设计准则。
消息传递是插入应用程序内容或对消息采取行动的快捷方式,而无需从对话中导航。 使消息传递扩展保持简单,并仅显示有效完成操作所需的组件。 完整网站不得在消息传递扩展中设置框架。 [必须修复]
消息扩展插件中的自适应卡片中的预览图像必须正确加载。 [必须修复]
消息扩展响应卡必须包含应用图标,以避免最终用户混淆。 [必须修复]
你的应用不能有任何损坏的功能。 应用不得死胡同或阻止用户完成消息传递扩展中的工作流。 [必须修复]
消息扩展必须在群聊和频道范围中按预期响应或正常工作。 [必须修复]
必须包括一种让用户从消息传递扩展登录或注销的方法。 [必须修复]
使用 OpenAPI URL 的消息扩展不得在任何 API 调用上提供重定向。 必须从根域的同一域或子域提供实际 API 调用。
基于操作的消息扩展的操作命令
基于操作的消息扩展必须执行以下操作:
允许用户在未完成中间步骤(如登录)的情况下对消息触发操作。
将消息上下文传递到下一个工作状态。 [必须修复]
包含主机应用名称,而不是从聊天消息、频道帖子或应用内操作调用触发的操作命令的通用动词。 例如,对“开始会议”使用“启动Skype 会议”,使用“将文件上传到 DocuSign”以上传文件。 [修复良方]
调用消息操作必须允许用户完成工作流。 错误、空白响应或连续加载指示器,使消息操作按预期正常运行,不得存在。 [必须修复]
必须不存在重复的操作命令。 [必须修复]
消息操作必须允许用户按预期完成工作流,且响应无效。 [必须修复]
仅具有基于操作的消息传递扩展的应用必须具有以下结束状态:
在调用消息扩展的上下文中或基于用户场景的 1:1 机器人聊天中发布相关操作作为通知。 [必须修复]
允许用户根据执行的操作与其他用户共享卡片。 这是为了确保应用不会执行无提示操作。 例如,票证是基于频道中的消息创建的,但应用不会发送通知,或者不提供在创建票证后请求用户共享票证详细信息的方法。 [必须修复]
预览链接 (链接展开)
[必须修复]
如果应用已在应用清单中声明了
supportsAnonymizedPayloads
属性,并且用户尚未安装该应用,则应用链接必须在选择卡后展开并显示“添加应用”对话框。 [必须修复]消息扩展必须预览在 Teams 撰写框中识别的链接。 不要添加不受控制的域 (无论是绝对 URL 或通配符)。 例如,
yourapp.onmicrosoft.com
有效,但*.onmicrosoft.com
无效。 也禁止使用顶级域。 例如,*.com
或*.org
。 [必须修复]应用只能声明应用发布者在应用清单的链接展开部分中的直接所有权
messageHandler
。 它不能包含*.botframework.com.
[必须修复]
搜索命令
基于搜索的消息扩展必须提供可帮助用户进行有效搜索的文本。 [必须修复]
@mention 可执行文件必须清晰、易于理解且可读。
对话框
[必须修复]
本部分符合 Microsoft商业市场策略编号 1140.4.5。
展开以了解详细信息
(TeamsJS v1.x) 中称为任务模块的对话框必须包含图标及其关联的应用的短名称。 对话框不得嵌入整个应用,而只能显示完成特定操作所需的组件。
有关详细信息,请参阅 Teams 对话框设计指南。
提示
有关创建高质量应用体验的详细信息,请参阅 Teams 任务模块设计准则。
会议扩展
本部分符合 Microsoft商业市场策略编号 1140.4.6。
提示
有关创建高质量应用体验的详细信息,请参阅 Teams 会议扩展设计准则。
会议扩展设计指南
Teams 应用必须遵循 会议扩展设计指南。
借助会议内应用体验,你可以使用会议内选项卡、对话框和会议内共享到舞台功能在会议期间与参与者互动。 如果你的应用支持 Teams 会议扩展,则必须提供与 Teams 会议体验一致的响应式会议内体验。 [必须修复]
会议扩展性应用必须提供与 Teams 会议体验一致的响应式会议内体验。 对于支持会议扩展性的 Teams 应用,会议中体验是必需的,但会议前和会议后体验并不是必需的。 [必须修复]
通过会议前应用体验,用户可以查找和添加会议应用。 用户还可以执行会议前任务,例如制定投票来调查会议参与者。 如果你的应用提供会议前体验,它必须与会议工作流相关。
借助会议后应用体验,用户可以查看会议结果,例如投票调查结果或反馈和其他应用内容。 如果你的应用提供会议后体验,它必须与会议工作流相关。
通过会议内应用体验,可以在会议期间与会议参与者互动,并增强所有与会者的会议体验。 与会者不得被带出 Teams 会议来完成应用的核心用户工作流。
除了在 Teams 中仅提供自定义的一起模式场景之外,你的应用还必须提供价值。 [必须修复]
必须在 应用清单中声明
groupChat
为 和meetingDetailsTab
、meetingChatTab
和meetingSidePanel
下configurableTabs
的范围,以及 作为应用清单中的上下文属性,才能为 Teams 移动版上的会议启用应用。 [必须修复]会议画布不能对会议与会者造成死胡子。 会议画布必须针对应用限制(例如区域特定的依赖项)显示正常失败消息。 [必须修复]
会议画布的标头必须显示正确的应用名称,以免使与会者感到困惑。 [必须修复]
必须包含一个选项,用户才能从会议扩展注销或注销。 [必须修复]
移动平台上的会议选项卡必须包含相关的工作流。 会议选项卡中不得显示空白页。[必须修复]
会议阶段是一个集中、直观且协作的参与画布。 会议阶段不得嵌入完整的网站体验。 [必须修复]
应用不得显示连续加载屏幕、错误或中断功能,这些屏幕、错误或中断功能会使用户死胡同或阻止在会议场景中完成工作流。 [必须修复]
应用在开始会议时不得打开新的 Teams 实例。 会议画布是 Teams 功能的扩展,可促进实时协作,新会议必须始终在活动 Teams 实例中打开。 [必须修复]
会议应用必须在 Microsoft Teams 平台中完成工作流,而无需重定向到基于聊天的竞争对手平台。 [必须修复]
如果你的应用支持基于角色的视图,并且某些工作流对所有参与者都不可用,我们建议你在选项卡和侧面板中为参与者实现正确的消息传送,指出该应用供组织者查看,并提供与会者如何接收会议笔记、操作项目和更新议程的详细信息。 [必须修复]
会前和会后体验
会议前和会议后屏幕必须遵守常规选项卡设计准则。 有关详细信息,请参阅Teams 设计准则。 [必须修复]
显示多个项时,选项卡应具有井然有序的布局。 例如,超过 10 个投票或调查,请参阅 示例布局。 [必须修复]
当导出调查或投票的结果时,你的应用必须通知用户,表明“结果已成功下载”。 [必须修复]
会议中体验
在会议期间应用必须仅能使用深色主题。 有关详细信息,请参阅Teams 设计准则。 [必须修复]
在会议期间将鼠标悬停在应用图标上时,工具提示必须显示应用名称。 [必须修复]
消息扩展在会议期间的功能必须与在会议外部执行的相同。 [必须修复]
会议中选项卡
必须具有响应能力。 [必须修复]
必须保持填充和组件大小。 [必须修复]
如果具有多个导航层,则必须有一个后退按钮。 [必须修复]
不得包含多个关闭按钮。 它可能会使用户感到困惑,因为已经有一个内置的标题按钮来关闭选项卡。[必须修复]
不得有水平滚动。 [必须修复]
会议内对话
应谨慎使用并用于轻型和任务导向的场景。 [必须修复]
必须在单栏中显示内容,而且不能有多个导航层。 [必须修复]
不得使用对话框。 [必须修复]
必须与会议阶段的中心对齐。 [必须修复]
在用户选择按钮或执行某个操作后必须关闭。 [必须修复]
共同模式:确保考虑以下场景生成体验的最佳做法:[必须修复]
- 所有图像都采用 .PNG 格式。
- 包含所有图像的最终包不能超过 1920x1080 分辨率。 分辨率为偶数。 要成功显示场景,需要此分辨率。
- 最大场景大小为 10 MB。
- 每个图像的最大大小为 5 MB。 场景是多个图像的集合。 限制是针对每个单独图像。
- 根据需要选择 透明。 选中图像后,此复选框在右侧面板上可用。 重叠的图像必须标记为透明,以指示它们是场景中的重叠图像。
共享会议阶段
若要使用 shareAppContentToStage API,必须声明正确的 RSC 权限。 在应用清单中,必须配置 authorization
属性。 将 name
属性更新为 MeetingStage.Write.Chat
,并将 type
属性更新为 字段中的 resourceSpecific
属性Delegated
。 [必须修复]
共享会议阶段功能只能通过 Teams 桌面应用启动。 但是,在移动设备上查看时,共享会议阶段使用体验必须可用且不会中断。 [必须修复]
Connector
连接器名称必须与应用内和应用清单中的应用名称相同。
用户在配置连接器时不得遇到任何错误。
通知
本部分符合 Microsoft商业市场策略编号 1140.4.7。
如果你的应用使用 Microsoft Graph 提供的活动源 API,请确保它遵循以下准则。
提示
如果你的应用支持通知方案,即在较长的间隔后(例如,一天或一个月后)触发通知。 在提交以供审阅之前,请确保在后台触发此类通知,以便我们测试通知。
通知设计指南
Teams 应用必须遵循 活动源通知设计准则。
用户在 Teams 活动源中选择通知后,不得存在不相关、不当、无响应或中断的工作流。 用户选择活动源通知后,不得阻止他们完成工作流。 [必须修复]
在活动源通知中包括应用的名称,以便最终用户了解通知的源或触发器,而不会造成混淆。 [必须修复]
应用必须针对应用长说明、应用首次运行体验以及应用清单中下
activityTypes
声明的方案中提到的所有通知方案触发通知。 [必须修复]通知必须在用户操作后的五秒内显示。 [必须修复]
如果应用长说明或应用的首次运行体验中有任何) ,则必须 (通知限制。 [必须修复]
常规
- 应用配置中指定的所有通知触发器都必须正常工作。 [必须修复]
- 通知必须根据为应用配置的支持语言进行本地化。 [必须修复]
- 通知必须在用户操作后的五秒内显示。 [必须修复]
- 通知必须按照应用兼容的所有平台支持的语言进行本地化。 [必须修复]
虚拟形象
- 通知头像必须与应用的颜色图标匹配。 [必须修复]
- 用户触发的通知必须包含用户的头像。 [必须修复]
垃圾 邮件
- 应用每分钟向用户发送的通知数不得超过 10 个。 [必须修复]
- 机器人和活动源不得触发重复通知。 [必须修复]
- 通知必须为用户提供一些值,并且不能用于琐碎或不相关的事件。 [必须修复]
导航和布局
- 通知必须遵循 Teams 活动源布局和体验。 [必须修复]
- 在选择通知时,必须将用户定向到 Teams 内部的相关内容。 [必须修复]
Microsoft 365 应用合规性
本部分符合 Microsoft商业市场策略编号 1140.6。
展开以了解详细信息
Microsoft 365 应用合规性计划 旨在帮助企业通过评估应用程序的安全和合规性信息来评估和管理风险。 如果要将应用发布到 Teams 应用商店,则必须完成该程序的以下层:
发布者验证: 可帮助管理员和终端用户了解到应用开发人员与 Microsoft 标识平台集成的真实性。 完成后,蓝色的已验证锁屏提醒会显示在Microsoft Entra同意对话框和其他屏幕上。 有关详细信息,请参阅 将你的应用标记为经过发布者验证。 [必须修复]
发布者证明: 共享常规、数据处理以及安全性和合规性信息的过程,以帮助潜在客户在使用应用时做出明智的决定。 [修复良方]
对于之前未列出的应用,在 Teams 应用商店中提供应用之前,无法完成发布者证明。 如果要更新已列出的应用,请在提交应用的最新版本之前完成 发布者证明 。
广告
本部分符合 Microsoft 商业市场策略编号1140.7。
应用不得显示广告,包括动态广告、横幅广告和消息中的广告。 [必须修复]
基于加密货币的应用
如果应用[必须修复],则必须证明符合分发应用的所有法律
促进应用内的加密货币交易或传输。
推广与加密货币相关的内容。
使用户能够存储或访问其存储的加密货币。
鼓励或允许用户在 Teams 平台之外完成基于加密货币的交易或传输。
鼓励或促进加密货币令牌的挖掘。
促进用户参与初始硬币产品。
奖励或激励用户使用加密货币令牌完成任务。
经过内部Microsoft评审后,如果合规性演示令人满意,Microsoft可以继续对应用进行进一步认证。 如果合规性演示不尽如人意,Microsoft随时通知你决定不继续对应用进行认证。
应用功能
- 应用中的工作流或内容必须与范围相关。 [必须修复]
- 所有应用功能都必须正常运行,并且必须正常工作,如 AppSource 或应用清单长说明中所述。 [必须修复]
- 在用户环境中下载任何文件或可执行文件之前,应用必须始终通知用户。 任何行动号召 (CTA) (基于文本或其他方式),使用户清楚地知道,在用户操作上下载文件或可执行文件在应用中是允许的。 [必须修复]
- 如果用户尝试在不受支持的区域使用,则具有区域依赖关系的应用必须在所有适用功能中通知其正常失败消息。 [必须修复]
移动体验
移动加载项必须是免费的。 不得有任何推广追加销售、在线商店或其他付款请求的应用内内容或链接。 应用所需的任何帐户都必须免费使用,如果时间有限,则不得包含任何指示需要付费的内容。 [必须修复]
在桌面或 Web 应用体验中,允许使用 “免费”、“ 免费试用”或“ 免费试用 ”一词,没有任何限制或考虑。
在移动设备上,允许在试用或应用升级的上下文中使用 “免费 ”一词作为纯文本。
在试用版或应用升级上下文中使用 “免费 ”一词,允许在移动设备上提供指向登陆页面的链接,而无需付款或定价信息。 在移动设备上允许使用纯文本向应用 发出“付费 ”信号。
移动设备上不允许在试用版或应用升级的上下文中使用 “免费 ”一词作为纯文本并与定价详细信息相关联。 [必须修复]
不允许在试用或应用升级的上下文中使用 “免费 ”一词,并且与指向移动设备上包含定价信息或付款详细信息的登陆页面的链接相关联。 [必须修复]
不允许使用任何格式(例如图像、文本或链接)的移动设备上的定价详细信息。 不允许在移动设备上 查看计划 等 CTA。 不允许在移动设备上提供没有定价详细信息但包含联系人链接或电子邮件的计划信息。 移动设备上不允许任何带有联系人详细信息链接或暗示付费升级的文本。 移动设备上允许对实物进行付款。 例如,你的应用可以允许支付以预订出租车。 [必须修复]
移动设备上不允许对应用中的数字商品进行付款。 [必须修复]
Teams 应用必须提供适当的跨设备移动体验。 [必须修复]
移动设备上不支持的功能不能使用户死胡子,并且必须在适用的情况下提供正常失败消息。 [必须修复]
跨 Microsoft 365 个客户端扩展的应用
一般信息
旨在跨 Microsoft 365 客户端扩展 Teams 应用的应用必须使用架构版本 1.13 或更高版本。
应用的支持 URL 必须包含与 Teams 应用相关的内容,可跨 Microsoft 365 个客户端扩展,并且不能仅调用单个客户端。
必须在应用说明中提供可跨 Microsoft 365 个客户端扩展的 Teams 应用的相关引用。
如果 Teams 应用在 Microsoft 365 个客户端之间可扩展,则应用入门、登录、注册、注销、帮助页面或转发消息中提供的内容必须调出所有客户端。
兼容性
跨 Microsoft 365 个客户端扩展的 Teams 应用必须在最新版本的 Microsoft Edge 和 Google Chrome 客户端上具有完全响应和功能。 用户必须能够调用并继续使用以下个人选项卡或消息扩展:
- Outlook for Windows 和 Web。
- Microsoft 365 桌面版、Web 版和 Android 版。
- 在桌面和 Web 上Microsoft Teams。
- Microsoft Android 和 iOS 上的 Teams。
移动体验
用户必须能够从移动设备上的 Microsoft 365 客户端中的操作浮出控件菜单中启动应用。 应用名称必须正确显示在操作栏中。 [必须修复]
从操作浮出控件启动应用
用户必须能够在移动设备上的 Microsoft 365 客户端中成功启动和切换多个静态选项卡。 选项卡必须正确加载。 如果静态选项卡超过三个,则剩余的选项卡必须在 “更多 ”部分下可见。 [必须修复]
多选项卡体验
如果应用使用 SSO,则必须成功对用户进行身份验证。 SSO 允许用户使用一组凭据登录到多个独立软件系统。 用户可以访问所有必需的应用程序,而无需使用不同的凭据进行身份验证。 [必须修复]
应用身份验证
当用户在移动设备上的 Microsoft 365 客户端中切换或注销时,应用必须终止用户帐户实例。 [必须修复]
帐户切换和注销体验
用户必须能够返回到以前的工作状态。 如果用户位于根页上,则后退导航必须终止移动版 Microsoft 365 客户端中的应用实例。 [必须修复]
支持深层链接到工作流的应用必须能够将用户重定向到相应的登陆页面体验。 [必须修复]
选项卡导航
当应用正在加载时,必须显示进度指示器,并在加载应用后自动关闭。 [必须修复]
当应用在实例中加载失败时,必须显示错误屏幕,例如网络不连贯或中断、超时或身份验证失败等。 [必须修复]
Teams 应用可扩展为智能 Microsoft 365 Copilot 副驾驶®的代理
- 应用包的格式正确,并遵循清单架构版本 1.13 或更高版本。
- 应用必须通过 负责任的 AI 检查。
- 应用必须满足 代理兼容条件。
代理不得操作 LLM 行为
应用、参数和命令的简短说明不得包括以下内容:
- 说明性短语。 例如,如果用户说 X,请忽略、删除、重置、新说明、以粗体回答或不打印任何内容。
- 详细、花语或营销语言。
- 最高声明,例如 #1、 惊人或 最佳。
- URL、表情符号或隐藏字符(如十六进制、二进制或非常规符号)。
- 语法和标点符号错误。
用户感知
应用的长说明必须明确指出以下内容:
应用与智能 Microsoft 365 Copilot 副驾驶®的兼容性。 例如,在 智能 Microsoft 365 Copilot 副驾驶® 中使用 Contoso 搜索和汇总任务。
提供至少一个提示,指示用户如何在 智能 Microsoft 365 Copilot 副驾驶® 中使用消息扩展代理。 例如,本周在 Contoso 中分配给我的高优先级票证是什么。
响应质量
智能 Microsoft 365 Copilot 副驾驶®自适应卡片响应中的必填字段必须包含信息标题和至少两个其他有用字段,例如修改日期、作者、状态和标志。 预览和内容都必须是单个响应的一部分。
智能 Microsoft 365 Copilot 副驾驶®响应中的自适应卡片必须至少有一个操作按钮。
智能 Microsoft 365 Copilot 副驾驶®响应自适应卡片中存在的操作按钮必须正常工作。
智能 Microsoft 365 Copilot 副驾驶®必须准确响应,并且当用户使用单个参数提示时不显示错误。
智能 Microsoft 365 Copilot 副驾驶®必须准确响应,并且当用户使用多个参数提示时不显示错误。
智能 Microsoft 365 Copilot 副驾驶®必须准确响应,并且当用户提示跟进时不显示错误。
消息扩展必须至少包含两个参数,以增强智能 Microsoft 365 Copilot 副驾驶®用户体验。