托管应用BotService Teams通道CHANNEL_NOT_SUPPORTED错误修复求助

问题场景 #

开发集成Teams机器人的托管应用时，部署Microsoft.BotService/botServices/channels资源触发CHANNEL_NOT_SUPPORTED错误，导致部署流程失败。

错误原因分析 #

该错误由两处核心配置问题引发：

1. 通道标识错误：配置中使用的MsTeamsChannel并非Azure Bot Service认可的Teams通道标准标识，正确标识应为TeamsChannel。
2. 资源命名不规范：通道资源名称[concat(parameters('webAppName'), '-bs/', '-tc')]中，通道部分以连字符开头，不符合Azure资源命名规则，且未对应有效通道标识符。

修复方案 #

1. 修正通道配置代码 #

将原通道资源配置替换为以下内容：

{
    "type": "Microsoft.BotService/botServices/channels",
    "apiVersion": "2022-06-15-preview",
    "name": "[concat(parameters('webAppName'), '-bs/', 'TeamsChannel')]",
    "location": "global",
    "sku": {
        "name": "F0"
    },
    "kind": "azurebot",
    "properties": {
        "channelName": "TeamsChannel",
        "properties": {
            "isEnabled": true
        }
    },
    "dependsOn": [
        "[resourceId('Microsoft.BotService/botServices', concat(parameters('webAppName'), '-bs'))]"
    ]
}

2. 额外验证项 #

• 确认Bot资源的msaAppId已正确关联用户分配的托管标识，且该标识拥有Bot Service的必要权限。
• 验证Web App的消息端点[concat('https://', parameters('webAppName'), '.azurewebsites.net', '/api/v1/messages')]可正常访问，确保机器人能接收Teams的消息请求。

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