带WebChat功能的Teams Bot应用在客户租户安装失败问题咨询

一、获取详细错误信息的方法 #

• 客户端调试：先开启Teams开发者预览模式，重启客户端后复现安装操作，按下Ctrl+Shift+I（Windows）/Command+Option+I（Mac）打开开发者工具，在Console面板筛选错误级日志，可获取具体的安装失败错误码和原因说明
• 租户管理员日志查询：让客户侧的Teams全局管理员进入Teams管理中心，依次打开「Teams应用→管理应用」，搜索对应应用名称查看安装审计记录；也可进入Azure Active Directory管理中心的「监控→审计日志」，筛选应用类操作记录，查看权限拦截的具体原因
• 本地manifest校验：使用Teams官方开发工具的校验命令teams app validate，本地扫描manifest文件的配置错误，可直接定位格式、必填项缺失类问题

二、最小可用manifest配置修正 #

你当前的manifest存在冗余错误配置，删除无效的staticTabs节点即可得到最小可用版本，修正后的配置如下：

{
  "$schema": "https://developer.microsoft.com/en-us/json-schemas/teams/v1.9/MicrosoftTeams.schema.json",
  "manifestVersion": "1.9",
  "version": "1.0.0",
  "id": "替换为你的应用ID",
  "packageName": "tdo.chatbot1",
  "developer": {
    "name": "XXX YY",
    "websiteUrl": "https://xxxx.yyy",
    "privacyUrl": "https://xxxx.yyy",
    "termsOfUseUrl": "https://xxx.yyy",
    "mpnId": "111111"
  },
  "icons": {
    "color": "color.png",
    "outline": "outline.png"
  },
  "name": {
    "short": "chatbot1",
    "full": "chatbot1"
  },
  "description": {
    "short": "A Teams App with Bot",
    "full": "TestBotTeams"
  },
  "accentColor": "#40497E",
  "bots": [
    {
      "botId": "替换为你的机器人ID",
      "scopes": [
        "personal"
      ],
      "supportsFiles": false,
      "isNotificationOnly": false
    }
  ],
  "permissions": [
    "identity",
    "messageTeamMembers"
  ],
  "validDomains": []
}

注意：如果后续需要嵌入WebChat页面，需要把WebChat的部署域名添加到validDomains数组中，否则页面会被Teams安全策略拦截

三、权限与配置检查项 #

• 应用注册配置确认：需要将bot对应的Azure应用注册设置为多租户模式，单租户模式仅支持在你的开发租户安装，切换模式后需等待10-15分钟配置生效
• 客户租户配置确认：让客户管理员开启租户的自定义应用上传权限，路径为Teams管理中心→Teams应用→设置策略→全局默认策略，开启「上传自定义应用」开关
• 机器人频道配置确认：进入Azure Portal对应的Bot Service资源，在频道设置中添加Microsoft Teams频道，未配置该频道会直接导致安装失败

内容的提问来源于stack exchange，提问作者ingo_ww