Skip to main content

MS Teams Integration & Admin Permission for Delenta 2.0

Written by Namrata Raghunath

When integrating MS Teams with Delenta, coaches or users may encounter a persistent prompt requesting administrator permission. This happens because standard admin consent does not automatically grant the required permissions for tracking online meetings and fetching transcripts.

Follow this step-by-step guide to properly configure admin consent and enable necessary API access within your Microsoft tenant.

Prerequisites

To complete this process, you must have:

  • Global Admin or Privileged Role Administrator access to your organization's Microsoft Entra ID (Azure AD) portal.

  • Access to the Microsoft Teams Admin Center.

CRITICAL NOTE: Do not create a new App Registration. Delenta is a third-party multi-tenant application. The customer tenant only needs to grant admin consent to the existing Delenta.com Enterprise Application.

Step-by-Step Instructions

1. Retrieve Your Microsoft Tenant ID

  1. Log in to the Microsoft Entra ID Portal.

  2. Navigate to the Overview tab on the left-hand navigation menu.

  3. Locate the Tenant ID in the center of the screen (a long string of numbers and letters) and copy it.

  4. Insert your Tenant ID into the custom Admin Consent URL below, replacing <tenant-id> with the string you just copied:

https://login.microsoftonline.com/<tenant-id>/v2.0/adminconsent?client_id=e3c2e52a-c21e-4b35-b099-0ad373fda3f5&scope=https%3A%2F%2Fgraph.microsoft.com%2FUser.Read+https%3A%2F%2Fgraph.microsoft.com%2FOnlineMeetings.ReadWrite+https%3A%2F%2Fgraph.microsoft.com%2FOnlineMeetingTranscript.Read.All&redirect_uri=https%3A%2F%2Fapp.delenta.com%2Fcoach%2Fintegrations%2Fadd%2FmsTeams&state=delenta-ms-teams-admin-consent

2. Grant Admin Consent via the Custom URL

Important: If your Entra ID Permissions page only shows older permissions, do not rely on the generic "Grant admin consent" button inside the Azure/Entra portal. You must use the custom URL generated in Step 1 so Microsoft explicitly requests the newer Teams transcript scopes.

  1. Copy and paste your completed custom Admin Consent URL into a new tab in your web browser.

  2. When prompted, log in using your Microsoft Admin credentials.

  3. Review the requested permissions (which include profile access, online meeting creation, and transcript read access).

  4. Click Accept to grant organization-wide consent. This will automatically redirect you to a Delenta page.

  5. Go back to your Entra ID portal and navigate to Identity > Applications > Enterprise applications > Delenta.com > Permissions.

  6. Select the Admin consent tab and verify that the following Microsoft Graph delegated permissions are present:

These are the permissions you should be seeing for the account

  • User.Read: Allows sign-in and reading of the user's profile.

  • OnlineMeetings.ReadWrite: Allows creation and reading of online meetings for the signed-in user.

  • OnlineMeetingTranscript.Read.All: Allows reading of meeting transcripts. (This is the key permission that triggers the "Need admin approval" prompt).

  • Note: offline_access and openid may also appear natively as part of the standard authentication flow.

3. Enable Transcript API Access in Teams Admin Center

Microsoft requires tenant-wide Graph API transcript access to be explicitly turned on within the Teams settings for third-party integrations to fetch data.

  1. Log in to the Microsoft Teams Admin Center.

  2. On the left navigation menu, expand Meetings and select Meeting settings.

  3. Scroll down until you find the Transcript API access section.

  4. Toggle the setting to Enabled.

  5. Click on Configure API access, ensure Speaker Attribution is included, and save/confirm changes.

  6. Click Save at the bottom of the Meeting Settings page.

4. User Re-Integration

  1. Instruct the affected user (coach) to log out of their Delenta account completely.

  2. Have them log back in and navigate to their integration settings.

  3. Disconnect and then re-integrate their MS Teams account.

The integration will now successfully register with the updated permissions, concluding the setup process.

Troubleshooting & Notes

  • Permissions disappeared after refreshing? This happens if an admin accidentally clicks the native, older "Grant Access" or "Review Permissions" buttons in the standard Entra portal layout right after executing the URL setup. If permissions disappear, simply re-run Step 2 using your custom URL.

  • Template for Support: If you are generating this URL manually for your clients, always use the standard Microsoft admin consent endpoint template and replace the {tenant-id} placeholder with the client's distinct ID.

  • Reminder on App Registrations: Do not attempt to add API permissions under App registrations. You are granting consent to Delenta’s existing multi-tenant Enterprise Application/service principal already running inside your tenant ecosystem.

Related Articles
Did this answer your question?