Freigeben über


Abrufen von Besprechungstranskripts und Aufzeichnungen mithilfe von Graph-APIs

Hinweis

Die APIs zum Abrufen von Besprechungstranskripten und -aufzeichnungen sind getaktete APIs. Weitere Informationen finden Sie unter Zahlungsmodelle für Besprechungs-APIs.

Sie können Ihre App jetzt so konfigurieren, dass sie Microsoft Teams-Besprechungstranskripte und -aufzeichnungen im Szenario nach der Besprechung abruft. Ihre App kann Microsoft Graph-REST-APIs verwenden, um auf Transkripte und Aufzeichnungen zuzugreifen und diese abzurufen, die für eine geplante Teams-Besprechung generiert wurden.

Anwendungsfälle

Im Folgenden finden Sie einige Anwendungsfälle für das Abrufen von Besprechungstranskripten und -aufzeichnungen mithilfe von Graph-API:

Anwendungsfall Wie die APIs helfen...
Sie müssen Transkripte und Aufzeichnungen abrufen, um aussagekräftige Erkenntnisse aus mehreren Besprechungen in der vertikalen Vertriebssparte zu erfassen. Es ist zeitaufwändig und ineffizient, alle Besprechungen nachzuverfolgen und Besprechungsaufzeichnungen und Aufzeichnungen manuell abzurufen. Nachdem die Besprechung beendet ist, müssen Sie Unterhaltungen in all diesen Besprechungen untersuchen, um nützliche Informationen zu erhalten. Verwenden Sie Graph-APIs in Ihrer App, um Besprechungstranskripte und -aufzeichnungen automatisch aus allen Besprechungen abzurufen, die für Ihren Zweck relevant sind. Ihre App kann Besprechungsbenachrichtigungen empfangen und das Transkript und die Aufzeichnung abrufen, wenn sie nach dem Ende der Besprechung generiert wird. Diese Daten können dann verwendet werden, um Folgendes zu gewinnen:
• Aggregierte Erkenntnisse und Intelligence-Analysen
• Neue Leads und Highlights
• Besprechungsnachverfolgungen und Zusammenfassungen
Als HR-Initiative führen Sie eine Brainstormingsitzung durch, um die Gesundheit und Produktivität der Mitarbeiter zu verstehen und zu verbessern. Wenn Sie ständig Notizen erstellen müssen, um eine Zusammenfassung nach der Besprechung bereitzustellen, kann dies den Gedankenfluss beeinträchtigen, und Sie erfassen möglicherweise nicht alle wertvollen Vorschläge. Nach der Sitzung müssen Sie die Diskussion analysieren, um Datenpunkte für Planungsverbesserungen zu sammeln. Wenn Sie Graph-APIs in Ihrer App verwenden, um Transkripte und Aufzeichnungen nach der Besprechung abzurufen, können Sie und die Teilnehmer sich vollständig auf die Diskussion konzentrieren. Der Inhalt des Besprechungstranskripts und der Aufzeichnung ist verfügbar für:
• Engagement- und Stimmungsanalyse
• Auflisten von Aufgaben oder Problemen
• Besprechungsnachverfolgung und Benachrichtigungen
Ein Vertriebsmitarbeiter bei einem führenden Technologieunternehmen muss sich mit Kunden in Verbindung setzen und Geschäfte abschließen. Da zahlreiche Besprechungen über den Teams- und 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 mithilfe von Teams oder Outlook-Kalender geplant wird.
• Aktivieren Sie die Einstellung AutoRecording=true Ihrer App für diese Besprechungen.
• Fügen Sie einen Bot als Besprechungsteilnehmer hinzu, um ein Banner anzuzeigen, das angibt, dass die Besprechung aufgezeichnet wird und dass der Inhalt von Ihrer App zur Analyse verwendet wird.
• Ermöglichen Sie Ihrer App den Zugriff auf Besprechungsaufzeichnungen und Transkripte.
• Lassen Sie Ihre App zu, ohne dass eine Administratorgenehmigung für die Berechtigungen erforderlich ist, da das Einholen der OnlineMeetingRecording.Read.All Administratorgenehmigung für diese Berechtigungen zeitaufwändig sein kann.
Hier sehen Sie eine Beispiel-App , die dieses Anwendungsfallszenario veranschaulicht.

Abrufen von Besprechungstranskripts und -aufzeichnungen

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

  1. Konfigurieren von Berechtigungen für Microsoft Entra ID für den Zugriff auf Transkript und Aufzeichnung
  2. Benachrichtigungen erhalten, wenn die 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 von 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. Es kann auf Transkripte und Aufzeichnungen für eine Teams-Besprechung zugreifen und diese abrufen, indem organization-weite Anwendungsberechtigungen oder ressourcenspezifische Zustimmungsanwendungsberechtigungen (RSC) für eine bestimmte Besprechung verwendet werden.

Verwenden von organisationsweiten Anwendungsberechtigungen

Sie können Ihre App für den Mandantenzugriff auf Besprechungstranskripte und -aufzeichnungen konfigurieren. In diesem Fall muss der Besprechungsorganisator Ihre App nicht im Teams-Besprechungschat installieren. Wenn der Administrator die organization anwendungsweiten Berechtigungen autorisiert, kann Ihre App Transkripte und Aufzeichnungen für alle Besprechungen im Mandanten lesen und auf diese zugreifen.

Weitere Informationen zu den organization-weiten Anwendungsberechtigungen, die Ihrer App gewährt werden können, finden Sie unter Berechtigungen für Onlinebesprechung.

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.

Benachrichtigungen erhalten, 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 empfängt, sofern verfügbar oder alle relevanten Besprechungsereignisse. Benachrichtigungen enthalten 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 generiert wird. 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 für einen Mandanten verfügbar. • Alle Transkripte in einem organization:communications/onlineMeetings/getAllTranscripts
• Alle Aufnahmen in einem organization:communications/onlineMeetings/getAllRecordings
Besprechungsebene Ein Transkript oder eine Aufzeichnung ist für eine bestimmte Onlinebesprechung verfügbar. • Alle Transkripte für eine bestimmte Besprechung: communications/onlineMeetings/{onlineMeetingId}/transcripts
• Alle Aufzeichnungen für eine bestimmte Besprechung: communications/onlineMeetings/{onlineMeetingId}/recordings
Benutzerbereich Ein Transkript oder eine Aufzeichnung ist für jede Onlinebesprechung verfügbar, die von einem bestimmten Benutzer organisiert wird. • Ein Anruftranskript, das in einer Besprechung verfügbar wird, die von einem bestimmten Benutzer organisiert wird: users/{userId}/onlineMeetings/getAllTranscripts
• Eine Anrufaufzeichnung, die in einer Besprechung verfügbar wird, die von einem bestimmten Benutzer organisiert wird: users/{userId}/onlineMeetings/getAllRecordings
App-Bereich Ein Transkript oder eine Aufzeichnung ist für jede Besprechung verfügbar, in der eine bestimmte Teams-App installiert ist. • Ein Anruftranskript, das in einer Besprechung verfügbar wird, in der eine bestimmte Teams-App installiert ist: appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllTrancripts
• Eine Anrufaufzeichnung, die in einer Besprechung verfügbar wird, in der eine bestimmte Teams-App installiert ist: appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllRecordings

Weitere Informationen dazu, wie Ihre App wissen kann, wann ein Transkript oder eine Aufzeichnung verfügbar ist, nachdem die Onlinebesprechung beendet wurde, finden Sie unter Erhalten einer Benachrichtigung, 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 der Besprechungs-ID und Organisator-ID.

Hinweis

Der Prozess zum Aufrufen von Graph-APIs zum Zugreifen auf und Abrufen von Transkripts und Aufzeichnungen bleibt sowohl für besprechungsspezifische RSC-Anwendungsberechtigungen als auch für organization-weite Anwendungsberechtigungen identisch. Diese APIs unterstützen private Chatbesprechungen und Kanalbesprechungen nur in der Betaphase.

Abrufen von KI-generierten Besprechungszusammenfassungen

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

Codebeispiele

Beispielname Beschreibung Node.js C#
Besprechungstranskriptbot Diese Beispiel-App ruft Besprechungstranskripte mithilfe von Microsoft Graph-API ab und zeigt sie in einem Dialogfeld an. View View
Aufzeichnungen von Besprechungstranskripten Diese Beispiel-App ruft Teams-Besprechungstranskripte und -Aufzeichnungen mithilfe von Graph-APIs ab. View View

Nächster Schritt

Siehe auch