使用Microsoft Graph API向Teams频道发消息遇权限错误求解决方案

你遇到的权限差异核心在于权限上下文不同：

• Graph Explorer使用的是用户委托权限（Delegated Permissions），只要拥有ChannelMessage.Send委托权限，就能直接向普通频道发送消息；
• 你的Postman/集成平台用的是应用权限（Application Permissions），这种权限模式下，默认仅允许向处于「迁移导入状态」的频道发送消息，用于历史消息批量导入场景，普通频道无法直接调用。

方案1：切换为用户委托权限调用（推荐，无需修改频道） #

如果你的场景允许以用户身份发起请求，直接改用委托权限模式：

1. 在Azure AD应用中添加Delegated类型的ChannelMessage.Send权限，完成管理员同意（若涉及全局范围）；
2. 获取令牌时使用授权码流程（Authorization Code Flow），需要用户登录授权，拿到的令牌代表用户身份，而非应用本身；
3. 用该用户令牌调用消息发送接口，即可和Graph Explorer一样正常发送消息。

方案2：应用权限配合频道导入状态（适合历史消息导入） #

若必须使用应用上下文，可将频道设置为导入状态：

1. 更新频道为迁移模式：

   PATCH /teams/{team-id}/channels/{channel-id}
   Content-Type: application/json
   
   {
     "settings": {
       "isInMigration": true
     }
   }
   

2. 发送消息时需指定历史消息的时间和发送者信息：

   POST /teams/{team-id}/channels/{channel-id}/messages
   Content-Type: application/json
   
   {
     "createdDateTime": "2023-12-05T10:00:00Z",
     "from": {
       "user": {
         "id": "目标用户ID",
         "displayName": "发送者名称"
       }
     },
     "body": {
       "content": "导入的消息内容"
     }
   }
   

3. 导入完成后，将isInMigration改回false恢复频道正常状态。

方案3：改用Teams机器人发送消息（通用实时推送场景） #

如果上述两种方案不适用，用Teams机器人是更灵活的选择：

1. 在Azure AD注册Teams机器人应用，获取App ID和密码；
2. 将机器人添加到目标Teams团队；
3. 用机器人令牌调用API发送消息：

   POST /v3/conversations/{对话ID}/activities
   Content-Type: application/json
   Authorization: Bearer {机器人令牌}
   
   {
     "type": "message",
     "text": "机器人推送的消息内容",
     "from": {
       "id": "{机器人App ID}"
     }
   }
   

   机器人发送消息不受Graph API的权限限制，适合实时消息推送场景。

内容的提问来源于stack exchange，提问作者Linda D'amario