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

Question

我有一个用例，我需要在我的个人应用程序中显示以下信息。

1. 安装机器人的团队中的频道列表。
2. 安装了 bot 的团队中的用户列表。

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

   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 。 我通过选择“添加”选项来安装我的机器人应用程序，如下所示。

据我了解，以上将机器人安装在用户的个人范围内。 现在，在这种情况下， conversationUpdate事件中根本不存在团队 ID 信息。 请注意，这是我第一次在团队中安装机器人，因此根据 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"
        }
    }
}

接下来，我还尝试使用“添加到团队”选项在团队范围内安装机器人。 在这种情况下，它会提示我选择要安装的频道，我在其中选择了general 。

现在，我得到球队的内线对象channelData在onConversationUpdate并且此流程运行完美。

{
    "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 添加个人范围（即如果我只将范围保留为team ），应用程序不会在应用程序内部向用户显示。 但是，如果我允许将范围扩展到personal则用户可能会在安装应用程序时选择该范围，并且我的teamId信息将无法用于获取我需要的数据。

这使我的下一个问题，那就是，有没有在其中默认的任何add的按钮add app屏幕安装在这样的机器人，我得到team内部对象channelData ，在conversationUpdate在每一个场景，即无论我选择添加或添加到团队？

这是它应该如何表现还是我错过了什么。 很想听听对此的一些想法。 提前致谢。

Answer 1

可能是你想多了——这里有一个更简单的观点：

1. 如果您将机器人安装到Team 中，您将获得一个 Team Id（以及安装它的任何相关频道）。

2. 如果您为机器人设置了“个人”范围，那么用户还可以选择将机器人安装到“个人”范围中。 这意味着，他们没有将机器人安装到实际的团队中 - 这就是您没有收到团队 ID 的原因。 它没有坏掉 - 这是完全正确的。

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