Obtener transcripciones y grabaciones de reuniones con las API de Graph

Importante

A partir del 25 de agosto de 2025, ya no se medirá ninguna API de Teams enumerada en este artículo y no se requiere ninguna configuración de facturación para usar estas API. Si la aplicación está configurada para la facturación, no es necesario realizar ninguna acción. Este artículo se proporciona como referencia cuando finaliza el ciclo de facturación final de las API de Microsoft Teams de uso medido.

Ahora puede configurar la aplicación para capturar transcripciones y grabaciones de Microsoft Teams una vez finalizada la reunión o la llamada. La aplicación puede usar las API de REST de Microsoft Graph para acceder y capturar transcripciones y grabaciones generadas para las siguientes instancias:

  • Una reunión en línea programada
  • Una llamada ad hoc

Casos de uso

Estos son algunos casos de uso para capturar transcripciones y grabaciones de reuniones mediante la API de Graph API.

Caso de uso Descripción Cómo ayudan las API
Captura transcripciones y grabaciones de reuniones automáticamente para instancias programadas como reuniones en línea Como director de ventas, necesita obtener transcripciones y grabaciones para capturar información significativa de varias reuniones en la vertical de ventas. Controlar todas las reuniones y recuperar transcripciones y grabaciones de reuniones manualmente para obtener información útil requiere mucho tiempo y es ineficaz. Use las API de Graph en la aplicación para capturar transcripciones y grabaciones de reuniones automáticamente de todas las reuniones relevantes para su propósito. La aplicación recibe las notificaciones de las reuniones y obtiene la transcripción y la grabación cuando se genera una vez finalizada la reunión.
A continuación, estos datos se pueden usar para obtener:
• Conclusiones agregadas y análisis de inteligencia
• Nuevos clientes potenciales y contenidos destacados
• Seguimientos y resúmenes de reuniones
Capturar transcripciones y grabaciones posteriores a la reunión para instancias programadas , como reuniones en línea Como iniciativa de RR. HH., está realizando una sesión de lluvia de ideas para comprender y mejorar la salud y la productividad de los empleados. Cuando termine, deberá analizar la discusión para recopilar puntos de datos para planear mejoras. Tener que tomar notas continuamente para proporcionar un resumen posterior a la reunión puede impedir el flujo de pensamientos y es posible que no capture todas las sugerencias valiosas. El uso de las API de Graph en la aplicación para capturar transcripciones y grabaciones posteriores a la reunión le libera a usted y a los participantes para centrarse completamente en la discusión. El contenido de la transcripción y grabación de la reunión está disponible para:
• Análisis de compromiso y de opiniones
• Enumerar tareas o problemas
• Reuniones y notificaciones de seguimiento
Crear una aplicación personalizada para instancias programadas como reuniones en línea Como vendedor de una empresa tecnológica líder, debe conectarse con los clientes y cerrar tratos. Con numerosas reuniones programadas a través del calendario de Teams y Outlook, es crucial asistir a todas las llamadas y mantenerse actualizado sobre las discusiones y las últimas actualizaciones. Cree una aplicación con las siguientes funcionalidades:
• Le notifica cuando se programa una reunión con el calendario de Teams o Outlook.
• Habilite la aplicación para configurar AutoRecording=true estas reuniones.
• Agregue un bot como participante de la reunión para mostrar un banner que indique que la reunión se está grabando y que la aplicación usa el contenido para el análisis.
• Permita que su aplicación acceda a grabaciones y transcripciones de reuniones.
• Permita la aplicación sin requerir la aprobación del administrador para los permisos, ya que obtener la OnlineMeetingRecording.Read.All aprobación del administrador para estos permisos puede llevar mucho tiempo.
Esta es una aplicación de ejemplo que muestra este escenario de caso de uso.
Capturar transcripciones y grabaciones posteriores a la reunión para instancias ad hoc Como jefe de proyecto, su rol requiere que realice llamadas grupales espontáneas o individuales, que no se pueden programar con antelación. Sin una invitación a la reunión, no se generan identificadores de reunión y, por lo tanto, no se puede acceder a las transcripciones y grabaciones. Tomar notas copiosas deja mucho espacio para perder elementos de acción críticos. El uso de las API de Graph en la aplicación para capturar transcripciones y grabaciones después de la reunión le libera a usted y a los participantes para centrarse completamente en la discusión. Mediante el uso de permisos CallTranscripts.Read.All y CallRecordings.Read.All, la transcripción de la llamada está disponible para:
• Capturar elementos de acción importantes
• Enumerar tareas pendientes o problemas
• Reuniones y notificaciones de seguimiento
Capturar transcripción y grabaciones posteriores a la llamada para llamadas RTC Tiene un centro de llamadas donde los asistentes humanos proporcionan asistencia al cliente mediante llamadas RTC entrantes o salientes con Microsoft Teams. Los asistentes deben actualizar manualmente los sistemas externos de registro con notas de cada llamada una vez finalizada la llamada. El uso de las API de Graph en la aplicación para capturar transcripciones y grabaciones después de la llamada reduce el trabajo manual requerido por cada asistente para actualizar los registros. Además, permite que la aplicación active automatizaciones mediante la transcripción de llamadas.

Obtener transcripciones y grabaciones de reuniones y llamadas

Para obtener la transcripción y la grabación de una reunión y llamada determinadas:

  1. Configure los permisos en Microsoft Entra ID para acceder a la transcripción y la grabación
  2. Reciba una notificación cuando las transcripciones y grabaciones de reuniones estén disponibles
  3. Usar las API de Graph para capturar la transcripción
  4. Use las API de Graph para capturar registros

Configure los permisos en Microsoft Entra ID para acceder a la transcripción y la grabación

La aplicación debe tener los permisos necesarios para capturar transcripciones y grabaciones. Puede acceder y capturar transcripciones y grabaciones para una reunión de Teams mediante permisos de aplicación para toda la organización o permisos de aplicación de consentimiento específico de recursos (RSC) para una reunión determinada.

Además, el acceso a las transcripciones y a las notificaciones de cambio de transcripción se rige por dos configuraciones de administrador de inquilinos independientes:

  • Acceso de la Graph API a las transcripciones. Cuando se deshabilita, todas las solicitudes de transcripción (metadatos metadataContenty content) se devuelven 403 Forbidden con el GraphAccessToTranscriptsDisabled código de error interno, independientemente del formato solicitado.

  • Atribución del hablante. Cuando está deshabilitado, el contenido de la transcripción solo se puede recuperar sin información del hablante en el application/vnd.microsoft.graph.transcript+text formato.

Para obtener más información, consulte las secciones sobre los controles de administrador de inquilinos en la documentación sobre las suscripciones de notificación de cambios y la operación Obtener callTranscript.

Nota:

  • Se requieren nuevos permisos para adhocCalls (paralelos a OnlineMeetings) para los recursos anteriores.
  • Suscríbase a dos recursos independientes y con el ámbito adecuado (uno para onlineMeetings y otro para adhocCalls). Estos recursos proporcionan las direcciones URL que se usarán para obtener los datos.

Usar los permisos de la aplicación para toda la organización

Para reuniones y llamadas en línea, puede configurar la aplicación para acceder a transcripciones y grabaciones de reuniones en todo el espacio empresarial. En este caso, el organizador de la reunión no necesita instalar la aplicación en el chat de reuniones de Teams. Cuando el administrador autoriza los permisos de la aplicación para toda la organización, esta puede leer y acceder a las transcripciones y grabaciones de todas las reuniones del espacio empresarial.

Para obtener más información sobre los permisos de aplicación para toda la organización que se pueden conceder a su aplicación, consulte permisos de reunión en línea.

Nota:

Se permiten permisos basados en aplicaciones y permisos delegados por el usuario para llamadas ad hoc.

Usar los permisos de aplicación RSC específicos de la reunión

Si desea que la aplicación recupere transcripciones y grabaciones solo para la reunión de Teams en la que está instalada, configure el permiso RSC específico de la reunión para su aplicación. Los usuarios autorizados pueden instalar su aplicación en el chat de la reunión. Una vez finalizada la reunión, la aplicación puede realizar la llamada API para obtener la transcripción y la grabación de esa reunión.

Para obtener más información sobre los permisos RSC específicos de la reunión, consulte Permisos RSC para un chat o una reunión.

Nota:

Los permisos basados en RSC para llamadas ad hoc no están habilitados.

Recibir una notificación cuando haya disponible una transcripción o grabación

Después de configurar los permisos, configure la aplicación para recibir notificaciones de cambios para transcripciones y grabaciones cuando estén disponibles, o para todas las reuniones relevantes y llamadas ad hoc. Para las reuniones en línea, las notificaciones contienen el identificador de reunión y el identificador del organizador, que ayudan a obtener acceso al contenido de la transcripción y a la grabación. La aplicación puede capturar la transcripción y la grabación de una reunión cuando se genera una vez finalizada la reunión. Para las llamadas ad hoc, el id. de reunión no estará disponible, ya que se trata de eventos espontáneos (RTC, 1:1, llamadas grupales). Aunque no hay restricciones en la ruta de notificaciones para llamadas ad hoc, getAll las API tampoco están disponibles para instancias de llamadas ad hoc (por ejemplo, listado de artefactos en el nivel de llamada). El contenido de la transcripción está disponible como .vtt archivo. La grabación de la reunión está disponible como archivo .mp4 .

Puede usar los siguientes tipos de notificación de cambios para la aplicación:

Ámbito de la suscripción Description Rutas de acceso de recursos compatibles
Nivel de inquilino Una transcripción o grabación está disponible para cualquier reunión o llamada en línea de un espacio empresarial. Todas las transcripciones de una organización:
• Para reuniones en línea: communications/onlineMeetings/getAllTranscripts
• Para llamadas: communications/adhocCalls/getAllTranscripts

Todas las grabaciones de una organización:
• Para reuniones en línea: communications/onlineMeetings/getAllRecordings
• Para llamadas: communications/adhocCalls/getAllRecordings
Nivel de reunión o llamada Hay disponible una transcripción o grabación para una reunión o llamada específica.
Todas las transcripciones de una reunión específica: communications/onlineMeetings/{onlineMeetingId}/transcripts

Todas las grabaciones de una reunión específica: communications/onlineMeetings/{onlineMeetingId}/recordings

Todas las transcripciones de una llamada ad hoc específica: /communications/adhocCalls/{callId}/transcripts

Todas las grabaciones de una llamada ad hoc específica: /communications/adhocCalls/{callId}/recordings
Ámbito de usuario Hay disponible una transcripción o grabación para cualquier reunión en línea organizada o llamada ad hoc iniciada por un usuario específico. Una transcripción de llamada que está disponible en una reunión organizada por un usuario específico o en una llamada en la que la transcripción la inicia un usuario especificado:
• Para reuniones en línea: users/{userId}/onlineMeetings/getAllTranscripts
• Para convocatorias ad hoc: users/{userId}/adhocCalls/getAllTranscripts

Una grabación de llamada que está disponible en una reunión organizada por un usuario específico o en una llamada en la que un usuario especificado inicia la transcripción:
• Para reuniones en línea: users/{userId}/onlineMeetings/getAllRecordings
• Para convocatorias ad hoc: users/{userId}/adhocCalls/getAllRecordings
Ámbito de aplicación Una transcripción o grabación está disponible para cualquier reunión en la que se instale una aplicación de teams específica. No se aplica a las llamadas ad hoc. Una transcripción de llamada que está disponible en una reunión en la que está instalada una aplicación de Teams determinada:
• Para reuniones en línea: appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllTranscripts

Una grabación de llamada que está disponible en una reunión en la que está instalada una aplicación de Teams determinada:
• Para reuniones en línea: appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllRecordings

Para obtener más información sobre cómo la aplicación puede saber cuándo una transcripción o grabación está disponible después de que finalice la reunión en línea o la llamada ad hoc, consulte Recibir notificaciones cuando las transcripciones y las grabaciones estén disponibles.

Para obtener más información sobre cómo la aplicación puede saber cuándo finalizan las reuniones, consulte suscribirse para cambiar las notificaciones y usar Bot Framework para obtener el identificador de reunión y el identificador de organizador.

Importante

  • El proceso para llamar a las API de Graph con el fin de acceder y recuperar transcripciones y grabaciones sigue siendo el mismo tanto para los permisos de aplicación RSC específicos de la reunión como para los permisos de aplicación de toda la organización.
  • Estas API admiten reuniones de chat privadas, reuniones de canal y llamadas ad hoc solo en versión beta.
  • Para llamadas ad hoc:

Obtener resúmenes de reuniones generados por inteligencia artificial para las instancias de reuniones en línea

La aplicación puede capturar directamente resúmenes de reuniones generados por IA, incluidos resúmenes de conversaciones, elementos de acción y menciones mediante la API de Conclusiones de IA de reuniones. Para obtener más información, consulte Obtener información de la reunión con la API de Conclusiones de IA de reuniones.

Ejemplos de código

Ejemplo de nombre Descripción Node.js C# Python
Reuniones de bots En este ejemplo se muestra cómo controlar los eventos de reuniones en tiempo real y recuperar transcripciones de reuniones en Microsoft Teams. View View View
Grabaciones de transcripciones de reuniones en línea Esta aplicación de ejemplo recupera transcripciones y grabaciones de reuniones de Teams mediante las API de Graph. View View ND
Transcripciones y grabaciones de llamadas ad hoc Esta aplicación de ejemplo recupera transcripciones y grabaciones de reuniones mediante las API de Graph para llamadas ad hoc, incluidas llamadas RTC, 1:1 y de grupo. View ND ND

Paso siguiente

Reciba una notificación cuando las transcripciones y grabaciones de reuniones estén disponibles

Vea también

  • Last updated on