Abrufen von Besprechungstranskripts und Aufzeichnungen mithilfe von Graph-APIs

Wichtig

Ab dem 25. August 2025 werden die in diesem Artikel aufgeführten Teams-APIs nicht mehr getaktet, und für die Verwendung dieser APIs ist keine Abrechnungskonfiguration erforderlich. Wenn Ihre Anwendung für die Abrechnung konfiguriert ist, ist keine Aktion erforderlich. Dieser Artikel dient als Referenz zum Abschluss des endgültigen Abrechnungszyklus für getaktete Microsoft Teams-APIs.

Sie können Ihre App jetzt so konfigurieren, dass Microsoft Teams-Transkripte und -Aufzeichnungen abgerufen werden, nachdem die Besprechung oder der Anruf beendet wurde. Ihre App kann Microsoft Graph-REST-APIs verwenden, um auf Transkripte und Aufzeichnungen zuzugreifen und diese abzurufen, die für die folgenden Instanzen generiert wurden:

  • Eine geplante Onlinebesprechung
  • Ein Ad-hoc-Anruf

Anwendungsfälle

Hier sind einige Anwendungsfälle für das Abrufen von Besprechungstranskripten und -aufzeichnungen mithilfe der Graph-API.

Anwendungsfall Beschreibung So helfen die APIs
Automatisches Abrufen von Besprechungstranskripten und -aufzeichnungen für geplante Instanzen wie Onlinebesprechungen Als Vertriebsleiter benötigen Sie Transkripte und Aufzeichnungen, um aussagekräftige Erkenntnisse aus mehreren Besprechungen in der gesamten Vertriebssparte zu erfassen. Alle Besprechungen im Auge zu behalten und Besprechungstranskripte und -aufzeichnungen manuell abzurufen, um nützliche Informationen zu erhalten, ist zeitaufwändig und ineffizient. Verwenden Sie Graph-APIs in Ihrer App, um automatisch Besprechungstranskripte und -aufzeichnungen aus allen für Ihren Zweck relevanten Besprechungen abzurufen. Ihre App empfängt Besprechungsbenachrichtigungen und ruft das Transkript und die Aufzeichnung ab, wenn sie nach dem Ende der Besprechung generiert werden.
Diese Daten können dann verwendet werden, um Folgendes zu gewinnen:
• Aggregierte Erkenntnisse und Intelligence-Analysen
• Neue Leads und Highlights
• Besprechungsnachverfolgungen und Zusammenfassungen
Abrufen von Transkripten und Aufzeichnungen nach der Besprechung für geplante Instanzen wie Onlinebesprechungen Als HR-Initiative führen Sie eine Brainstormingsitzung durch, um die Gesundheit und Produktivität der Mitarbeiter zu verstehen und zu verbessern. Nach dem Ende der Diskussion müssen Sie die Diskussion analysieren, um Datenpunkte für die Planung von Verbesserungen zu sammeln. Wenn Sie sich ständig Notizen machen müssen, um eine Zusammenfassung nach der Besprechung zu erstellen, kann dies den Gedankenfluss behindern, und Sie können möglicherweise nicht alle wertvollen Vorschläge erfassen. Die Verwendung von Graph-APIs in Ihrer App zum Abrufen von Transkripten und Aufzeichnungen nach der Besprechung gibt Ihnen und den Teilnehmern die Freiheit, sich voll und ganz auf die Diskussion zu konzentrieren. Der Inhalt des Besprechungstranskripts und der Aufzeichnung ist verfügbar für:
• Engagement- und Stimmungsanalyse
• Auflisten von Aufgaben oder Problemen
• Besprechungsnachverfolgung und Benachrichtigungen
Erstellen einer personalisierten App für geplante Instanzen wie Onlinebesprechungen Als Verkäufer in einem führenden Technologieunternehmen müssen Sie mit Kunden in Kontakt treten und Geschäfte abschließen. Bei zahlreichen Besprechungen, die über Teams und den Outlook-Kalender geplant sind, ist es wichtig, an allen Anrufen teilzunehmen und über Diskussionen und aktuelle Updates auf dem Laufenden zu bleiben. Erstellen Sie eine App mit den folgenden Funktionen:
• Benachrichtigen Sie, wenn eine Besprechung mit Teams oder Outlook-Kalender geplant ist.
• Aktivieren Sie Ihre App, um für diese Besprechungen festzulegen AutoRecording=true .
• Fügen Sie einen Bot als Besprechungsteilnehmer hinzu, um ein Banner anzuzeigen, das anzeigt, dass die Besprechung aufgezeichnet wird und der Inhalt von Ihrer App zur Analyse verwendet wird.
• Erlauben Sie Ihrer App den Zugriff auf Besprechungsaufzeichnungen und Transkriptionen.
• Lassen Sie Ihre App zu, ohne dass eine Administratorgenehmigung für die OnlineMeetingRecording.Read.All Berechtigungen erforderlich ist, da das Einholen der Administratorgenehmigung für diese Berechtigungen zeitaufwändig sein kann.
Hier ist eine Beispiel-App , die dieses Anwendungsfallszenario veranschaulicht.
Abrufen von Transkripten und Aufzeichnungen nach der Besprechung für Ad-hoc-Instanzen Als Projektmanager erfordert Ihre Rolle, dass Sie spontane Gruppen- oder Einzelanrufe tätigen, die nicht im Voraus geplant werden können. Ohne Besprechungseinladung werden keine Besprechungs-IDs generiert, und daher kann nicht auf Transkripte und Aufzeichnungen zugegriffen werden. Wenn Sie sich umfangreiche Notizen machen, bleibt viel Spielraum, um wichtige Aktionspunkte zu übersehen. Verwenden Sie Graph-APIs in Ihrer App, um Transkripte und Aufzeichnungen nach der Besprechung abzurufen. So können Sie und die Teilnehmer sich voll und ganz auf die Diskussion konzentrieren. Durch Verwenden von Berechtigungen CallTranscripts.Read.All und CallRecordings.Read.Allist das Anruftranskript verfügbar für:
• Erfassung wichtiger Aktionspunkte
• Auflisten von To-Dos oder Problemen
• Besprechungsnachverfolgung und Benachrichtigungen
Abrufen von Transkripten und Aufzeichnungen nach dem Anruf für PSTN-Anrufe Sie haben ein Callcenter, in dem menschliche Assistenten Kundensupport mithilfe von ein- oder ausgehenden PSTN-Anrufen mit Microsoft Teams leisten. Die Assistenten müssen externe Aufzeichnungssysteme nach Beendigung des Anrufs manuell mit Notizen aus jedem Anruf aktualisieren. Die Verwendung von Graph-APIs in Ihrer App zum Abrufen von Transkripten und Aufzeichnungen nach dem Anruf reduziert die manuelle Arbeit, die jeder Assistent zum Aktualisieren von Datensätzen ausführen muss. Außerdem ermöglicht es Ihrer App, Automatisierungen mithilfe des Anruftranskripts auszulösen.

Abrufen von Besprechungs- und Anruftranskripten und -aufzeichnungen

So rufen Sie das Transkript und die Aufzeichnung für eine bestimmte Besprechung und einen bestimmten Anruf ab:

  1. Konfigurieren Sie Berechtigungen für Microsoft Entra ID für den Zugriff auf Transkript und Aufzeichnung
  2. Lassen Sie sich benachrichtigen, wenn Besprechungstranskripte und Aufzeichnungen verfügbar sind
  3. Verwenden von Graph-APIs zum Abrufen von Transkripten
  4. Verwenden von Graph-APIs zum Abrufen der Aufzeichnung

Konfigurieren Sie Berechtigungen für Microsoft Entra ID für den Zugriff auf Transkript und Aufzeichnung

Ihre App muss über die erforderlichen Berechtigungen zum Abrufen von Transkripten und Aufzeichnungen verfügen. Sie kann auf Transkripte und Aufzeichnungen für eine Teams-Besprechung zugreifen und diese abrufen, indem sie organisationsweite Anwendungsberechtigungen oder ressourcenspezifische Zustimmungsberechtigungen (Resource-Specific Consent, RSC) für eine bestimmte Besprechung verwendet.

Darüber hinaus wird der Zugriff auf Transkripte und Transkriptänderungsbenachrichtigungen durch zwei unabhängige Mandantenadministratoreinstellungen geregelt:

  • Graph-API-Zugriff auf Transkripte. Wenn diese Option deaktiviert ist, werden alle Transkriptanforderungen (Metadaten metadataContentund content) unabhängig vom angeforderten Format mit dem GraphAccessToTranscriptsDisabled inneren Fehlercode zurückgegeben403 Forbidden.

  • Zuschreibung des Sprechers. Wenn diese Option deaktiviert ist, können Transkriptinhalte nur ohne Sprecherinformationen im application/vnd.microsoft.graph.transcript+text Format abgerufen werden.

Weitere Informationen finden Sie in den Abschnitten zu Mandantenadministratorsteuerelementen in der Dokumentation zu Änderungsbenachrichtigungsabonnements und dem Vorgang Get callTranscript.

Hinweis

  • Für die oben genannten Ressourcen sind neue Berechtigungen für adhocCalls (parallel zu OnlineMeetings) erforderlich.
  • Abonnieren Sie zwei getrennte, entsprechend definierte Ressourcen (eine für onlineMeetings und die andere für adhocCalls). Diese Ressourcen liefern die URLs, die zum Abrufen der Daten verwendet werden sollen.

Verwenden von organisationsweiten Anwendungsberechtigungen

Für Onlinebesprechungen und -anrufe können Sie Ihre App so konfigurieren, dass sie mandantenübergreifend auf Besprechungstranskripte und -aufzeichnungen zugreift. In diesem Fall muss der Besprechungsorganisator Ihre App nicht im Teams-Besprechungschat installieren. Wenn der Administrator die organisationsweiten Anwendungsberechtigungen autorisiert, kann Ihre App Transkripte und Aufzeichnungen für alle Besprechungen im Mandanten lesen und darauf zugreifen.

Weitere Informationen zu den organisationsweiten Anwendungsberechtigungen, die Ihrer App erteilt werden können, finden Sie unter Berechtigungen für Onlinebesprechungen.

Hinweis

App-basierte Berechtigungen und vom Benutzer delegierte Berechtigungen sind für Ad-hoc-Anrufe zulässig.

Verwenden von besprechungsspezifischen RSC-Anwendungsberechtigungen

Wenn Ihre App Transkripte und Aufzeichnungen nur für die Teams-Besprechung abrufen soll, in der sie installiert ist, konfigurieren Sie die besprechungsspezifische RSC-Berechtigung für Ihre App. Autorisierte Benutzer können Ihre App im Besprechungschat installieren. Nach Abschluss der Besprechung kann Ihre App den API-Aufruf durchführen, um das Transkript und die Aufzeichnung für diese Besprechung abzurufen.

Weitere Informationen zu den besprechungsspezifischen RSC-Berechtigungen finden Sie unter RSC-Berechtigungen für einen Chat oder eine Besprechung.

Hinweis

RSC-basierte Berechtigungen für Ad-hoc-Anrufe sind nicht aktiviert.

Lassen Sie sich benachrichtigen, wenn ein Transkript oder eine Aufzeichnung verfügbar ist

Nachdem Sie die Berechtigungen konfiguriert haben, konfigurieren Sie Ihre App so, dass sie Änderungsbenachrichtigungen für Transkripte und Aufzeichnungen erhält, sofern verfügbar, oder für alle relevanten Besprechungen und Ad-hoc-Anrufe. Bei Onlinebesprechungen enthalten Benachrichtigungen die Besprechungs-ID und die Organisator-ID, die beim Zugriff auf Transkriptinhalte und Aufzeichnungen helfen. Ihre App kann das Transkript und die Aufzeichnung für eine Besprechung abrufen, wenn sie nach dem Ende der Besprechung generiert werden. Bei Ad-hoc-Anrufen ist die Besprechungs-ID nicht verfügbar, da es sich um spontane Ereignisse handelt (PSTN, 1:1, Gruppenanrufe). Es gibt zwar keine Einschränkungen für den Benachrichtigungspfad für Ad-hoc-Aufrufe, getAll APIs sind jedoch auch für Ad-hoc-Aufrufinstanzen nicht verfügbar (z. B. Auflistung von Artefakten auf Aufrufebene). Der Inhalt des Transkripts ist als .vtt Datei verfügbar. Die Aufzeichnung der Besprechung ist als .mp4 Datei verfügbar.

Sie können die folgenden Arten von Änderungsbenachrichtigungen für Ihre App verwenden:

Abonnementbereich Beschreibung Unterstützte Ressourcenpfade
Mandantenebene Ein Transkript oder eine Aufzeichnung ist für jede Onlinebesprechung oder jeden Anruf für einen Mandanten verfügbar. Alle Transkripte in einer organization:
• Für Online-Meetings: communications/onlineMeetings/getAllTranscripts
• Für Anrufe: communications/adhocCalls/getAllTranscripts

Alle Aufzeichnungen in einer organization:
• Für Online-Meetings: communications/onlineMeetings/getAllRecordings
• Für Anrufe: communications/adhocCalls/getAllRecordings
Besprechungs- oder Anrufebene Für eine bestimmte Besprechung oder einen Anruf ist ein Transkript oder eine Aufzeichnung verfügbar.
Alle Transkripte für eine bestimmte Besprechung: communications/onlineMeetings/{onlineMeetingId}/transcripts

Alle Aufzeichnungen für eine bestimmte Besprechung: communications/onlineMeetings/{onlineMeetingId}/recordings

Alle Transkripte für eine bestimmte Ad-hoc-Nutzung: /communications/adhocCalls/{callId}/transcripts

Alle Aufzeichnungen für einen bestimmten Ad-hoc-Anruf: /communications/adhocCalls/{callId}/recordings
Benutzerbezogener Ein Transkript oder eine Aufzeichnung ist für jede Onlinebesprechung verfügbar, die organisiert oder Ad-hoc-Anruf von einem bestimmten Benutzer initiiert wurde. Ein Anruftranskript, das in einer von einem bestimmten Benutzer organisierten Besprechung oder in einem Anruf verfügbar wird, in dem die Transkription von einem bestimmten Benutzer initiiert wird:
• Für Online-Meetings: users/{userId}/onlineMeetings/getAllTranscripts
• Für Ad-hoc-Anrufe: users/{userId}/adhocCalls/getAllTranscripts

Eine Anrufaufzeichnung, die in einer von einem bestimmten Benutzer organisierten Besprechung oder in einem Anruf verfügbar wird, in dem die Transkription von einem bestimmten Benutzer initiiert wird:
• Für Online-Meetings: users/{userId}/onlineMeetings/getAllRecordings
• Für Ad-hoc-Anrufe: users/{userId}/adhocCalls/getAllRecordings
App-bereichsbezogen Ein Transkript oder eine Aufzeichnung ist für jede Besprechung verfügbar, in der eine bestimmte Teams-App installiert ist. Gilt nicht für Ad-hoc-Anrufe. Ein Anruftranskript, das in einer Besprechung verfügbar wird, in der eine bestimmte Teams-App installiert ist:
• Für Online-Meetings: appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllTranscripts

Eine Anrufaufzeichnung, die in einer Besprechung verfügbar wird, in der eine bestimmte Teams-App installiert ist:
• Für Online-Meetings: appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllRecordings

Weitere Informationen dazu, wie Ihre App wissen kann, wann ein Transkript oder eine Aufzeichnung nach dem Ende einer Onlinebesprechung oder eines Ad-hoc-Anrufs verfügbar ist, finden Sie unter Benachrichtigen Sie, wenn Transkripte und Aufzeichnungen verfügbar sind.

Weitere Informationen dazu, wie Ihre App wissen kann, wann die Besprechungen enden, finden Sie unter Abonnieren von Änderungsbenachrichtigungen und Verwenden von Bot Framework zum Abrufen von Besprechungs-ID und Organisator-ID.

Wichtig

  • Der Prozess zum Aufrufen von Graph-APIs für den Zugriff auf und das Abrufen von Transkripten und Aufzeichnungen bleibt sowohl für besprechungsspezifische RSC-Anwendungsberechtigungen als auch für organisationsweite Anwendungsberechtigungen gleich.
  • Diese APIs unterstützen private Chatbesprechungen, Kanalbesprechungen und Ad-hoc-Anrufe nur in der Betaversion.
  • Für Ad-hoc-Anrufe:

Abrufen von KI-generierten Besprechungszusammenfassungen für Onlinebesprechungsinstanzen

Ihre App kann mithilfe der Meeting KI Insights-API direkt von KI generierte Besprechungszusammenfassungen abrufen, einschließlich Gesprächszusammenfassungen, Aktionselemente und Erwähnungen. Weitere Informationen finden Sie unter Abrufen von Besprechungserkenntnissen mit der Meeting KI Insights-API.

Codebeispiele

Beispielname Beschreibung Node.js C# Python
Bot-Besprechungen Dieses Beispiel zeigt, wie Sie Besprechungsereignisse in Echtzeit behandeln und Besprechungstranskripte in Microsoft Teams abrufen. View View View
Aufzeichnungen von Onlinebesprechungstranskripten Diese Beispiel-App ruft Teams-Besprechungstranskripte und -Aufzeichnungen mithilfe von Graph-APIs ab. View View –
Ad-hoc-Anrufe, Transkripte und Aufzeichnungen Diese Beispiel-App ruft Besprechungstranskripte und -aufzeichnungen mithilfe von Graph-APIs für Ad-hoc-Anrufe ab, einschließlich PSTN-, 1:1- und Gruppenanrufe. View – –

Nächster Schritt

Lassen Sie sich benachrichtigen, wenn Besprechungstranskripte und Aufzeichnungen verfügbar sind

Siehe auch

  • Last updated on