October 31st, 2023

Microsoft Graph APIs for Microsoft Teams meeting transcripts now generally available

We are thrilled to announce that the Microsoft Graph APIs for retrieving Microsoft Teams meeting transcripts are now generally available. These APIs enable app developers to retrieve meeting transcripts programmatically for scheduled regular (non-channel) meetings. Now developers can build apps that fetch the transcript content for meetings and apply AI on top of that to power scenarios like:

  • AI meeting summary: Provide users with insights like AI-generated notes, action items, topics discussed, and questions asked.
  • Speaker insights: Sentiment and engagement analysis of users based on transcript.
  • Smart follow-ups: Analyze previous calls to generate insights about what to discuss in the next iterations.
  • Training and onboarding: Reduce ramp up time for new employees by sharing snippets of successful practices from previous meetings.

Apps in industries like sales enablement, HR/interviewing, and meeting management would especially benefit from using these APIs for the above scenarios to supercharge their users’ meeting productivity.

How to use Microsoft Graph APIs to fetch meeting transcripts

To use the Microsoft Graph APIs for meeting transcripts, you need to have a Microsoft Teams meeting with transcription enabled. During the meeting, the organizer/participant needs to go to meeting controls and turn on Start transcription, or Start recording, as described in View live transcription in Microsoft Teams meetings.

The new callTranscript resource type represents the transcript associated with an online meeting.

You can list all the transcripts associated with an online meeting by using the List transcripts API. When you have the callTranscript ID, you can call the following API to fetch the transcript content:

  • Get transcript content: The transcript content is available in .vtt format. The following example shows how the .vtt format for transcript appears. It contains details like utterance, start and end time, text, speaker, and language.

Screenshot of get transcript content response example

Change notifications

We also support APIs to subscribe to change notifications for when a transcript content is available. You can subscribe to change notifications for transcripts at two levels:

  • Tenant level: To get change notifications for any transcript that’s available for any online meeting in a tenant, subscribe to communications/onlineMeetings/getAllTranscripts
  • Meeting level: To get change notifications for any transcript that’s available for a particular online meeting, subscribe to communications/onlineMeetings/{onlineMeetingId}/transcripts

We will also add support for change notifications at user (organizer) level and app context level in the coming months.

For more information about how to get started with these APIs, see Get meeting transcripts and recordings.

Billing requirements for meeting transcript APIs

The API to get the transcript content is metered. For details about pricing, see the Microsoft Teams Recording and Transcript APIs billing in public preview blog post and Payment requirements for meeting APIs.

Related APIs

Related APIs that complement the transcript APIs when building applications for Teams meeting scenarios are also available. For details, see the following links:

For more information about Microsoft Teams APIs, see Use the Microsoft Graph API to work with Microsoft Teams – Microsoft Graph beta | Microsoft Learn

Follow us on X (Twitter) / (@Microsoft365Dev) for the latest news and announcements.

1 comment

Discussion is closed. Login to edit/delete existing comments.

  • Ethan Morris

    It’s amazing, thanks a lot.