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

Importante

À compter du 25 août 2025, les API Teams répertoriées dans cet article ne sont plus limitées et aucune configuration de facturation n’est requise pour utiliser ces API. Si votre application est configurée pour la facturation, aucune action n’est requise. Cet article est fourni à titre de référence car le cycle de facturation final pour les API Microsoft Teams limitées se termine.

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

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

Cas d'utilisation

Voici quelques cas d’usage pour la récupération de transcriptions et d’enregistrements de réunion à l’aide de l’API Graph.

Cas d’utilisation Description Aide des API
Récupérer automatiquement les transcriptions et enregistrements de réunion pour les instances planifiées telles que les réunions en ligne En tant que directeur des ventes, vous devez obtenir des transcriptions et des enregistrements pour capturer des informations significatives de plusieurs réunions dans le secteur des ventes. Garder un œil sur toutes les réunions et récupérer manuellement les transcriptions et enregistrements de réunion à partir de celles-ci pour obtenir des informations utiles prend du temps et est inefficace. Utilisez les API Graph dans votre application pour récupérer automatiquement les transcriptions et enregistrements de réunion à partir de toutes les réunions pertinentes pour votre objectif. Votre application reçoit les notifications de réunion, ainsi que la transcription et l’enregistrement générés une fois la réunion terminée.
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 après une réunion pour les 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 la discussion terminée, vous devrez analyser la discussion pour rassembler des points de données afin de planifier les améliorations. Le fait de devoir continuellement prendre des notes pour fournir un résumé post-réunion peut entraver le flux de pensées, et vous risquez de ne pas capturer toutes les suggestions utiles. 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 pleinement 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 grande entreprise technologique, vous devez entrer en contact avec les clients et conclure des affaires. Avec de nombreuses réunions planifiées via Teams et le calendrier Outlook, il est essentiel d’assister à 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 du calendrier Teams ou Outlook.
• Activez votre application pour configurer AutoRecording=true 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 transcriptions des réunions.
• Autorisez votre application sans exiger 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 du temps.
Voici un exemple d’application qui illustre ce scénario d’utilisation.
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 programmés à l’avance. 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. Prendre de nombreuses notes laisse beaucoup de place pour manquer des éléments d’action critiques. Utiliser les 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 pleinement sur la discussion. À l’aide des autorisations CallTranscripts.Read.All et CallRecordings.Read.All, la transcription de l’appel est disponible pour :
• Capture des éléments d’action importants
• Répertorier les tâches ou les problèmes
• Réunions de suivi et notifications
Récupérer la transcription et les enregistrements après un appel pour les appels RTC Vous disposez d’un centre d’appels où des assistants humains fournissent une assistance client à l’aide d’appels RTC entrants ou sortants utilisant 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 récupérer la transcription et les enregistrements après un appel réduit le travail manuel requis par chaque assistant pour mettre à jour les enregistrements. Il permet également à votre application de déclencher des automatisations à l’aide de la transcription d’appel.

Obtenir des transcriptions et des enregistrements de réunions et d’appels

Pour extraire la transcription et l’enregistrement d’une réunion et d’un appel particuliers :

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

Configurer les 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 et récupérer des transcriptions et des enregistrements pour une réunion Teams à l’aide d’autorisations d’application à l’échelle de l’organisation ou d’autorisations d’application de consentement spécifiques 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 client indépendants :

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

  • Attribution du locuteur. Lorsqu’elle est désactivée, le contenu de la transcription peut être récupéré uniquement sans informations de l’orateur dans le application/vnd.microsoft.graph.transcript+text format.

Pour plus d’informations, consultez les sections sur les contrôles 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èle à OnlineMeetings) sont requises pour les ressources ci-dessus.
  • Abonnez-vous à deux ressources distinctes et de portée appropriée (l’une pour onlineMeetings et l’autre pour adhocCalls). Ces ressources fournissent les URL à utiliser pour l’extraction des 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 sur le client. 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 de l’application à l’échelle de l’organisation, votre application peut lire et accéder aux transcriptions et aux enregistrements de toutes les réunions du locataire.

Pour plus d’informations sur les autorisations d’application à l’échelle de l’organisation qui peuvent être accordées à votre application, consultez Autorisations pour les réunions 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 à une réunion, consultez Autorisations RSC pour une conversation ou une réunion.

Remarque

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

Être averti lorsqu’une transcription ou un enregistrement est disponible

Après avoir configuré les autorisations, configurez votre application de manière à 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 facilitent l’accès au contenu de la transcription et à l’enregistrement. Votre application peut récupérer la transcription et l’enregistrement d’une réunion lorsqu’ils sont générés une fois la réunion terminée. Pour les appels ad hoc, l’ID de réunion ne sera pas disponible, car il s’agit d’événements spontanés (RTPC, 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 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 .vtt de fichier. L’enregistrement de la réunion est disponible sous forme de .mp4 fichier.

Vous pouvez utiliser les types de notifications 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 ou appel pour un client. Toutes les transcriptions d’une organisation :
• Pour les réunions en ligne : communications/onlineMeetings/getAllTranscripts
• Pour les appels : communications/adhocCalls/getAllTranscripts

Tous les enregistrements d’une organisation :
• Pour les réunions en ligne : communications/onlineMeetings/getAllRecordings
• Pour les appels : communications/adhocCalls/getAllRecordings
Au niveau de la réunion ou de l’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
Étendue à l’utilisateur Une transcription ou un enregistrement est disponible pour toute réunion en ligne organisée ou appel ad hoc initié par un utilisateur spécifique. Une 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

Un 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
À l’échelle 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 pour les appels ad hoc. Une transcription d’appel qui devient disponible dans une réunion dans laquelle une application Teams particulière est installée :
• Pour les réunions en ligne : appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllTranscripts

Un 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 Être averti lorsque les transcriptions et les 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 pour modifier les notifications et utiliser Bot Framework pour obtenir l’ID de réunion et l’ID de l’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 l’organisation.
  • Ces API prennent en charge les réunions de conversation privée, les réunions de canal et les appels ad hoc uniquement en version bêta.
  • Pour les appels ponctuels :

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 récupérer directement les résumés de réunion générés par l’IA, y compris les résumés de conversation, les éléments d’action et les 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 bots Cet échantillon montre comment gérer des é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 des transcriptions de réunion en ligne Cet exemple d’application récupère les transcriptions et enregistrements de réunions Teams à l’aide des API Graph. View View N/A
Appels ad hoc, transcriptions et enregistrements Cet exemple d’application récupère les transcriptions et enregistrements de réunion à l’aide des API Graph pour les appels ad hoc, y compris les appels RTCP, les appels individuels et les appels de groupe. View N/A N/A

Étape suivante

Être averti lorsque les transcriptions et les enregistrements de la réunion sont disponibles

Voir aussi

  • Dernière mise à jour :