Obtenir des transcriptions et des enregistrements de réunion à l’aide des API Graph

Remarque

Les API permettant de récupérer les transcriptions et les enregistrements de réunion sont des API limitées. Pour plus d’informations, consultez Modèles de paiement pour les API de réunion.

Vous pouvez maintenant configurer votre application pour récupérer les transcriptions et les enregistrements Microsoft Teams après la fin de la réunion ou de l’appel. Votre application peut utiliser les API REST Microsoft Graph pour accéder aux transcriptions et aux enregistrements générés pour les instances suivantes :

  • une réunion en ligne planifiée
  • un appel ad hoc

Cas d'utilisation

Voici quelques cas d’utilisation pour récupérer les transcriptions et les enregistrements de réunion à l’aide de API Graph.

Cas d’utilisation Description Aide des API
Récupérer automatiquement les transcriptions et les enregistrements de réunion pour les instances planifiées , telles que les réunions en ligne En tant que responsable des ventes, vous devez obtenir des transcriptions et des enregistrements pour capturer des insights significatifs à partir de plusieurs réunions dans le secteur vertical des ventes. La conservation d’un onglet sur toutes les réunions et la récupération manuelle des transcriptions et des enregistrements de réunion à partir de celles-ci pour obtenir des informations utiles sont fastidieuses et inefficaces. Utilisez les API Graph dans votre application pour récupérer automatiquement les transcriptions et les enregistrements de réunion de toutes les réunions pertinentes pour votre objectif. Votre application reçoit des notifications de réunion et obtient la transcription et l’enregistrement lorsqu’elle est générée après la fin de la réunion.
Ces données peuvent ensuite être utilisées pour gagner :
• Informations agrégées et analyse des renseignements
• Nouvelles pistes et faits marquants
• Suivi et résumé des réunions
Récupérer les transcriptions et les enregistrements post-réunion pour des instances planifiées telles que les réunions en ligne Dans le cadre d'une initiative des RH, vous organisez une séance de brainstorming pour comprendre et améliorer la santé et la productivité des employés. Une fois l’opération terminée, vous devrez analyser la discussion pour collecter des points de données afin d’améliorer la planification. Le fait de devoir continuellement prendre des notes pour fournir un résumé post-réunion peut entraver le flux des pensées, et vous risquez de ne pas capturer toutes les suggestions précieuses. L’utilisation des API Graph dans votre application pour récupérer des transcriptions et des enregistrements après la réunion vous permet, ainsi qu’aux participants, de vous concentrer entièrement sur la discussion. Le contenu de la transcription et de l’enregistrement de la réunion est disponible pour :
• Analyse de l'engagement et du sentiment
• Lister les tâches ou les problèmes
• Réunions de suivi et notifications
Créer une application personnalisée pour les instances planifiées telles que les réunions en ligne En tant que vendeur dans une entreprise technologique de premier plan, vous devez communiquer avec les clients et conclure des transactions. Avec de nombreuses réunions planifiées via Teams et le calendrier Outlook, il est essentiel de participer à tous les appels et de rester informé des discussions et des dernières mises à jour. Créez une application avec les fonctionnalités suivantes :
• Vous avertir lorsqu’une réunion est planifiée à l’aide de Teams ou du calendrier Outlook.
• Activez votre application à définir AutoRecording=true pour ces réunions.
• Ajoutez un bot en tant que participant à la réunion pour afficher une bannière indiquant que la réunion est enregistrée et que le contenu est utilisé par votre application à des fins d’analyse.
• Autorisez votre application à accéder aux enregistrements et aux transcriptions de réunion.
• Autorisez votre application sans demander l’approbation de l’administrateur pour les OnlineMeetingRecording.Read.All autorisations, car l’obtention de l’approbation de l’administrateur pour ces autorisations peut prendre beaucoup de temps.
Voici un exemple d’application qui présente ce scénario de cas d’usage.
Récupérer les transcriptions et les enregistrements après la réunion pour les instances ad hoc En tant que chef de projet, votre rôle vous oblige à passer des appels spontanés en groupe ou en tête-à-tête, qui ne peuvent pas être planifiés au préalable. Sans invitation à une réunion, les ID de réunion ne sont pas générés et, par conséquent, les transcriptions et les enregistrements ne sont pas accessibles. Le fait de prendre des notes abondantes laisse beaucoup de place pour manquer des éléments d’action critiques. Utiliser les API Graph dans votre application pour extraire les transcriptions et les enregistrements après la réunion vous permet, ainsi qu’aux participants, de vous concentrer entièrement sur la discussion. En utilisant les autorisations CallTranscripts.Read.All et CallRecordings.Read.All, la transcription d’appel est disponible pour :
• Capture d’éléments d’action importants
• Liste des tâches ou des problèmes
• Réunions de suivi et notifications
Récupérer la transcription et les enregistrements post-appel pour les appels RTC Vous disposez d’un centre d’appels où les assistants humains fournissent un support client à l’aide d’appels RTC entrants ou sortants à l’aide de Microsoft Teams. Les assistants doivent mettre à jour manuellement les systèmes d’enregistrement externes avec les notes de chaque appel après la fin de l’appel. L’utilisation des API Graph dans votre application pour extraire la transcription et les enregistrements après l’appel réduit le travail manuel requis par chaque assistant pour mettre à jour les enregistrements. Cela permet également à votre application de déclencher des automatisations à l’aide de la transcription d’appel.

Obtenir les transcriptions et les enregistrements de réunion et d’appel

Pour récupérer la transcription et l’enregistrement d’une réunion particulière et appeler :

  1. Configurer des autorisations sur Microsoft Entra ID pour accéder à la transcription et à l’enregistrement
  2. Recevoir une notification lorsque les transcriptions et les enregistrements de réunion sont disponibles
  3. Utiliser les API graphiques pour récupérer les transcriptions
  4. Utiliser les API Graph pour récupérer l’enregistrement

Configurer des autorisations sur Microsoft Entra ID pour accéder à la transcription et à l’enregistrement

Votre application doit disposer des autorisations requises pour récupérer les transcriptions et les enregistrements. Il peut accéder aux transcriptions et aux enregistrements d’une réunion Teams et les extraire à l’aide d’autorisations d’application à l’échelle organization ou d’autorisations d’application de consentement spécifique aux ressources (RSC) pour une réunion particulière.

En outre, l’accès aux transcriptions et aux notifications de modification de transcription est régi par deux paramètres d’administrateur de locataire indépendants :

  • API Graph l’accès aux transcriptions. Lorsqu’elle est désactivée, toutes les demandes de transcription (métadonnées, metadataContentet content) retournent 403 Forbidden avec le GraphAccessToTranscriptsDisabled code d’erreur interne, quel que soit le format demandé.

  • Attribution de l’orateur. Lorsqu’il est désactivé, le contenu de la transcription ne peut être récupéré que sans informations sur l’orateur application/vnd.microsoft.graph.transcript+text au format .

Pour plus d’informations, consultez les sections sur les contrôles d’administrateur client dans la documentation sur les abonnements aux notifications de modification et l’opération Get callTranscript.

Remarque

  • De nouvelles autorisations pour adhocCalls (parallèles à OnlineMeetings) sont requises pour les ressources ci-dessus.
  • Abonnez-vous à deux ressources distinctes et délimitées de manière appropriée (l’une pour onlineMeetings et l’autre pour adhocCalls). Ces ressources fournissent les URL à utiliser pour extraire les données.

Utiliser des autorisations d'application à l'échelle de l'organisation

Pour les réunions et les appels en ligne, vous pouvez configurer votre application pour accéder aux transcriptions et aux enregistrements de réunion dans le locataire. Dans ce cas, l'organisateur de la réunion n'a pas besoin d'installer votre application dans la conversation de la réunion Teams. Lorsque l’administrateur autorise les autorisations d’application à l’échelle de l’organization, votre application peut lire et accéder aux transcriptions et aux enregistrements de toutes les réunions dans le locataire.

Pour plus d’informations sur les autorisations d’application organization qui peuvent être accordées à votre application, consultez Autorisations de réunion en ligne.

Remarque

Les autorisations basées sur l’application et les autorisations déléguées par l’utilisateur sont autorisées pour les appels ad hoc.

Utiliser les autorisations d'application RSC propres à la réunion

Si vous souhaitez que votre application récupère les transcriptions et les enregistrements uniquement pour la réunion Teams où elle est installée, configurez l’autorisation RSC spécifique à la réunion pour votre application. Les utilisateurs autorisés peuvent installer votre application dans le chat de la réunion. Une fois la réunion terminée, votre application peut effectuer l’appel d’API pour obtenir la transcription et l’enregistrement de cette réunion.

Pour plus d’informations sur les autorisations RSC spécifiques à la réunion, consultez Autorisations RSC pour une conversation ou une réunion.

Remarque

Les autorisations basées sur RSC pour les appels ad hoc ne sont pas activées.

Recevoir une notification lorsqu’une transcription ou un enregistrement est disponible

Après avoir configuré les autorisations, configurez votre application pour recevoir des notifications de modification pour les transcriptions et les enregistrements lorsqu’ils sont disponibles ou pour toutes les réunions et appels ad hoc pertinents. Pour les réunions en ligne, les notifications contiennent l’ID de réunion et l’ID d’organisateur qui vous aident à accéder au contenu de transcription et à l’enregistrement. Votre application peut récupérer la transcription et l’enregistrement d’une réunion lorsqu’elle est générée après la fin de la réunion. Pour les appels ad hoc, l’ID de réunion ne sera pas disponible, car il s’agit d’événements spontanés (PSTN, 1:1, appels de groupe). Bien qu’il n’existe aucune restriction sur le chemin des notifications pour les appels ad hoc, getAll les API ne sont pas également disponibles pour les instances d’appel ad hoc (par exemple, la liste des artefacts au niveau de l’appel). Le contenu de la transcription est disponible sous forme de .vtt fichier. L’enregistrement de la réunion est disponible sous forme de .mp4 fichier.

Vous pouvez utiliser les types de notification de modification suivants pour votre application :

Étendue de l’abonnement Description Chemins d'accès aux ressources pris en charge
Niveau du locataire Une transcription ou un enregistrement est disponible pour toute réunion ou appel en ligne pour un locataire. Toutes les transcriptions d’un organization :
• Pour les réunions en ligne : communications/onlineMeetings/getAllTranscripts
• Pour les appels : communications/adhocCalls/getAllTranscripts

Tous les enregistrements d’un organization :
• Pour les réunions en ligne : communications/onlineMeetings/getAllRecordings
• Pour les appels : communications/adhocCalls/getAllRecordings
Niveau de réunion ou d’appel Une transcription ou un enregistrement est disponible pour une réunion ou un appel spécifique.
Toutes les transcriptions d’une réunion spécifique : communications/onlineMeetings/{onlineMeetingId}/transcripts

Tous les enregistrements d’une réunion spécifique : communications/onlineMeetings/{onlineMeetingId}/recordings

Toutes les transcriptions d’un appel ad hoc spécifique : /communications/adhocCalls/{callId}/transcripts

Tous les enregistrements d’un appel ad hoc spécifique : /communications/adhocCalls/{callId}/recordings
Limité à l’utilisateur Une transcription ou un enregistrement est disponible pour toute réunion en ligne organisée ou appel ad hoc lancé par un utilisateur spécifique. Transcription d’appel qui devient disponible dans une réunion organisée par un utilisateur spécifique ou dans un appel où la transcription est lancée par un utilisateur spécifié :
• Pour les réunions en ligne : users/{userId}/onlineMeetings/getAllTranscripts
• Pour les appels ad hoc : users/{userId}/adhocCalls/getAllTranscripts

Enregistrement d’appel qui devient disponible dans une réunion organisée par un utilisateur spécifique ou dans un appel où la transcription est lancée par un utilisateur spécifié :
• Pour les réunions en ligne : users/{userId}/onlineMeetings/getAllRecordings
• Pour les appels ad hoc : users/{userId}/adhocCalls/getAllRecordings
Étendue de l’application Une transcription ou un enregistrement est disponible pour toute réunion dans laquelle une application teams spécifique est installée. Non applicable aux appels ad hoc. Transcription d’appel qui devient disponible dans une réunion où une application Teams particulière est installée :
• Pour les réunions en ligne : appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllTranscripts

Enregistrement d’appel qui devient disponible dans une réunion où une application Teams particulière est installée :
• Pour les réunions en ligne : appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllRecordings

Pour plus d’informations sur la façon dont votre application peut savoir quand une transcription ou un enregistrement est disponible après la fin de la réunion en ligne ou de l’appel ad hoc, consultez Recevoir une notification quand des transcriptions et des enregistrements sont disponibles.

Pour plus d’informations sur la façon dont votre application peut savoir quand les réunions se terminent, consultez S’abonner aux notifications de modification et utiliser Bot Framework pour obtenir l’ID de réunion et l’ID d’organisateur.

Importante

  • Le processus d’appel des API Graph pour accéder aux transcriptions et aux enregistrements et les récupérer reste le même pour les autorisations d’application RSC spécifiques à la réunion et les autorisations d’application à l’échelle de organization.
  • Ces API prennent en charge les réunions de conversation privées, les réunions de canal et les appels ad hoc uniquement en version bêta.
  • Pour les appels ad hoc :

Obtenir des résumés de réunion générés par l’IA pour les instances de réunion en ligne

Votre application peut extraire directement des résumés de réunion générés par l’IA, y compris des résumés de conversation, des éléments d’action et des mentions à l’aide de l’API Meeting Insights IA. Pour plus d’informations, consultez Obtenir des insights de réunion avec l’API Meeting Insights IA.

Exemples de code

Exemple de nom Description Node.js C# Python
Réunions de bot Cet exemple montre comment gérer les événements de réunion en temps réel et récupérer les transcriptions de réunion dans Microsoft Teams. View View View
Enregistrements de transcriptions de réunion en ligne Cet exemple d’application récupère les transcriptions et les enregistrements de réunion Teams à l’aide des API Graph. View View N/A
Transcriptions et enregistrements d’appels ad hoc Cet exemple d’application récupère les transcriptions et les enregistrements de réunion à l’aide des API Graph pour les appels ad hoc, y compris les appels RTC, 1:1 et de groupe. View N/A N/A

Étape suivante

Recevoir une notification lorsque les transcriptions et les enregistrements de réunion sont disponibles

Voir aussi

  • Last updated on