Many organisations want to have an in-depth look at the usage (number of calls, who called whom, which modalities were used, etc.) and performance (packet loss, latency, etc.) of their unified communications.
A little history
In Skype for Business Serverwe could get all the data in the SQL back-end CDR/QoE databases and later in its lifecycle we had the ability to leverage the SDN API to get detailed information about the session. Also, many third party vendors, have created products that collect, sort and interpret this data into useful and actionable information for customers.
In Skype for Business Online, there is only limited access via a Get-CsUserSession Powershell command (now deprecated, see below), but it was difficult to obtain information on a large scale.
Call Records API is now GA
Now, for Microsoft Teams and Skype for Business Online, there is the Call Records API. A Webhook Graph API that will give access to this information.
In March, this public preview came in and was accessible via the Graph API/beta, but is now in Graph v1.0.
There are 2 versions of the Microsoft Graph REST APIs - v1.0 and beta. The sub/beta versions of the APIs have a preview status and are subject to change and may break existing scenarios without notice. Microsoft recommends that you do not take a production dependency on the APIs in the beta endpoint. API sets on the v1.0 endpoint ( https://graph.microsoft.com/v1.0) are in a "GA" status.
Call recordings provide usage and diagnostic information about calls and online meetings that occur within your organization when using Microsoft Teams or Skype for Business. Usage and diagnostic data can be consumed and reported to help monitor adoption or resolve call quality issues.
Organisations can subscribe to changes in call records using the Microsoft Graph webhook subscription feature, allowing them to create near real-time reports from the data or alert on specific scenarios such as emergency calls.
Now that the Call Records API is GA, you can expect to see reporting products from various Microsoft partners collecting and reporting on this data.
You can find more details on the Call Recording API in the Microsoft documentation here
The API offers the following resources:
CallRecord
represents a single peer-to-peer call or a group call between several participants
Session
A peer-to-peer call contains a single session between the two participants in the call. Group calls contain one or more session entities. In a group call, each session is between the participant and a service termination point.
Segment
A segment represents a multimedia link between two end points.
Obsolescence of Get-CsUserSession from 30 May 2020
Using the Get-CsUserSession was a PowerShell command to retrieve user session information for Skype Business Online. On 7 May, Microsoft updated the online documentation to indicate that it is deprecated and to switch to using the new call recording API.
We share your challenges, we accompany your changes
If you have a question or a suggestion, we are at your disposal to answer it by email or by phone.
