Getting Started with UC&C
Use the UC&C - Unified Communications & Collaboration module to view information about your end-users' use of unified communications and collaboration (UC&C or UCC) tools such as Microsoft Teams, and Zoom.
UC&C Data Collection
The Unified Communications & Collaboration Module collects data from two sources:
- The Microsoft Graph API
- The Edge DX agent installed on your Windows (currently available) or Mac (coming soon!) device.
In order to use the Edge DX UCC module, the following initial setup is required:
- Connect to the Microsoft Graph API to access Teams data.
- Configure the UCC module in Edge DX.
- Set up your Windows device.
Detailed instructions for the initial setup are provided below.
Connect to the Microsoft Graph API for Teams Data
To connect the UCC module to your Microsoft Teams account, perform the following steps:
- Log in to Azure with your Azure credentials at https://portal.azure.com/, or https://azure.microsoft.com/en-us/services/active-directory.
- Click Azure Active Directory.
The Azure Active Directory Overview screen is displayed.
3. Click App registrations in the navigation menu on the left side of your screen.
The App registrations screen is displayed.
- Click New registration. The Register an application screen is displayed.
- On the Register an application screen, perform the following steps:
a. Give the the application a name, which serves for your reference only.
b. In the Supported account types section, leave the default 'Accounts in this organizational directory only' option selected.
c. Click Register. The application screen is displayed.
- Click Certificates & secrets in the navigation menu on the left side of the application screen. The Certificates & secrets screen is displayed.
- Click New client secret on the Certificates & secrets screen. The Add a client secret dialog box is displayed.
In the Add a client secret dialog box, perform the following steps:
a. Enter a description for the client secret.
b. Select a time period after which the the client secret is scheduled to expire. (The default time period is 6 months, however a 12-month period or longer is recommended to reduce the frequency of performing this process.)
c. Click Add.
The Value code displayed is your Application Secret Value within Edge DX. Copy the Value code and keep it somewhere secure. This is very important. If you lose the Value code, it cannot be retrieved, and you will have to delete the secret and restart the process.
- Click Overview in the navigation menu on the left side of the screen.
The Essentials of the application you created are displayed.
- The displayed Application (client) ID code is your Application ID within Edge DX. The displayed Directory (tenant) ID code is your Tenant ID within Edge DX. As mentioned above for the Value code, it is very important to copy the Application (client) ID code and the Directory (tenant) ID code and to keep them somewhere secure.
- To give your application permissions to access information about Teams calls, perform the following steps:
a. Click API permissions in the navigation menu.
b. Click Add a permission. The Request API permissions screen is displayed.
c. Click Microsoft Graph. The Microsoft Graph screen is displayed.
d. Click Application Permissions.
e. In the search box, type 'Call Records'.
f. Click the search result Call Records to expand it.
g. Click the checkbox for the permission Call Records.Read.All.
h. Click Add Permissions or Update Permissions.
The application permission you added requires approval by an Azure Active Directory global administrator.
The global administrator opens the application registration, accesses the API permissions and applies admin consent for the requested permissions.
Once the global administrator has granted approval for the application permission, you can refresh the API permissions page and see that the Status of the permission is Granted.
Configure the UCC Module in Edge DX
To configure the UCC module in Edge DX, perform the following steps:
- In Edge DX, click Configuration > Settings.
- Click Unified Communications.
- Provide the Tenant ID, Application ID and Application Secret Value codes from the configuration in Azure, described above: Connect to the Microsoft Graph API for Teams Data.
- Click Configure / Reconfigure.
Set Up Your Windows Device
The Edge DX agent installed on your Windows device can collect minute-by-minute data about UCC connections and performance.
To collect UCC data using the Edge DX Windows agent, download/ upgrade your Edge DX Windows agent to version 2.11 Beta 4.