当机器人安装在个人范围（MS Teams）中时如何获取团队 ID？

Question

我有一个用例需要在我的个人申请中显示以下信息。

安装机器人的团队中的频道列表。
安装机器人的团队中的用户列表。

我正在探索相同的连接器客户端并提出以下代码：-

   const credentials = new MicrosoftAppCredentials(appId, appPassword);
   const connectorClient = new ConnectorClient(credentials, {
        baseUri: serviceUrl
    });
   const token = await credentials.getToken();
   axios.defaults.headers.common.Authorization = `Bearer ${ token }`;

   # To get channels
   const response = await axios.get(
        'https://smba.trafficmanager.net/in/v3/teams/{teamId}/conversations'
    );

    # To get members
   const users = await connectorClient.conversations.getConversationPagedMembers(teamId);

只要我有 teamId，这就完美了。

但我在这里面临的问题是关于在个人范围内查找 teamId。我通过选择 Add 选项安装我的机器人应用程序。

据我了解，以上是在用户的个人范围内安装bot。现在，在这种情况下，团队 ID 信息根本不存在于 conversationUpdate 事件中。请注意，这是我第一次在团队中安装机器人，因此数据应该根据 Microsoft 文档提供，但通道对象中唯一可用的信息是租户。

{
    "membersAdded": [
        {
            "id": "28:f5d48856-5b42-41a0-8c3a-c5f944b679b0"
        }
    ],
    "type": "conversationUpdate",
    "timestamp": "2017-02-23T19:38:35.312Z",
    "localTimestamp": "2017-02-23T12:38:35.312-07:00",
    "id": "f:5f85c2ad",
    "channelId": "msteams",
    "serviceUrl": "https://smba.trafficmanager.net/amer-client-ss.msg/",
    "from": {
        "id": "29:1I9Is_Sx0OIy2rQ7Xz1lcaPKlO9eqmBRTBuW6XzkFtcjqxTjPaCMij8BVMdBcL9L_RwWNJyAHFQb0TRzXgyQvA"
    },
    "conversation": {
        "isGroup": true,
        "conversationType": "channel",
        "id": "19:efa9296d959346209fea44151c742e73@thread.skype"
    },
    "recipient": {
        "id": "28:f5d48856-5b42-41a0-8c3a-c5f944b679b0",
        "name": "SongsuggesterBot"
    },
    "channelData": {
        // for me this object is empty
        "team": {
            "id": "19:efa9296d959346209fea44151c742e73@thread.skype"
        },
        "eventType": "teamMemberAdded",
        "tenant": {
            "id": "72f988bf-86f1-41af-91ab-2d7cd011db47"
        }
    }
}

接下来，我还尝试使用 Add To Teams 选项在团队范围内安装机器人。在这种情况下，它会提示我 select 一个要安装的频道，我在其中选择 general.

现在，我确实在 onConversationUpdate 中得到了 channelData 中的团队对象，这个流程工作得很好。

{
    "membersAdded": [
        {
            "id": "28:64564f44-dd7c-441a-b427-efcd662f21b5"
        }
    ],
    "type": "conversationUpdate",
    "timestamp": "2021-10-14T13:22:01.6072361Z",
    "id": "f:4ebc9a41-5140-7621-33f5-31d97275ce00",
    "channelId": "msteams",
    "serviceUrl": "https://smba.trafficmanager.net/in/",
    "from": {
        "id": "29:17ZGff4Pvqz_zSNqEexg-86uBFcB6vnOBZzCwu4_puGdDsrYWCW_DdlB15PrcjC--nLlqD5CwtLMJyzXPY5OSsg",
        "aadObjectId": "eac26e98-104a-4785-87aa-bcf77ea1d7c1"
    },
    "conversation": {
        "isGroup": true,
        "conversationType": "channel",
        "tenantId": "c8fef0de-e240-4456-b523-3285ecc62087",
        "id": "19:y7qDBfGH2jE_Ze6G8mJS_CiWiqCaRFfH77jFZvJ1xgU1@thread.tacv2"
    },
    "recipient": {
        "id": "28:64564f44-dd7c-441a-b427-efcd662f21b5",
        "name": "Trick"
    },
    "channelData": {
        "team": {
            "aadGroupId": "5bc77aa9-9487-49ae-958f-b37b2191e64d",
            "name": "test 5",
            "id": "19:y7qDBfGH2jE_Ze6G8mJS_CiWiqCaRFfH77jFZvJ1xgU1@thread.tacv2"
        },
        "eventType": "teamMemberAdded",
        "tenant": {
            "id": "c8fef0de-e240-4456-b523-3285ecc62087"
        }
    }
}

所以我想在这里了解的是，如果 bot 安装在个人范围内，为什么没有信息？

我问这个主要是因为没有为 bot 添加个人范围（即，如果我只将范围保持为 team），应用程序不会在 Apps 中向用户显示。但是，如果我允许范围扩展到 personal，用户可能 select 在安装应用程序时，我的 teamId 信息将无法用于获取我需要的数据。

这引出了我的下一个问题，即 add app 屏幕上的默认 add 按钮是否可以通过某种方式安装机器人，使我得到 team object inside channelData, in conversationUpdate 在每个场景中，即我是选择添加还是添加到团队？

这是它应有的行为方式还是我遗漏了什么。很想听听对此的一些想法。提前致谢。

Answer 1

您可能想多了 - 这里有一个更简单的观点：

如果您将 bot 安装到 Team，您将获得一个 Team Id（以及安装它的任何相关频道）。
如果您为机器人设置了“个人”范围，则用户也可以选择将机器人安装到“个人”范围。正如这暗示的那样，他们没有将机器人安装到实际的团队中——这就是您没有收到团队 ID 的原因。它没有损坏 - 它完全正确。

如果您不希望您的机器人能够安装在个人范围内，只需在您的清单（“个人”范围）中删除该选项 - 您有选择的能力，因为它取决于您希望用户能够使用您的机器人做什么。有些机器人只在团队内部有意义，有些只在个人范围内，有些只在群聊或会议中 - 你可以允许你的机器人安装在 any/all 这些是相关的。

当机器人安装在个人范围（MS Teams）中时如何获取团队 ID？

How to get team id when the bot is installed in personal scope(MS Teams)?

botframework

microsoft-teams