使用 RSC 通过 Microsoft Graph 访问聊天消息

Question

我正在构建一个 Teams 聊天机器人，它在与用户对话时查看当前 chat/channel 中的消息历史记录。

我的机器人已获得所需的所有 RSC（资源特定内容）权限（见下图）

清单的相关部分如下：

{
    "$schema": "https://developer.microsoft.com/en-us/json-schemas/teams/v1.11/MicrosoftTeams.schema.json",
    "version": "1.0.0",
    "manifestVersion": "1.11",
    "id": "bd33f8b1-b593-433c-926e-44a27c1bd94a",
    ...
    "permissions": [
        "identity",
        "messageTeamMembers"
    ],
    ...
    "bots": [
        {
            "botId": "e6d93739-a8ab-412d-a4f6-b6f514a3451a",
            "scopes": [
                "team",
                "personal",
                "groupchat"
              ],
            "isNotificationOnly": false,
            "supportsFiles": true
        }
    ],
    "validDomains": [],
    "webApplicationInfo": {
        "id": "e6d93739-a8ab-412d-a4f6-b6f514a3451a",
        "resource": "https://RscBasedStoreApp",
        "applicationPermissions": [
            "TeamSettings.Read.Group",
            "ChannelMessage.Read.Group",
            "TeamSettings.Edit.Group",
            "ChannelSettings.ReadWrite.Group",
            "Channel.Create.Group",
            "Channel.Delete.Group",
            "TeamsApp.Read.Group",
            "TeamsTab.Read.Group",
            "TeamsTab.Create.Group",
            "TeamsTab.ReadWrite.Group",
            "TeamsTab.Delete.Group",
            "Member.Read.Group",
            "Owner.Read.Group",
            "ChatSettings.Read.Chat",
            "ChatSettings.ReadWrite.Chat",
            "ChatMessage.Read.Chat",
            "ChatMember.Read.Chat",
            "Chat.Manage.Chat",
            "TeamsTab.Read.Chat",
            "TeamsTab.Create.Chat",
            "TeamsTab.Delete.Chat",
            "TeamsTab.ReadWrite.Chat",
            "TeamsAppInstallation.Read.Chat",
            "OnlineMeeting.ReadBasic.Chat",
            "Calls.AccessMedia.Chat",
            "Calls.JoinGroupCalls.Chat",
            "TeamsActivity.Send.Chat"
        ]
    }
}

注意：机器人有权阅读聊天和频道中的消息。具体来说，我的问题影响 chats 而不是 channels （我可以从 fine 获取消息）。

为了做到这一点，我获得了机器人帐户的 JWT 令牌，访问图表 API 如下所示：

GraphServiceClient<?> gsc = GraphServiceClient.builder()
            .authenticationProvider(u -> mac.getToken())
            .buildClient();

接下来，我将使用图表 API 来拉回这些消息。对于频道中的消息，我可以这样做：

gsc.teams("some group id")
            .channels("team id")
            .messages()
            .buildRequest(Collections.emptyList()).get()));

这很好用。

对于聊天，我正在做类似的事情：

gsc.chats("29:13qY8hmfkJinH9-v7rYKjCNFHYFJXKbjqR-NyzyKzL694npelHJoq5HrVtqJLRYo79OYeHGQq-bhtJM5N-yKXyQ")
.messages()
.buildRequest().get()));

然而，这次我从图表中得到一个错误API:

[Some information was truncated for brevity, enable debug logging for more details] com.microsoft.graph.http.GraphServiceException: Error code: Forbidden Error message: Invoked API requires Protected API access in application-only context when not using Resource Specific Consent. Visit https://docs.microsoft.com/en-us/graph/teams-protected-apis for more details.

GET https://graph.microsoft.com/v1.0/chats/29:13qY8hmfkJinH9-v7rYKjCNFHYFJXKbjqR-NyzyKzL694npelHJoq5HrVtqJLRYo79OYeHGQq-bhtJM5N-yKXyQ/messages SdkVersion : graph-java/v5.6.0

我无法解释为什么查询频道工作正常但查询聊天失败。

感谢任何帮助！

Answer 1

这是一个受保护的 API，要使用它，您首先需要向 Microsoft Graph 发出正式请求，请求获得在没有任何用户交互的情况下使用 API 的权限

这里是protected APIs. You need to fill this form获取所需权限的列表。

To request access to these protected APIs, complete the following request form. We review access requests every Wednesday and deploy approvals every Friday, except during major holiday weeks in the U.S. Submissions during those weeks will be processed the following non-holiday week.

另一种选择是使用委托流程。

使用 RSC 通过 Microsoft Graph 访问聊天消息

Using RSC To Access Chat Messages with Microsoft Graph

microsoft-teams

microsoft-graph-api