Obtención de transcripciones y grabaciones de reuniones mediante graph API

Nota:

Las API para capturar transcripciones y grabaciones de reuniones son API de uso medido. Para obtener más información, consulte Modelos de pago para las API de reunión.

Ahora puede configurar la aplicación para capturar transcripciones y grabaciones de Microsoft Teams después de que finalice la reunión o la llamada. La aplicación puede usar las API 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 Graph API.

Caso de uso Descripción Cómo ayudan las API
Captura automática de transcripciones y grabaciones de reuniones para instancias programadas como reuniones en línea Como administrador de ventas, debe obtener transcripciones y grabaciones para capturar información significativa de varias reuniones en la vertical Ventas. Mantener una pestaña sobre todas las reuniones y recuperar las transcripciones y grabaciones de reuniones manualmente de ellas para obtener información útil es lento e ineficaz. Usa las API de Graph en la aplicación para capturar automáticamente transcripciones y grabaciones de reuniones de todas las reuniones pertinentes para tu propósito. La aplicación recibe notificaciones de reunión 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
Captura de 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. Una vez finalizado, deberá analizar la discusión para recopilar puntos de datos para planear mejoras. Tener que tomar continuamente notas para proporcionar un resumen posterior a la reunión puede impedir el flujo de pensamientos, y es posible que no captures 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 libera a usted y a los participantes para centrarse por completo 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
Creación de una aplicación personalizada para instancias programadas como reuniones en línea Como vendedor de una empresa tecnológica líder, debe conectarse con clientes y cerrar ofertas. Con numerosas reuniones programadas a través de Teams y el calendario de Outlook, es fundamental asistir a todas las llamadas y mantenerse actualizado sobre las discusiones y las últimas actualizaciones. Cree una aplicación con las siguientes funcionalidades:
• Notifíquele cuando se programe una reunión con Teams o el calendario de Outlook.
• Permitir que la aplicación se establezca AutoRecording=true para estas reuniones.
• Agregue un bot como participante de la reunión para mostrar un banner que indica que la reunión se está grabando y que la aplicación usa el contenido para su análisis.
• Permitir que la aplicación acceda a grabaciones y transcripciones de reuniones.
• Permitir la aplicación sin necesidad de aprobación del administrador para los OnlineMeetingRecording.Read.All permisos, ya que la obtención de la 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.
Captura de transcripciones y grabaciones posteriores a la reunión para instancias ad hoc Como administrador de proyectos, su rol requiere que realice llamadas espontáneas de grupo o de uno a uno, que no se pueden programar de antemano. Sin una invitación a una reunión, no se generan identificadores de reunión y, por lo tanto, no se puede acceder a las transcripciones y grabaciones. Quitar notas copiosas deja mucho espacio para perderse los elementos de acción críticos. Use las API de Graph en la aplicación para capturar transcripciones y grabaciones después de la reunión, lo que le libera a usted y a los participantes para centrarse por completo en la discusión. Mediante el uso de permisos CallTranscripts.Read.All y CallRecordings.Read.All, la transcripción de llamadas está disponible para:
• Captura de elementos de acción importantes
• Enumeración de problemas o tareas pendientes
• Reuniones y notificaciones de seguimiento
Captura de transcripciones y grabaciones posteriores a la llamada para llamadas RTC Tiene un centro de llamadas donde los asistentes humanos proporcionan soporte técnico al cliente mediante llamadas RTC entrantes o salientes mediante 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 posteriores a la llamada reduce el trabajo manual requerido por cada asistente para actualizar los registros. También permite que la aplicación desencadene automatizaciones mediante la transcripción de llamadas.

Obtención de transcripciones y grabaciones de reuniones y llamadas

Para capturar la transcripción y la grabación de una reunión y una llamada concretas:

  1. Configuración de permisos en Microsoft Entra ID para acceder a la transcripción y la grabación
  2. Recibir una notificación cuando las transcripciones y las grabaciones de la reunión estén disponibles
  3. Usar las API de Graph para capturar la transcripción
  4. Uso de las API de Graph para capturar la grabación

Configuración de 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.

Nota:

  • Se requieren nuevos permisos para adhocCalls (en paralelo 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 van a usar para capturar los datos.

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

En el caso de las reuniones y llamadas en línea, puede configurar la aplicación para acceder a las transcripciones y grabaciones de reuniones en todo el inquilino. 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 aplicación de toda la organización, la aplicación puede leer y acceder a transcripciones y grabaciones de todas las reuniones del inquilino.

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

Nota:

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

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

Si quieres que la aplicación capture transcripciones y grabaciones solo para la reunión de Teams donde está instalada, configura el permiso RSC específico de la reunión para la 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 de RSC específicos de la reunión, consulte Permisos de RSC para un chat o 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 todas las reuniones pertinentes y llamadas ad hoc. En el caso de las reuniones en línea, las notificaciones contienen el identificador de reunión y el identificador del organizador que ayudan a acceder 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. En el caso de las llamadas ad hoc, el identificador 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 acceso de notificaciones para llamadas ad hoc, getAll las API no están disponibles también para las instancias de llamada ad hoc (por ejemplo, la lista 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 un .mp4 archivo.

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

Ámbito de suscripción Description Rutas de acceso de recursos compatibles
Nivel de inquilino Una transcripción o grabación está disponible para cualquier reunión en línea o llamada para un inquilino. 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 de llamada Una transcripción o grabación está disponible 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 ad hoc iniciada por un usuario específico. Transcripción de llamadas 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/getAllTranscripts
• Para llamadas ad hoc: users/{userId}/adhocCalls/getAllTranscripts

Grabación de llamadas 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 llamadas ad hoc: users/{userId}/adhocCalls/getAllRecordings
Ámbito de aplicación Hay disponible una transcripción o grabación para cualquier reunión en la que esté instalada una aplicación de teams específica. No se aplica a las llamadas ad hoc. Transcripción de llamadas que está disponible en una reunión en la que se instala una aplicación de Teams determinada:
• Para reuniones en línea: appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllTranscripts

Grabación de llamadas que está disponible en una reunión en la que se instala 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 está disponible una transcripción o grabación después de que finalice la reunión en línea o la llamada ad hoc, consulta Recibir notificaciones cuando estén disponibles las transcripciones y grabaciones.

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

Importante

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

Obtención de resúmenes de reuniones generados por IA para instancias de reunión 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 meeting Conclusiones de IA API. Para obtener más información, consulte Obtención de información sobre reuniones con Meeting Conclusiones de IA API.

Ejemplos de código

Ejemplo de nombre Descripción Node.js C#
Bot de transcripción de reuniones en línea Esta aplicación de ejemplo recupera las transcripciones de reuniones mediante Microsoft Graph API y las muestra en un cuadro de diálogo. View View
Grabaciones de transcripciones de reuniones en línea Esta aplicación de ejemplo recupera las transcripciones y grabaciones de reuniones de Teams mediante graph API. View View
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 las llamadas RTC, 1:1 y grupales. View

Paso siguiente

Recibir una notificación cuando las transcripciones y las grabaciones de la reunión estén disponibles

Vea también

  • Last updated on