在 Teams 应用中包含 SaaS 产品/服务

借助可交易的软件即服务 (SaaS) 产品/服务，你可以通过直接从Microsoft Teams 应用商店一览销售订阅计划来盈利 Teams 应用。 例如，假设你有一个任何人都可以在 Teams 应用商店中获取的免费应用。 现在，你可以为需要更多功能的用户提供高级版和企业版计划。

下面是有关如何实现应用盈利的一般概念：

1. 规划 SaaS 产品/服务。

2. 与 SaaS 履行 API 集成。

3. 生成用于订阅管理的登陆页。

4. 创建 SaaS 产品/服务。

5. 为 SaaS 产品/服务配置应用。

6. 将应用发布到 Teams 应用商店。

规划 SaaS 产品/服务

有关全面的指南，请参阅 如何规划面向 Microsoft 商业市场的 SaaS 产品/服务。

规划如何实现 Teams 应用盈利时，需要考虑以下事项：

• 针对订阅模型做出决定。 可交易的 SaaS 产品/服务可以包含多个订阅计划。 任何人都可使用的公共订阅计划最为常见，但你可能还希望通过仅面向他们的交易服务特定客户。 有关详细信息，请参阅 Microsoft 商业市场中的专用计划。
• 阅读 SaaS 产品 /服务的“通过Microsoft销售 ”列表选项 ，如果希望用户直接通过 Teams 应用商店购买应用的订阅计划，则需要此选项。
• 了解 Microsoft Entra 单一登录 (SSO) 如何帮助客户购买和管理订阅。 使用 SaaS 产品/服务的 Teams 应用需要 (Microsoft Entra SSO。)
• 了解你负责管理支持客户使用 SaaS 产品/服务所需的基础结构并负责支付费用。
• 规划移动设备。 为了避免违反第三方 Teams 应用商店策略，你的应用不能包含允许用户在移动设备上购买订阅计划的链接。 但你仍然可以指示应用是否具有需要订阅计划的功能。 有关详细信息，请参阅相关的 商业市场认证策略。

与 SaaS 履行 API 集成

要实现 Teams 应用盈利，需要与 SaaS 履行 API 集成。 这些 API 可帮助你在用户购买订阅计划后管理其生命周期。

有关完整的说明和 API 参考，请参阅 SaaS 履行 API 文档。 一般情况下，购买订阅后，你将使用该 API 实施以下步骤：

1. 通过指向登陆页的 URL 接收 购买标识令牌。

2. 使用令牌检索订阅详细信息。

3. 通知商业市场该订阅已激活。

实现订阅管理的最佳做法

• 对于 Teams 应用的可交易 SaaS 产品/服务，应将订阅计划（许可证）分配给单个用户，而不是组或整个组织。
• 为用户分配订阅计划时，请通过 Teams 机器人或电子邮件通知他们。 在消息传递中，包括有关如何将应用添加到 Teams 并开始使用的信息。
• 支持多个管理员的想法。 换句话说，同一组织中的多个用户可以购买和管理自己的订阅。

生成用于订阅管理的登陆页面

当某人在 Teams 应用商店中为你的应用购买完订阅计划时，商业市场会将他们定向到你的登陆页面，他们可以在其中管理订阅 (例如，将许可证分配给其组织) 中的特定用户。

有关完整说明，请参阅 为 SaaS 产品/服务构建登陆页。

登陆页的最佳做法

在为要实现盈利的 Teams 应用生成登陆页时，请考虑采用以下方法。 请参阅 最终用户购买体验中的示例登陆页。

• 用户必须能够使用用于购买订阅的相同Microsoft Entra 凭据登录到登陆页面。 有关详细信息，请参阅 商业市场中Microsoft Entra ID 和可交易的 SaaS 产品/服务。
• 允许用户在登陆页上执行以下操作。 不要忘记考虑适合用户的角色和权限的内容。 例如，你可能希望仅允许订阅管理员搜索用户)：
  • 使用电子邮件或其他形式的标识在其组织中搜索用户。
  • 查看他们可以在列表中向其分配许可证的用户。
  • 同时向一个或多个用户分配许可证。
  • 分配和管理不同类型的许可证（如果可用）。
  • 验证许可证是否已分配给另一个用户。
  • 取消其订阅。
• 提供有关如何使用应用的简介。
• 添加获取支持的方法，例如常见问题解答、知识库或联系人电子邮件。
• 提供一个链接，以便订阅者可以轻松地返回到登陆页面。 例如，将此链接包含在应用的“关于”选项卡中。

创建 SaaS 产品/服务

集成 SaaS 履行 API 并生成用户可在其中管理其订阅的登陆页面后，下一步是正式创建、测试和发布可交易的 SaaS 产品/服务。

创建产品/服务

有关如何在合作伙伴中心中执行此操作的完整说明，请参阅 创建 SaaS 产品/服务。 以下步骤介绍在高级别上要执行的操作。

1. 创建 合作伙伴中心 帐户（如果没有）。

2. 为可交易的 SaaS 产品/服务配置订阅计划、定价详细信息等。 尤其要确保完成以下步骤：

   • 在“设置详细信息”下，选择“是”选项，以指定通过 Microsoft 销售产品/服务。

   • 在“Microsoft 365 集成”下，将 AppSource 链接添加到应用列表。 此步骤可确保除 Teams 之外，用户还可以在 AppSource 中购买订阅计划。

3. 存储发布者和产品/服务 ID。 （稍后需要它们才能将产品/服务链接到“开发人员门户”中的应用。）

4. 将产品/服务发布到商业市场。

测试产品/服务

建议在发布 SaaS 产品/服务之前对端到端购买体验进行验证。 可以创建单独的产品/服务以用于测试。 有关完整信息，请参阅 测试产品/服务概述、创建测试产品/服务 和 预览产品/服务。

重要

可以使用 测试盈利应用的预览版 在 Teams 中测试端到端事务。 对于实时产品/服务，必须完成 Teams 应用商店验证过程。

从 Teams 的角度来看，在用户执行以下操作时，这些测试必须验证许可证和分配的数量是否与 Teams 管理中心中的内容匹配：

• 在登陆页面上激活并配置其订阅计划。
• 向自己或其他人分配许可证，或将其删除，或重新分配许可证。
• 取消或续订其订阅。

发布产品/服务

完成测试后，可 在线发布产品/服务。

为 SaaS 产品/服务配置应用

你已发布 SaaS 产品/服务，但仍必须将其链接到 Teams 应用，以便用户在 Teams 应用商店中查看订阅计划。

1. 转到“开发人员门户”并选择“应用”。

2. 在“应用”页上，选择要将 SaaS 产品/服务链接到的应用。

3. 转到“计划和定价”页，并指定发布者和产品/服务 ID。 （如果没有现成可用的 ID，则可以在合作伙伴中心中找到这些 ID。）

4. 选择“查看”以预览 SaaS 产品/服务的订阅计划。

5. 当一切正常时，选择“保存”。

   将 subscriptionOffer 属性将添加到 应用清单。

      "subscriptionOffer": {
        "offerId": "publisherId.offerId"  
        }
   

注意

清单 subscriptionOffer 架构版本 1.10 或更高版本支持 属性。

发布应用程序

你已创建 SaaS 产品/服务并将其链接到 Teams 应用，现在可以将应用发布到 Teams 应用商店了。 有关完整说明，请参阅 将应用发布到 Teams 应用商店。

重要

• 即使你的应用已在 Teams 应用商店中列出，你仍必须再次完成 Teams 应用商店验证过程才能包含 SaaS 产品/服务。
• 应更新应用清单中未包含产品/服务 ID 和发布者 ID 的单一费率产品/服务，并重新提交以供验证。

发布后，用户在尝试将应用添加到 Teams 时，将在应用详细信息对话框中看到 “购买订阅 ”选项。

从应用中删除 SaaS 产品/服务

如果取消链接 Teams 应用商店一览中包含的 SaaS 产品/服务，则必须重新发布应用才能在 Teams 应用商店中查看更改。

1. 转到“开发人员门户”并选择“应用”。
2. 在“应用”页上，选择要从中删除产品/服务的应用。
3. 转到“计划和定价”页，然后选择“还原”。
4. 取消产品/服务链接后，执行以下操作以更新 Teams 应用商店一览：
   1. 选择“ 分发 > 发布到 Teams 应用商店”。
   2. 选择“打开合作伙伴中心”以开始重新发布不带产品/服务的应用的过程。

代码示例

示例名称	说明	Node.js	清单
Tab 应用盈利	这是一个示例选项卡应用程序，演示如何使用 Teams JS SDK 打开购买对话框并触发购买流。	View	View

另请参阅

• 链接到 SaaS 产品/服务的应用的验证准则
• Microsoft商业市场