Teams消息扩展查询功能在iOS新会话中无法正常工作

问题复现场景 #

开发的Teams消息扩展为query类型，启动时执行initialRun，未登录用户展示登录卡片：

• 已有聊天会话中打开扩展：正常触发后端请求，返回登录卡片
• iOS 17.3.1测试版Teams中，全新未交互会话内：提交搜索查询或initialRun都无法触发后端请求（无日志、适配器处理器未触发）
• Windows/Mac版Teams无此问题

关键配置（manifest.json） #

// composeExtensions数组内容
[{
  "id": "searchInput",
  "context": [
    "compose",
    "commandBox"
  ],
  "description": "Search for a place",
  "title": "My Places",
  "type": "query",
  "initialRun": true,
  "parameters": [
    {
      "name": "search",
      "title": "Search Place",
      "description": "Type to search a place",
      "inputType": "text"
    }
  ]
}]

修复方案与已知问题 #

• 优先升级iOS Teams客户端：iOS 17.3.1是测试系统版本，Teams客户端可能存在新会话下消息扩展初始化的兼容性bug，升级到最新正式版客户端大概率解决问题。
• 调整manifest配置：
  • 尝试移除context中的commandBox，仅保留compose：部分iOS客户端对多上下文的初始请求处理存在逻辑异常，单上下文配置可能绕过问题。
  • 临时关闭initialRun：将其设为false后手动提交查询，验证是否能触达后端。如果手动查询正常，说明是initialRun在新会话的触发逻辑存在异常，可改为用户主动操作后触发登录卡片逻辑。
• 补充会话初始化处理：
  • 在后端添加conversationUpdate事件处理器，确保新会话建立时后端能接收到初始化事件，提前完成会话上下文的初始化，避免后续消息扩展请求被拦截。
  • 检查机器人权限配置：确认iOS端新会话中，消息扩展具备发起请求的权限，部分平台在新会话中会限制未完成初始化的扩展请求。
• 官方问题追踪：该类iOS新会话下query扩展无请求的问题已在微软Teams开发者社区被上报，属于测试版客户端的已知问题，微软正在推进修复。

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