Microsoft Botframework Messenger渠道开发模式无法正常工作排查

我帮你梳理几个开发模式下Bot无法工作的常见排查点，都是实际配置时容易踩的坑：

• 确认Facebook应用角色权限：
  别混淆页面角色和应用角色！哪怕你是Facebook页面的管理员，也得确保你的账号在Facebook开发者后台的应用角色列表里（路径：应用→角色→管理员/开发者/测试人员）。如果是刚添加的账号，记得要接受邀请，不然开发模式下的API权限还是不会对你开放。

• 验证Webhook的配置完整性：
  回到BotFramework的Messenger渠道配置页，先确认Webhook的验证状态是「已验证」。然后检查订阅字段，必须勾选messages和messaging_postbacks这两个核心字段——要是漏了，Bot根本收不到用户的消息触发。另外，确保Webhook的URL是BotFramework自动生成的那个，别手动修改过。

• 升级Facebook API版本：
  你当前用的API v2.12实在太老旧了，这个版本的很多接口已经被Facebook废弃，BotFramework对旧版本的兼容性也很差。建议在Facebook开发者后台把应用的API版本升级到稳定的新版本（比如v17.0），保存后重新同步Messenger渠道的配置，再重启Bot服务试试。

• 检查页面关联和Messenger开关：
  进入你的Facebook页面设置→Messenger平台，确认已经正确关联了你的Bot应用，并且「接收消息」的开关是打开状态。同时，确认页面右上角的「开发模式」开关是启用的——要是不小心关掉，就只有已发布的Bot能正常工作了。

• 查看BotFramework的日志定位问题：
  登录Azure门户找到你的Bot资源，进入「监控」→「日志」，搜索相关的错误日志。比如有没有收到Facebook的Webhook请求？有没有发送消息失败的报错？这些日志能直接帮你定位是Webhook不通、权限不足还是API调用失败的问题。

• 用Facebook测试工具验证流程：
  在Facebook开发者后台的Messenger→测试器里，选择你的页面和测试账号发送消息，然后同步查看BotFramework的日志。如果日志里没收到请求，说明Webhook配置有问题；如果收到了但没回复，可能是Bot的业务逻辑或者权限配置出了问题。

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