Obtenir des transcriptions et des enregistrements de réunion à l’aide des API Graph
Vous pouvez maintenant configurer votre application pour récupérer les transcriptions et les enregistrements de réunion Microsoft Teams dans le scénario post-réunion. Votre application peut utiliser les API REST Microsoft Graph pour accéder aux transcriptions et aux enregistrements générés pour une réunion Teams planifiée au préalable.
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 | Comment les API de transcription et d’enregistrement aident... |
|---|---|
| Vous devez obtenir des transcriptions et des enregistrements pour capturer des insights significatifs à partir de plusieurs réunions dans la zone verticale Ventes. Il est fastidieux et inefficace de suivre toutes les réunions et de récupérer manuellement les transcriptions et les enregistrements des réunions. Une fois la réunion terminée, vous devrez examiner les conversations de toutes ces réunions pour obtenir des informations utiles. | L’utilisation des API Graph dans votre application pour récupérer les transcriptions et les enregistrements de réunion les récupère automatiquement de toutes les réunions pertinentes pour votre objectif. Votre application peut recevoir des notifications de réunion et obtenir 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 |
| 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. Le fait de devoir continuellement prendre des notes pour fournir un résumé après la réunion peut entraver le flux de pensées, et vous risquez de ne pas saisir toutes les suggestions précieuses. Après la session, vous devrez analyser la discussion afin de recueillir des points de données pour planifier des améliorations. | 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 |
| Un vendeur d’une entreprise technologique de premier plan doit entrer en contact 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. | Vous pouvez créer 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 en cours d’enregistrement et que le contenu sera 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. |
Vous pouvez récupérer la transcription de réunion, l’enregistrement ou les deux à l’aide des API Graph.
Remarque
Les API permettant d’extraire la transcription de la réunion et d’enregistrer le contenu sont des API limitées. Pour plus d’informations, consultez Modèles de paiement pour les API de réunion.
Pour récupérer la transcription et l’enregistrement d’une réunion particulière :
- Configurer des autorisations sur Microsoft Entra ID pour accéder à la transcription et à l’enregistrement
- Recevoir une notification lorsque les transcriptions et les enregistrements de réunion sont disponibles
- Utiliser les API graphiques pour récupérer les transcriptions
- 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.
Utiliser des autorisations d'application à l'échelle de l'organisation
Vous pouvez configurer votre application pour accéder aux transcriptions et 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.
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.
Recevoir une notification lorsqu’une transcription ou un enregistrement est disponible
Une fois que vous avez configuré les autorisations, configurez votre application pour recevoir des notifications de modification pour les transcriptions et les enregistrements des événements disponibles ou tous les événements de réunion pertinents. Les notifications contiennent l’ID de réunion et l’ID d’organisateur qui facilitent l’accès au contenu et à l’enregistrement de la transcription. 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 celle-ci. 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 en ligne pour un locataire. | • Toutes les transcriptions d’un organization :communications/onlineMeetings/getAllTranscripts• Tous les enregistrements dans un organization : communications/onlineMeetings/getAllRecordings |
| Niveau de réunion | Une transcription ou un enregistrement est disponible pour une réunion en ligne 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 |
| Limité à l’utilisateur | Une transcription ou un enregistrement est disponible pour toute réunion en ligne organisée par un utilisateur spécifique. | • Une transcription d’appel qui devient disponible dans une réunion organisée par un utilisateur spécifique : users/{userId}/onlineMeetings/getAllTranscripts • Un enregistrement d’appel qui devient disponible dans une réunion organisée par un utilisateur spécifique : users/{userId}/onlineMeetings/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. | • Transcription d’appel qui devient disponible dans une réunion où une application Teams particulière est installée : appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllTrancripts • Un enregistrement d’appel qui devient disponible dans une réunion où une application Teams particulière est installée : 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, 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.
Remarque
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 uniquement en charge les réunions planifiées.