Teams数据统计 - 通话记录
上篇文章介绍了如何获取用户的在线状态，这篇文章我们记录介绍如何统计用户通话记录。
首先，Teams为了安全，它要求 app 要有 CallRecords.Read.All 权限。然后就可以通过这个api来获取 call record。
GET /communications/callRecords/{id}
这个接口会返回类似如下的数据：
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#communications/callRecords/$entity",
"version": 1,
"type": "groupCall",
"modalities": [
"audio"
],
"lastModifiedDateTime": "2020-12-25T19:00:24.582757Z",
"startDateTime": "2020-12-25T18:52:21.321Z",
"endDateTime": "2020-12-25T19:52:46.123Z",
"id": "e523d2ed-1111-4b6b-925b-754a88034cc5",
"organizer": {
"user": {
"id": "821809f5-0000-0000-0000-3b5136c0e777",
"displayName": "Abbie Wilkins",
"tenantId": "dc368399-474c-4d40-900c-6265431fd81f"
}
},
"participants": [
{
"user": {
"id": "821809f5-0000-0000-0000-3b5136c0e777",
"displayName": "Abbie Wilkins",
"tenantId": "dc368399-474c-4d40-900c-6265431fd81f"
}
},
...
]
}
可以看到，我们能通过 organizer 和 participants 来找到参与这个通过的参与人，我们可以记录下用户的 user id，同时我们还可以通过 startDateTime 和 endDateTime 来取得这次 call 的开始和结束时间。
实际上 Teams 里的 call record 比我们想象的复杂很多，一个call里可能有多个 session 组成，我们用一张官方的数据模型图看一下。
我们可以给上面这个 api 加上参数来获取 session。
GET https://graph.microsoft.com/beta/communications/callRecords/{id}?$expand=sessions
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#communications/callRecords(sessions(segments()))/$entity",
"startDateTime": "2020-02-25T18:52:21.2169889Z",
"endDateTime": "2020-02-25T18:52:46.7640013Z",
"organizer": { ... },
"participants": [ ... ],
"sessions": [
{
"modalities": [
"audio"
],
"startDateTime": "2020-02-25T18:52:21.2169889Z",
"endDateTime": "2020-02-25T18:52:46.7640013Z",
"id": "e523d2ed-2966-4b6b-925b-754a88034cc5",
"caller": {
"@odata.type": "#microsoft.graph.callRecords.participantEndpoint",
"userAgent": {
"@odata.type": "#microsoft.graph.callRecords.clientUserAgent",
"headerValue": "RTCC/7.0.0.0 UCWA/7.0.0.0 AndroidLync/6.25.0.27 (SM-G930U Android 8.0.0)",
"platform": "android",
"productFamily": "skypeForBusiness"
},
"identity": {
"@odata.type": "#microsoft.graph.identitySet",
"user": {
"id": "821809f5-0000-0000-0000-3b5136c0e777",
"displayName": "Abbie Wilkins",
"tenantId": "dc368399-474c-4d40-900c-6265431fd81f"
}
}
},
"callee": {
"@odata.type": "#microsoft.graph.callRecords.participantEndpoint",
"userAgent": {
"@odata.type": "#microsoft.graph.callRecords.clientUserAgent",
"headerValue": "UCCAPI/16.0.12527.20122 OC/16.0.12527.20194 (Skype for Business)",
"platform": "windows",
"productFamily": "skypeForBusiness"
},
"identity": {
"user": {
"id": "f69e2c00-0000-0000-0000-185e5f5f5d8a",
"displayName": "Owen Franklin",
"tenantId": "dc368399-474c-4d40-900c-6265431fd81f"
}
},
"feedback": {
"rating": "poor",
"tokens": {
"NoSound": false,
"OtherNoSound": false,
"Echo": false,
"Noisy": true,
"LowVolume": false,
"Stopped": false,
"DistortedSound": false,
"Interruptions": false
}
}
}
}
]
}
从上面返回的json可以看到，session里有 startDateTime 和 endDateTime。还有 caller 和 callee，我们用这些数据来进行进一步的深入统计，而且可以看到里面还有每个用户参与这个通话是使用的设备（userAgent.platform），更有意思的是，这里面还有 feedback，里面有这个用户这次通话中音质是好还是差，有没有噪音等等。有了这些信息，相信大家脑海里已经有了大量的可以统计的点了。
各位看到这里，可能会问，上面的接口是获取某一次 call record 的，那我如何获取所有的记录呢？
这里就需要用到 graph api 的订阅功能。
POST https://graph.microsoft.com/beta/subscriptions
{
"changeType": "created",
"notificationUrl": "https://<<your api url>>",
"resource": "/communications/callRecords",
"expirationDateTime":"2016-11-20T18:23:45.9356913Z",
"clientState": "secretClientValue",
"latestSupportedTlsVersion": "v1_2"
}
上面的 resource 是 /communications/callRecords，表明如果有任何一个call发生，graph api会回调我们的接口。上面的 "notificationUrl": "https://<<your api url>>" 是你的服务的回调 url，我们可以在这个接口里得到相应的 call record id，并且记录下来，等一段时间call 结束后，就可以获取整个call的信息了。