配置 Teams 应用的默认选项

应用通常支持 Teams 中的多个方案,但你可能在设计时考虑了特定的范围和功能。 例如,如果你的应用主要用于团队或频道,你可以确保用户在 teams 应用商店中看到的第一个安装选项Microsoft是 “添加到团队”。

屏幕截图显示“添加到团队”选项。

如果应用的主要功能是机器人,也可以在用户将应用安装到团队时将机器人设为默认功能。

配置应用的默认安装范围

为应用配置默认安装范围。 一次只能设置一个范围。 有关详细信息,请参阅 应用清单

若要在应用清单中配置默认安装范围,请执行以下操作:

  1. 打开应用清单并添加 defaultInstallScope 属性。

  2. 将默认安装范围值设置为 personalteamgroupchatmeetings

    "defaultInstallScope": "meetings",
    

配置共享范围的默认功能

为团队、会议或群聊安装应用时,配置默认功能。 有关详细信息,请参阅 应用清单

注意

defaultGroupCapability 提供添加到团队、群组聊天或会议的默认功能。 选择选项卡、机器人或连接器作为应用的默认功能,但必须确保已在应用定义中提供了所选功能。

若要在应用清单中配置详细信息,请执行以下操作:

  1. 打开应用清单并 defaultGroupCapability 向其添加 属性。

  2. 将值 team设置为 、 groupchatmeetings

  3. 对于所选组功能,可用的组功能为 、bottab、 或 connector

    注意

    只能为所选组功能 bot选择一个默认功能、、 tabconnector

    "defaultGroupCapability": {
        "team": "bot",
        "groupchat": "bot",
        "meetings": "tab"
    }
    

默认情况下,在管理员批准之前阻止用户的应用

为了增强 Teams 应用的用户体验,有时,IT 管理员必须在用户使用应用之前进行干预。 例如,请考虑由 Contoso Electronics for Teams 创建的技术支持应用。 为确保应用正常运行,Contoso Electronics 希望客户首先配置应用的特定属性。

为了确保 IT 管理员执行相关任务,开发人员可以阻止用户的应用,直到管理员允许该应用为止。 若要默认阻止应用,请在 defaultBlockUntilAdminAction 应用清单文件中将 属性 true 设置为 。 当 属性设置为 true时,Teams 管理中心中的应用状态为“管理应用”页中的发布者阻止

屏幕截图显示发布者阻止的应用。

管理员可以对你的应用进行尽职调查,并且可以在允许用户使用你的应用之前阅读 你提供的应用文档 。 例如,管理员可以在允许用户使用应用之前购买所需的许可证并分发许可证。 若要允许发布者状态为“已阻止”的应用,管理员可以在 Teams 管理中心的“管理应用”页中选择“允许”。

屏幕截图显示发布者阻止的应用的“允许”选项。

如果不希望默认情况下阻止你的应用,请将设置更新 defaultBlockUntilAdminActionfalse 并提交更新的应用以供发布。 发布新版本的应用后,默认允许该版本。

注意

对于为组织生成的自定义应用, defaultBlockUntilAdminAction 不支持。 如果使用此属性上传为组织生成的自定义应用,则不会阻止该应用。

后续步骤