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 Nach dem Ende der Besprechung oder des Anrufs Microsoft Teams-Transkripte und -Aufzeichnungen abruft. 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
  • Ad-hoc-Aufruf

Anwendungsfälle

Im Folgenden finden Sie einige Anwendungsfälle zum Abrufen von Besprechungstranskripten und Aufzeichnungen mithilfe von Graph-API.

Anwendungsfall Beschreibung Wie die APIs helfen
Automatisches Abrufen von Besprechungstranskripts und -aufzeichnungen für geplante Instanzen wie Onlinebesprechungen Als Vertriebsleiter müssen Sie Transkripte und Aufzeichnungen abrufen, um aussagekräftige Erkenntnisse aus mehreren Besprechungen in der Vertriebssparte zu erfassen. Es ist zeitaufwändig und ineffizient, alle Besprechungen im Blick zu behalten und Besprechungstranskripte und Aufzeichnungen manuell von ihnen abzurufen, 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 empfängt Besprechungsbenachrichtigungen und ruft das Transkript und die Aufzeichnung ab, 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
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. Nachdem sie beendet wurde, müssen Sie die Diskussion analysieren, um Datenpunkte für die Planung von Verbesserungen zu sammeln. 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. 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
Erstellen einer personalisierten App für geplante Instanzen wie Onlinebesprechungen Als Vertriebsmitarbeiter bei einem führenden Technologieunternehmen müssen Sie 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 Transkripten und Aufzeichnungen nach der Besprechung für Ad-hoc-Instanzen Als Projektmanager müssen Sie spontane Gruppen- oder Einzelanrufe tätigen, die nicht im Voraus geplant werden können. Ohne Besprechungseinladung werden keine Besprechungs-IDs generiert, sodass auf Transkripte und Aufzeichnungen nicht zugegriffen werden kann. Das Herunternehmen von reichlichen Notizen lässt viel Raum, um wichtige Aktionselemente zu verpassen. Verwenden Sie Graph-APIs in Ihrer App, um Transkripte und Aufzeichnungen nach der Besprechung abzurufen, damit Sie und die Teilnehmer sich vollständig auf die Diskussion konzentrieren können. Mithilfe von Berechtigungen CallTranscripts.Read.All und CallRecordings.Read.Allist das Anruftranskript verfügbar für:
• Erfassen wichtiger Aktionselemente
• Auflisten von Aufgaben oder Problemen
• Besprechungsnachverfolgung und Benachrichtigungen
Abrufen von Transkripten und Aufzeichnungen nach dem Anruf für PSTN-Anrufe Sie verfügen über ein Callcenter, in dem menschliche Assistenten Kundensupport mit eingehenden oder ausgehenden PSTN-Anrufen über Microsoft Teams bereitstellen. Die Assistenten müssen externe Aufzeichnungssysteme manuell mit Notizen aus jedem Anruf aktualisieren, nachdem der Anruf beendet wurde. Die Verwendung von Graph-APIs in Ihrer App zum Abrufen von Transkripten und Aufzeichnungen nach dem Aufruf reduziert den manuellen Aufwand, den jeder Assistent zum Aktualisieren von Datensätzen erfordert. Außerdem ermöglicht es Ihrer App, Automatisierungen mithilfe von Anruftranskript auszulösen.

Abrufen von Besprechungs- und Anruftranskripts und Aufzeichnungen

So rufen Sie das Transkript und die Aufzeichnung für eine bestimmte Besprechung und einen bestimmten Anruf 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.

Hinweis

  • Für die oben genannten Ressourcen sind neue Berechtigungen für adhocCalls (parallel zu OnlineMeetings) erforderlich.
  • Abonnieren Sie zwei separate Ressourcen mit entsprechendem Bereich (eine für onlineMeetings und eine andere für adhocCalls). Diese Ressourcen stellen die URLs bereit, 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 auf Besprechungstranskripte und -aufzeichnungen im gesamten Mandanten zugreifen kann. 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.

Hinweis

App-basierte Berechtigungen und vom Benutzer delegierte Berechtigungen sind für Ad-hoc-Aufrufe 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-Aufrufe sind nicht aktiviert.

Benachrichtigungen erhalten, wenn ein Transkript oder eine Aufzeichnung verfügbar ist

Nachdem Sie die Berechtigungen konfiguriert haben, konfigurieren Sie Ihre App für den Empfang von Änderungsbenachrichtigungen für Transkripte und Aufzeichnungen, 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. Für Ad-hoc-Anrufe ist die Besprechungs-ID nicht verfügbar, da es sich um spontane Ereignisse handelt (PSTN, 1:1, Gruppenanrufe). Obwohl es keine Einschränkungen für den Benachrichtigungspfad für Ad-hoc-Aufrufe gibt, getAll sind APIs nicht auch für Ad-hoc-Anrufinstanzen verfügbar (z. B. Das Auflisten 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 einem organization:
• Für Online-Besprechungen: communications/onlineMeetings/getAllTranscripts
• Für Anrufe: communications/adhocCalls/getAllTranscripts

Alle Aufzeichnungen in einem organization:
• Für Online-Besprechungen: communications/onlineMeetings/getAllRecordings
• Für Anrufe: communications/adhocCalls/getAllRecordings
Besprechungs- oder Anrufebene Ein Transkript oder eine Aufzeichnung ist für eine bestimmte Besprechung oder einen bestimmten Anruf 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 einen bestimmten Ad-hoc-Aufruf: /communications/adhocCalls/{callId}/transcripts

Alle Aufzeichnungen für einen bestimmten Ad-hoc-Aufruf: /communications/adhocCalls/{callId}/recordings
Benutzerbereich Ein Transkript oder eine Aufzeichnung ist für jeden organisierten Onlinebesprechungs- oder Ad-hoc-Anruf verfügbar, der von einem bestimmten Benutzer initiiert wird. Ein Anruftranskript, das in einer Besprechung verfügbar wird, die von einem bestimmten Benutzer organisiert wird, oder in einem Anruf, bei dem die Transkription von einem angegebenen Benutzer initiiert wird:
• Für Online-Besprechungen: users/{userId}/onlineMeetings/getAllTranscripts
• Für Ad-hoc-Aufrufe: users/{userId}/adhocCalls/getAllTranscripts

Eine Anrufaufzeichnung, die in einer Besprechung verfügbar wird, die von einem bestimmten Benutzer organisiert wird, oder in einem Anruf, bei dem die Transkription von einem angegebenen Benutzer initiiert wird:
• Für Online-Besprechungen: users/{userId}/onlineMeetings/getAllRecordings
• Für Ad-hoc-Aufrufe: users/{userId}/adhocCalls/getAllRecordings
App-Bereich 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-Aufrufe. Ein Anruftranskript, das in einer Besprechung verfügbar wird, in der eine bestimmte Teams-App installiert ist:
• Für Online-Besprechungen: 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-Besprechungen: 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 oder der Ad-hoc-Anruf beendet wurde, finden Sie unter Benachrichtigungen, 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.

Wichtig

  • 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, Kanalbesprechungen und Ad-hoc-Anrufe nur in der Betaphase.
  • Für Ad-hoc-Aufrufe:

Abrufen von KI-generierten Besprechungszusammenfassungen für Onlinebesprechungsinstanzen

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#
Transkriptbot für Onlinebesprechung Diese Beispiel-App ruft Besprechungstranskripte mithilfe von Microsoft Graph-API ab und zeigt sie in einem Dialogfeld an. View View
Aufzeichnungen von Onlinebesprechungstranskripts Diese Beispiel-App ruft Teams-Besprechungstranskripte und -Aufzeichnungen mithilfe von Graph-APIs ab. View View
Transkripte und Aufzeichnungen für Ad-hoc-Aufrufe Diese Beispiel-App ruft Besprechungstranskripte und -aufzeichnungen mithilfe von Graph-APIs für Ad-hoc-Anrufe ab, einschließlich PSTN, 1:1 und Gruppenanrufen. View

Nächster Schritt

Benachrichtigungen erhalten, wenn die Besprechungstranskripte und -aufzeichnungen verfügbar sind

Siehe auch

  • Last updated on