Microsoft Teams中Bot Framework应用安装后获取团队用户及主动消息问题

让我一步步帮你解决这两个问题，结合Laravel开发的场景来梳理：

要实现这个需求，关键在于捕获应用安装到团队的事件，再通过Graph API拉取团队成员，具体操作如下：

• 第一步：配置必要的Azure AD权限
  先确保你的Bot应用在Azure AD中申请了这两个应用权限（必须是应用权限，因为需要后台主动调用，不能用委托权限）：
  • Team.ReadBasic.All：允许读取团队的基本信息
  • User.Read.All：允许读取组织内的用户信息
    权限审批通过后，保存好应用的客户端ID、客户端密钥和租户ID，后续调用Graph API会用到这些凭证。
• 第二步：捕获团队安装事件
  当应用被安装到Teams团队时，Teams会向你的Bot端点发送conversationUpdate事件。在Laravel里，你需要创建一个POST路由来接收这个请求，而且必须处理Teams的请求签名验证——不然Teams会认为你的端点不安全，停止发送事件。
  从事件的payload里，你可以拿到channelData.team.id（目标团队的ID）和conversation.id（会话ID），把这些信息存到数据库里，后面调用API要用。
• 第三步：调用Graph API获取团队用户
  用Laravel内置的HTTP客户端或者Guzzle来调用Graph API就行，示例代码如下：

  use Illuminate\Support\Facades\Http;
  
  $teamId = '从安装事件中获取的团队ID';
  $token = $this->getGraphAccessToken(); // 自己实现获取Graph API令牌的逻辑
  
  $response = Http::withToken($token)
      ->get("https://graph.microsoft.com/v1.0/teams/{$teamId}/members");
  
  if ($response->successful()) {
      $teamMembers = $response->json()['value'];
      // 这里可以提取用户ID、姓名等信息，按需处理
  }
  

  其中getGraphAccessToken方法需要用客户端ID、密钥和租户ID，向https://login.microsoftonline.com/{你的租户ID}/oauth2/v2.0/token请求获取访问令牌。

你说能接收回复但收不到安装事件，还没法主动发消息，大概率是这几个原因：

• 问题1：安装方式不对，没触发团队安装事件
  你用的https://teams.microsoft.com/l/chat/0/0?users=...是个人聊天安装链接，这种方式是把应用装到个人会话里，不是团队中，所以不会触发团队相关的conversationUpdate事件。如果要获取团队用户，必须把应用安装到团队里——可以通过Teams团队的「添加应用」功能，或者生成团队专属的安装链接（用Azure AD的应用安装配置，指定团队范围）。
• 问题2：没正确处理Teams的事件请求签名
  Teams发送的所有事件请求都带签名验证，你的Laravel端点必须验证Authorization头和X-Ms-Signature，确保请求来自Teams。可以参考Bot Framework官方的签名验证逻辑来实现这个校验，不然会收不到有效事件。
• 问题3：主动发消息缺少会话参考信息
  要主动发消息，你得先保存安装时拿到的Conversation Reference（包含serviceUrl、conversationId、channelId这些关键信息），然后用Bot Framework的API发送，示例代码：

  $conversationReference = [
      'serviceUrl' => '从安装事件中获取的serviceUrl', // 比如https://smba.trafficmanager.net/amer/
      'conversation' => [
          'id' => '从安装事件中获取的会话ID'
      ],
      'bot' => [
          'id' => '你的Bot ID'
      ]
  ];
  
  $token = $this->getBotAccessToken(); // 获取Bot Framework的访问令牌
  
  Http::withToken($token)
      ->post("{$conversationReference['serviceUrl']}/v3/conversations/{$conversationReference['conversation']['id']}/activities", [
          'type' => 'message',
          'text' => '这是一条主动发送的测试消息',
          'recipient' => [
              'id' => '目标用户ID' // 如果发团队消息，这里填团队ID即可
          ]
      ]);
  

  注意，Bot Framework的访问令牌是从https://login.microsoftonline.com/botframework.com/oauth2/v2.0/token获取的，和Graph API的令牌不是一回事，别搞混了。

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