如何通过Calls Graph API在Teams通话间转移参会方

问题1：transferTarget参数设置 #

• 不需要设置为参会方C的信息，transferTarget要指向目标群组通话（通话1）——你的需求是把B转移到通话1这个群组会话里，而非转移给某个单独用户。
• 参数细节：
  • id：填写通话1的群组通话ID（可通过Graph API获取该通话的会话ID，格式类似a1b2c3d4-xxxx-xxxx-xxxx-xxxxxxxxx）
  • displayName：可填写通话1的自定义名称（比如"项目协作群通话"），留空也不影响转移逻辑

问题2：transferee参数设置 #

• transferee就是需要被转移的参会方B，两个ID的取值规则：
  • id：填写B的Azure AD用户对象ID（全局唯一的用户身份ID，不是Teams会话内的临时ID）
  • participantId：填写B在当前通话（通话2）中的参与者ID（这个是B加入通话2时生成的临时会话ID，可通过调用GET /communications/calls/{通话2ID}/participants接口，从返回的参与者列表中找到B对应的id字段值）

示例请求体 #

{
  "transferTarget": {
    "id": "<通话1的群组通话ID>",
    "displayName": "通话1的名称"
  },
  "transferee": {
    "id": "<参会方B的Azure AD用户ID>",
    "participantId": "<参会方B在通话2中的参与者ID>"
  },
  "transferType": "attended"
}

额外注意 #

• 调用Transfer接口时，接口路径要使用通话2的ID，即POST /communications/calls/{通话2ID}/transfer
• 确保BOT2已配置Calls.Initiate.All、Calls.AccessMedia.All等必要权限

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