如何手动将Bot Framework SDK聊天机器人部署到Azure及问题解决

原有的Web App Bot资源已停止提供，可通过手动创建并配置以下资源完成Bot Framework聊天机器人的Azure部署，步骤如下：

1. 创建托管代码的App Service #

• 快速方式：克隆早期Web App Bot对应的App Service实例，替换关联的GitHub仓库为你的机器人代码仓库，直接得到可部署的Web App；
• 常规方式：新建App Service，选择与机器人代码匹配的运行时环境（如Node.js、.NET等），配置基础托管参数。

2. 创建并配置Azure Bot资源 #

• 在Azure门户创建Azure Bot资源，完成基础配置后进入资源的「配置」页面；
• 将「消息终结点」设置为你的Web App访问URL + /api/messages（注意路径为斜杠开头）。

3. 配置身份验证核心参数 #

Azure Bot与Bot Framework服务交互依赖应用注册的身份信息，需在Web App中添加以下应用设置：

1. 获取应用注册的ID和密钥：
   • 若Azure Bot创建时自动生成了应用注册，直接进入Azure「应用注册」服务找到对应条目；
   • 若Azure Bot的「管理密码」按钮提示权限不足（疑似平台BUG），直接在应用注册页面生成新的客户端密钥（务必记录密钥值，仅显示一次）；
2. 进入Web App的「配置 > 应用设置」，添加两个关键配置：
   • MicrosoftAppId：值为应用注册的「应用程序(客户端) ID」
   • MicrosoftAppPassword：值为刚生成的客户端密钥

4. 部署机器人代码 #

通过GitHub Actions、Azure CLI或本地发布工具，将本地已在Bot Framework Emulator测试通过的代码部署到目标App Service。

5. 测试与排错 #

• 打开Azure Bot的「Web聊天」通道发送消息测试；
• 若出现错误，查看Web App的「日志流」或「控制台日志」定位问题：
  • 报错Error: Unauthorized. Invalid AppId passed on token：检查MicrosoftAppId是否与应用注册ID完全一致；
  • 报错The clientSecret parameter is required：确认已正确配置MicrosoftAppPassword且密钥值无误。

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