Get meeting transcripts and recordings using Graph APIs
You can now configure your app to fetch Microsoft Teams meeting transcripts and recordings in the post-meeting scenario. Your app can use Microsoft Graph REST APIs to access and fetch transcripts and recordings generated for a Teams meeting that has been scheduled beforehand.
Here are some use cases for fetching meeting transcripts and recordings using Graph API:
| Use case | How Transcript and Recording APIs help... |
|---|---|
| You need to obtain transcripts and recordings for capturing meaningful insights from multiple meetings across the Sales vertical. It's time-consuming and inefficient to keep track of all meetings, and to retrieve meeting transcripts and recordings manually. After the meeting is over, you'd need to examine conversations in all those meetings to obtain useful information. | Using Graph APIs in your app to fetch meeting transcripts and recordings automatically retrieves them from all meetings relevant for your purpose. Your app can receive meeting notifications, and get the transcript and recording when it's generated after the meeting ends. This data can then be used to gain: • Aggregated insights and intelligence analysis • New leads and highlights • Meeting follow-ups and summaries |
| As an HR initiative, you're holding a brainstorming session to understand and improve employee health and productivity. Having to continually take notes to provide post-meeting summary can impede the flow of thoughts, and you might not capture all valuable suggestions. After the session, you'd need to analyze the discussion to gather data points for planning improvements. | Using Graph APIs in your app to fetch transcripts and recordings post-meeting frees you and the participants to fully focus on the discussion. The content of the meeting transcript and recording is available for: • Engagement and sentiment analysis • Listing tasks or issues • Follow-up meetings and notifications |
| A salesperson at a leading tech company must connect with clients and close deals. With numerous meetings scheduled through Teams and Outlook calendar, it's crucial to attend all calls and stay updated on discussions and latest updates. | You can create an app with the following capabilities: • Notify you when a meeting is scheduled using Teams or Outlook calendar. • Enable your app to set AutoRecording=true for these meetings. • Add a bot as a meeting participant to display a banner indicating that the meeting is being recorded and that the content will be used by your app for analysis. • Allow your app to access meeting recordings and transcripts. • Allow your app without requiring admin approval for the OnlineMeetingRecording.Read.All permissions, as obtaining admin approval for these permissions can be time consuming. Here's a sample app that showcases this use case scenario. |
You can fetch meeting transcript, recording, or both using Graph APIs.
Note
The APIs to fetch meeting transcript and recording content are metered APIs. For more information, see payment models for meeting APIs.
To fetch the transcript and recording for a particular meeting:
- Configure permissions on Microsoft Entra ID to access transcript and recording
- Get notified when the meeting transcripts and recordings are available
- Use Graph APIs to fetch transcript
- Use Graph APIs to fetch recording
Configure permissions on Microsoft Entra ID to access transcript and recording
Your app must have the required permissions for fetching transcripts and recordings. It can access and fetch transcripts and recordings for a Teams meeting using organization-wide application permissions or resource-specific consent (RSC) application permissions for a particular meeting.
Use organization-wide application permissions
You can configure your app to access meeting transcripts and recordings across the tenant. In this case, the meeting organizer doesn't need to install your app in the Teams meeting chat. When the admin authorizes the organization-wide application permissions, your app can read and access transcripts and recordings for all meetings in the tenant.
For more information about the organization-wide application permissions that can be granted to your app, see online meeting permissions.
Use meeting-specific RSC application permissions
If you want your app to fetch transcripts and recordings only for the Teams meeting where it's installed, configure meeting-specific RSC permission for your app. Authorized users can install your app in the meeting chat. After the meeting ends, your app can make the API call to obtain the transcript and recording for that meeting.
For more information about the meeting-specific RSC permissions, see RSC permissions for a chat or meeting.
Get notified when a transcript or recording is available
After you've configured the permissions, configure your app to receive change notifications for transcripts and recordings available events or all relevant meeting events. Notifications contain meeting ID and organizer ID that help in accessing transcript content and recording. Your app can fetch the transcript and recording for a meeting when it's generated after it ends. The content of the transcript is available as .vtt file. The recording of the meeting is available as an .mp4 file.
You can use the following types of change notification for your app:
| Subscription Scope | Description | Supported resource paths |
|---|---|---|
| Tenant level | A transcript or recording is available for any online meeting for a tenant. | • All transcripts in an organization: communications/onlineMeetings/getAllTranscripts• All recordings in an organization: communications/onlineMeetings/getAllRecordings |
| Meeting level | A transcript or recording is available for a specific online meeting. | • All transcripts for a specific meeting: communications/onlineMeetings/{onlineMeetingId}/transcripts • All recordings for a specific meeting: communications/onlineMeetings/{onlineMeetingId}/recordings |
| User-scoped | A transcript or recording is available for any online meeting organized by a specific user. | • A call transcript that becomes available in a meeting organized by a specific user: users/{userId}/onlineMeetings/getAllTranscripts • A call recording that becomes available in a meeting organized by a specific user: users/{userId}/onlineMeetings/getAllRecordings |
| App-scoped | A transcript or recording is available for any meeting in which a specific teams-app is installed. | • A call transcript that becomes available in a meeting where a particular Teams app is installed: appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllTrancripts • A call recording that becomes available in a meeting where a particular Teams app is installed: appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllRecordings |
For more information about how your app can know when a transcript or recording is available after the online meeting ends, see get notified when transcripts and recordings are available.
For more information about how your app can know when the meetings ends, see subscribe to change notifications and use Bot Framework to get meeting ID and organizer ID.
Note
The process for calling Graph APIs to access and retrieve transcripts and recordings remains the same for both meeting-specific RSC application permissions and organization-wide application permissions. These APIs support only scheduled meetings.