上传Teams机器人清单后Bot未显示,请求修复建议
Teams Bot 上传清单后不显示的修复方案
嘿,我帮你排查出问题所在了——你提供的清单文件缺少大量必填核心字段,Teams根本没办法识别并展示你的Bot。下面是具体的修复建议和完整模板:
一、先补全必填字段
你的清单里缺了这些关键内容,必须加上:
displayName:这是Bot在Teams里显示的名称,用户一眼就能看到description:包含短描述和长描述,说明Bot的功能icons:需要32x32和192x192两种尺寸的图标URL,Teams会用它来展示Botbots:这是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
相关产品推荐
相关产品推荐

