You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

上传Teams机器人清单后Bot未显示,请求修复建议

Teams Bot 上传清单后不显示的修复方案

嘿,我帮你排查出问题所在了——你提供的清单文件缺少大量必填核心字段,Teams根本没办法识别并展示你的Bot。下面是具体的修复建议和完整模板:

一、先补全必填字段

你的清单里缺了这些关键内容,必须加上:

  • displayName:这是Bot在Teams里显示的名称,用户一眼就能看到
  • description:包含短描述和长描述,说明Bot的功能
  • icons:需要32x32和192x192两种尺寸的图标URL,Teams会用它来展示Bot
  • bots:这是Bot配置的核心,必须指定Bot ID、可使用的范围(个人聊天、团队、群组)以及支持的命令
  • validDomains:列出Bot可以访问的域名,包括Bot Framework的域名botframework.azure.net
  • **developer**里的privacyUrl和termsOfUseUrl:虽然部分版本可选,但补上能避免验证时出问题

二、修正现有字段的小问题

  • 你填的developer.websiteUrl是不完整的,得换成有效的完整URL,比如https://your-actual-domain.com
  • 确认id字段和你在Azure Bot Service里拿到的Bot ID完全一致,这个GUID不能错

三、给你一份完整的修复后清单模板

你可以把下面的模板替换成自己的信息,直接用:

{
  "$schema": "https://statics.teams.microsoft.com/sdk/v1.2/manifest/MicrosoftTeams.schema.json",
  "manifestVersion": "1.2",
  "version": "1.0.0",
  "id": "1e15eacc-4676-454a-8222-960a16b4e214",
  "packageName": "BOT-test",
  "displayName": "测试Bot",
  "description": {
    "short": "用于Teams集成测试的演示Bot",
    "full": "这是一个专门用来测试Microsoft Teams集成的Bot,支持一对一聊天、团队内消息交互等场景"
  },
  "icons": {
    "outline": "https://your-domain.com/icon-32.png",
    "color": "https://your-domain.com/icon-192.png"
  },
  "developer": {
    "name": "Lalit",
    "websiteUrl": "https://your-domain.com",
    "privacyUrl": "https://your-domain.com/policy/privacy",
    "termsOfUseUrl": "https://your-domain.com/policy/terms"
  },
  "bots": [
    {
      "botId": "1e15eacc-4676-454a-8222-960a16b4e214",
      "scopes": [
        "personal",
        "team",
        "groupchat"
      ],
      "commandLists": [
        {
          "scopes": [
            "personal",
            "team",
            "groupchat"
          ],
          "commands": [
            {
              "title": "hello",
              "description": "发送问候消息"
            },
            {
              "title": "help",
              "description": "查看Bot使用帮助"
            }
          ]
        }
      ]
    }
  ],
  "validDomains": [
    "your-domain.com",
    "botframework.azure.net"
  ],
  "isFullScreen": false
}

四、额外的排查要点

  • 别忘了在Azure Bot Service里把Microsoft Teams渠道启用,这一步没做的话,Bot就算清单对了也用不了
  • 上传修正后的清单后,要在Teams里重新安装你的应用——不是只上传就完了,得去应用商店找到你的测试应用安装上
  • 用Teams App Studio的验证功能检查清单,它会列出所有错误,照着提示改就行

内容的提问来源于stack exchange,提问作者Leo

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.05.25 06:37:41