Teams数据统计聊天消息

前两篇文章介绍了如何对用户的在线状态和通话记录进行数据统计。这篇文章我们来看看如何统计用户的聊天消息。

在介绍具体 api 如何调用前，我们可以先看一下 Teams 里对于 Message 的层级结构，在 Teams 里，message有两种，一种是 Team 的 Channel 的 message，一种是对一对聊天或者群聊里的 message。他们的层级设计是不同的。

Channel 里的消息

它的层次结构如下：

Team -> Channel -> Message -> Reply 一个 tenant 里有多个 Team，每个 Team 里可以有多个 Channel，每个 Channel 里有多个 Message，每个 Message 可以有 0 到 n 个 reply消息。

所以我们使用 graph api 来获取信息的时候，我们先获取 teams 列表，因为 graph api目前没有一个简单的获取 team 列表的接口，所以必须要用下面这个获取 group 列表的接口，再加上 filter。这是一个已知的问题，希望以后能被fix掉。

GET /groups?$filter=resourceProvisioningOptions/Any(x:x eq 'Team')


Response:
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#groups",
"value": [
{
"id": "02bd9fd6-8f93-4758-87c3-1fb73740a315",
"displayName": "HR Taskforce",
"visibility": "Private"
...
},
...
]
}


我们有了 team 列表后就可以开始获取每个 team 的 channel。使用如下接口：

GET https://graph.microsoft.com/beta/teams/{team-id}/channels


Response:
{
"value": [
{
"description": "description-value",
"displayName": "display-name-value",
"id": "02bd9fd6-1111-4758-87c3-1fb73740a315",
....
},
...
]
}


有了 channel 后，我们就可以获取 channel 里的 message 列表。

GET https://graph.microsoft.com/beta/teams/{team-id}/channels/{channel-id}/messages


Response:
{
"value": [
{
"id": "1555375673184",
"messageType": "message",
"createdDateTime": "2019-04-16T00:47:53.184Z",
"lastModifiedDateTime": "2019-05-04T19:58:15.511Z",
"lastEditedDateTime": null,
"deletedDateTime": null,
"subject": "",
"summary": null,
"importance": "normal",
"locale": "en-us",
"from": {
"user": {
"id": "bb8775a4-4d8c-42cf-a1d4-4d58c2bb668f",
"displayName": "Adele Vance",
"userIdentityType": "aadUser"
}
},
"body": {
"contentType": "html",
"content": "

大家可以发现上面有用的信息非常多，比如：

• createdDateTime, lastModifiedDateTime, lastEditedDateTime 和 deletedDateTime，各种时间
• from：message是谁发的
• mentions：消息里有没有 @ 其他人
• reactions：消息有没有被点赞，谁在什么时候点了赞或者点了什么其他表情

由于一个channel里的 message 会很多，所以 graph api 还有一个分批获取 message 的接口，如果对这个接口感兴趣，可以参考这个文档：https://docs.microsoft.com/en-us/graph/api/chatmessage-delta?view=graph-rest-beta&tabs=http

GET /teams/{team-id}/channels/{channel-id}/messages/delta


有了 message 后就可以获取每个 message 的replies 了。

GET /teams/{team-id}/channels/{channel-id}/messages/{message-id}/replies


对一对聊天或者群聊里的 message

它的层次结构比较简单，如下：