卡片机器人无响应：Teams及Bot Emulator集成异常问题咨询

你提到基于BotBuilder-Samples的cards-Adaptivecards示例修改的机器人，硬编码appId和密码后，在Bot Framework Portal和Azure Bot Service里能正常回复，但Teams和Bot Emulator里完全没响应。结合你的场景，我整理了几个关键排查点：

• Bot Emulator连接配置校验
  先确认Emulator里的连接参数：端点要对应本地调试地址（默认是http://localhost:3978/api/messages，改了端口要同步），并且输入的Microsoft App ID和密码要和代码里硬编码的完全一致——尤其注意密码里的特殊字符（比如你用的|}_），复制时很容易漏输或错输。

• Teams渠道配置与网络可达性
  在Azure Bot Service的渠道管理页，确保Teams渠道已启用且配置正确。如果是本地调试，Teams无法直接访问本地服务，必须用ngrok这类工具把本地端口暴露为公网地址，再把这个公网地址设置为Bot的消息端点（格式如https://xxxx.ngrok.io/api/messages）。另外，添加机器人到Teams时，要通过Azure里的「添加到Teams」按钮或者直接输入appId邀请，避免权限拦截。

• 代码中Connector的兼容性问题
  你用的builder.ChatConnector是BotBuilder v3的API，如果你的示例是基于v4版本，这个API已经被BotFrameworkAdapter替代，硬编码的写法也会有差异。比如v4的正确初始化方式是：

  const { BotFrameworkAdapter } = require('botbuilder');
  const adapter = new BotFrameworkAdapter({
      appId: "628d8adc-3196-405d-87f6-d94ebfd3c511",
      appPassword: "gqihkQISB5~crWKP5463|}_"
  });
  

  API版本不匹配会直接导致机器人无法接收消息，这是很常见的坑。

• 本地调试的日志与错误排查
  启动机器人后，打开控制台看有没有报错信息——比如端口被占用、身份验证失败、请求无法解析等。如果用了ngrok，检查隧道是否处于活跃状态，访问ngrok的地址测试是否能正常返回（比如访问https://xxxx.ngrok.io/api/messages，应该返回405 Method Not Allowed，说明服务可达）。

• Azure AD身份验证权限校验
  确认Azure里对应appId的应用注册密码是否有效（没过期），并且应用注册是否有Teams相关的权限（比如ChannelMessage.Send、ChatMessage.Send等）。有时候即使appId和密码正确，权限缺失也会导致消息被拦截。

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