​

Microsoft Teams Dashboard Integration

​

Overview

The Microsoft Teams integration allows G360 to connect to your Microsoft Teams environment and collect Teams activity and organizational data for the Team Dashboard. To create a Team Dashboard connection, you must first configure a Microsoft Entra ID (Azure Active Directory) App Registration with the required Microsoft Graph permissions. You will then enter the App Registration credentials into G360:

• Tenant ID
• Client ID
• Client Secret

​

Prerequisites

Before creating a Microsoft Teams connection, make sure you have:

• Access to your organization’s Microsoft Entra ID environment.
• Permission to create or access App Registrations in Microsoft Entra ID.
• Permission to create Client Secrets.
• Permission to grant tenant-wide admin consent for Microsoft Graph permissions.
• Access to the Microsoft 365 Admin Center.
• A Microsoft Teams license with at least one active user.
• The required Microsoft Graph application permissions configured for the App Registration.

Important: Microsoft Teams reporting data may have a delay of approximately 24–48 hours. Newly configured reporting settings may also take time to take effect.

​

Prepare Microsoft Credentials

G360 authenticates with Microsoft Teams using a Microsoft Entra ID App Registration. Before creating the connection in G360, create or locate an App Registration and collect the following credentials:

• Tenant ID
• Client ID
• Client Secret

These values are entered into the G360 Team Dashboard connection form.

​

Sign In to Microsoft Entra ID

1. Open the Microsoft Entra admin center.
2. Sign in using an account with the required administrative permissions.
3. Open Microsoft Entra ID.
4. From the left navigation panel, select App registrations.

​

Create or Locate an App Registration

If your organization already has an App Registration configured for G360, you can use the existing App Registration. Otherwise:

1. From App registrations, select New registration.
2. Enter a descriptive name for the application. Example: G360 Teams Integration
3. Under Supported account types, select Accounts in this organizational directory only (Single tenant).
4. Select Register.

​

Copy the Tenant ID and Client ID

1. Open the App Registration.
2. On the Overview page, locate Directory (tenant) ID.
3. Copy the Tenant ID.
4. Locate Application (client) ID.
5. Copy the Client ID.

Keep these values available because you will enter them into the G360 connection form.

​

Generate a Client Secret

G360 uses a Client Secret to authenticate with Microsoft Entra ID. To create a Client Secret:

1. Open the App Registration.
2. From the left navigation panel, select Certificates & secrets.
3. Under Client secrets, select New client secret.
4. Enter a description for the secret.
5. Select an appropriate expiration period.
6. Select Add.
7. Copy the Value of the newly created secret.

Important: Copy the Value of the Client Secret, not the Secret ID. Microsoft displays the secret value only when it is created. Store it securely before leaving the page.

​

Configure Microsoft Graph Permissions

The App Registration requires Microsoft Graph application permissions to access the data used by the Team Dashboard. To add permissions:

1. Open the App Registration in Microsoft Entra ID.
2. Select API permissions.
3. Select Add a permission.
4. Select Microsoft Graph.
5. Select Application permissions.
6. Add the required permissions described below.

​

Required Permissions

The following permissions are the minimum permissions required for the Team Dashboard integration:

​

Enhanced Permissions

Additional permissions can be granted to enable enhanced Teams analytics and additional data sources.

Note: Enhanced permissions are not part of the minimum connection requirement. Grant additional permissions only when the corresponding Team Dashboard features are required by your organization.

​

Grant Admin Consent

After adding the required permissions:

1. Return to API permissions for the App Registration.
2. Review the permissions listed under Microsoft Graph.
3. Select Grant admin consent for [Your Organization].
4. Confirm the consent request.
5. Verify that the permissions show as granted.

Important: Admin consent is required for the Microsoft Graph application permissions used by the Team Dashboard. Without the required consent, the connection may fail when it is tested.

​

Configure Microsoft 365 Reporting

Microsoft 365 reporting settings must be configured so that G360 can access identifiable user and group information in Teams reports.

1. Open the Microsoft 365 Admin Center.
2. Navigate to Settings → Org Settings.
3. Open Reports.
4. Locate the setting: Display concealed user, group, and site names in all reports
5. Disable this setting.
6. Save the configuration if prompted.

Important: If this setting remains enabled, Microsoft 365 reports may conceal user, group, and site names. This can prevent G360 from associating reporting data with the corresponding users and teams.

​

Create a Team Dashboard Connection

After preparing the Microsoft credentials and Microsoft 365 environment:

1. Log in to G360.
2. From the left navigation panel, select Integration.
3. Select Team-dashboard Connections.
4. Select Add Connection.
5. The Manage Connections: Team Dashboard dialog appears.

​

Connection Fields

​

Connection Name

Enter a unique and descriptive name for the connection. Example: Production Teams Use a name that makes it easy for administrators to identify the Microsoft Teams environment associated with the connection.

​

Tenant ID

Enter the Directory (tenant) ID copied from the Microsoft Entra App Registration. Example: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx The Tenant ID identifies the Microsoft Entra tenant associated with your organization.

​

Client ID

Enter the Application (client) ID copied from the Microsoft Entra App Registration. Example: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx The Client ID identifies the App Registration that G360 uses to authenticate with Microsoft Teams.

​

Client Secret

Enter the Client Secret Value generated under Certificates & secrets in the Microsoft Entra App Registration. The value is masked in the G360 connection form for security.

Important: If the Client Secret has expired or is no longer available, create a new Client Secret in Microsoft Entra ID and update the G360 connection.

​

Active

Use the Active toggle to enable or disable the connection.

• Enabled — The Team Dashboard connection is active and can be used for synchronization.
• Disabled — The connection remains configured but synchronization is disabled.

​

Test the Connection

After entering the connection details:

1. Verify the Tenant ID is correct.
2. Verify the Client ID is correct.
3. Verify the Client Secret is correct.
4. Confirm that the required Microsoft Graph permissions have been granted.
5. Confirm that admin consent has been granted.
6. Select Test Connection.

G360 tests the credentials and permissions configured for the Microsoft Teams connection.

​

Successful Connection

If the test succeeds, the Microsoft credentials and required permissions are valid and the connection is ready to be saved. Select Save Connection to create the connection.

​

Failed Connection

If the test fails, verify:

• The Tenant ID is correct.
• The Client ID is correct.
• The Client Secret Value is correct.
• The Client Secret has not expired.
• The App Registration still exists and is enabled.
• Reports.Read.All has been granted.
• User.Read.All has been granted.
• Organization.Read.All has been granted.
• Admin consent has been granted.
• The Microsoft 365 reporting configuration has been updated as described above.

​

Save the Connection

After the connection passes Test Connection:

1. Select Save Connection.
2. The connection is added to the Team-dashboard Connections page.
3. If Active is enabled, G360 can synchronize data from the configured Microsoft Teams environment.

​

Edit an Existing Connection

To edit an existing Team Dashboard connection:

1. Navigate to Integration → Team-dashboard Connections.
2. Locate the connection you want to modify.
3. Select the Edit icon under Actions.
4. Update the required fields.
5. Select Test Connection.
6. After the test succeeds, select Save Connection.

Note: If you update the Client Secret, use the new Value generated in Microsoft Entra ID.

​

Disable a Connection

To temporarily stop synchronization without deleting the connection:

1. Navigate to Integration → Team-dashboard Connections.
2. Locate the connection.
3. Select the Edit icon.
4. Turn the Active toggle off.
5. Save the updated connection.

The connection remains configured in G360 but is no longer active.

​

Delete a Connection

Before deleting a Team Dashboard connection, make sure the following conditions are met:

• The connection is disabled.
• No synchronization is currently running.
• Any synchronized data associated with the connection has been removed, if required.

Important: A connection must be turned off before it can be deleted. Make sure that no synchronization is in progress and remove any synchronized data before attempting to delete the connection.

To delete a Team Dashboard connection:

1. Navigate to Integration → Team-dashboard Connections.
2. Locate the connection you want to delete.
3. Disable the connection using the Active toggle.
4. Confirm that no synchronization is currently running.
5. Remove any synchronized data associated with the connection, if required.
6. Select the Delete icon under Actions.
7. Confirm the deletion.

Deleting the connection removes the configured Microsoft Teams integration from G360 and prevents future synchronization using that connection.

​

Connection Status

The Active setting indicates whether the Team Dashboard connection is enabled.

​

Active

The connection is enabled and available for synchronization.

​

Inactive

The connection remains configured but is disabled. No new data is synchronized while the connection is inactive.

​

Data Availability

Microsoft Teams reporting data is not always available immediately. Microsoft’s reporting APIs can have a reporting delay of approximately 24–48 hours. This means that newly generated Teams activity may not appear in G360 immediately.

Note: If a connection is working correctly but recent Teams activity is not visible, allow time for Microsoft 365 reporting data to become available before troubleshooting the connection.

​

Troubleshooting

​

Test Connection Failed

Check the following:

• Verify the Tenant ID.
• Verify the Client ID.
• Verify the Client Secret Value.
• Make sure the Client Secret has not expired.
• Confirm that the App Registration exists and is enabled.
• Confirm that Reports.Read.All has been granted.
• Confirm that User.Read.All has been granted.
• Confirm that Organization.Read.All has been granted.
• Confirm that admin consent has been granted.
• Verify that the Microsoft 365 reporting configuration has been updated.

​

Insufficient Permissions

If the connection reports a permissions or scope error:

1. Open the Microsoft Entra App Registration.
2. Navigate to API permissions.
3. Verify that the required Microsoft Graph application permissions are present.
4. Confirm that admin consent has been granted.
5. Test the connection again.

​

Teams Data Is Not Appearing

If the connection succeeds but data is not appearing:

• Confirm that the connection is Active.
• Confirm that synchronization is running successfully.
• Verify that the required Microsoft Graph permissions have been granted.
• Confirm that Microsoft 365 reporting settings have been configured correctly.
• Allow for the Microsoft Teams reporting delay of approximately 24–48 hours.

​

User or Team Names Are Missing

If Teams reporting data is available but user, group, or site names are concealed:

1. Open the Microsoft 365 Admin Center.
2. Navigate to Settings → Org Settings → Reports.
3. Check the Display concealed user, group, and site names in all reports setting.
4. Make sure the setting is disabled.
5. Allow time for the updated reporting configuration to take effect.

​

Client Secret Has Expired

If authentication fails because the Client Secret has expired:

1. Open the Microsoft Entra App Registration.
2. Navigate to Certificates & secrets.
3. Create a new Client Secret.
4. Copy the Value of the new secret.
5. Open the corresponding Team Dashboard connection in G360.
6. Replace the existing Client Secret.
7. Select Test Connection.
8. Select Save Connection after the test succeeds.

​

Best Practices

To maintain a secure and reliable Microsoft Teams integration:

• Use a dedicated Microsoft Entra App Registration for the G360 integration.
• Grant only the Microsoft Graph permissions required by your organization’s Team Dashboard features.
• Treat Client Secrets as sensitive credentials.
• Store Client Secrets securely.
• Monitor Client Secret expiration dates and rotate secrets before they expire.
• Use descriptive connection names that identify the Teams environment.
• Test the connection after creating or updating credentials.
• Keep the connection disabled when it is not required.
• Review Microsoft Graph permissions periodically and remove permissions that are no longer needed.