Obtención de transcripciones y grabaciones de reuniones mediante graph API
Ahora puede configurar la aplicación para capturar transcripciones y grabaciones de reuniones de Microsoft Teams en el escenario posterior a la reunión. La aplicación puede usar las API REST de Microsoft Graph para acceder y capturar transcripciones y grabaciones generadas para una reunión de Teams programada de antemano.
Estos son algunos casos de uso para capturar transcripciones y grabaciones de reuniones mediante Graph API:
| Caso de uso | Cómo ayudan las API de transcripción y grabación... |
|---|---|
| Debe obtener transcripciones y grabaciones para capturar información significativa de varias reuniones en la vertical Ventas. Es lento e ineficaz realizar un seguimiento de todas las reuniones y recuperar las transcripciones y grabaciones de reuniones manualmente. Una vez finalizada la reunión, deberá examinar las conversaciones en todas esas reuniones para obtener información útil. | El uso de las API de Graph en la aplicación para capturar transcripciones y grabaciones de reuniones las recupera automáticamente de todas las reuniones pertinentes para su propósito. La aplicación puede recibir notificaciones de reunión y obtener 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 |
| 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. 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 capture todas las sugerencias valiosas. Después de la sesión, necesitará analizar la discusión para recopilar datos y planear mejoras. | 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 |
| Un 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. | Puede crear 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 usará 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. |
Puede capturar la transcripción de reuniones, la grabación o ambas mediante graph API.
Nota:
Las API para capturar la transcripción de reunión y el contenido de grabación son API de uso medido. Para obtener más información, consulte Modelos de pago para las API de reunión.
Para capturar la transcripción y la grabación de una reunión determinada:
- Configuración de permisos en Microsoft Entra ID para acceder a la transcripción y la grabación
- Recibir una notificación cuando las transcripciones y las grabaciones de la reunión estén disponibles
- Usar las API de Graph para capturar la transcripción
- 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.
Usar los permisos de la aplicación para toda la organización
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.
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.
Recibir una notificación cuando haya disponible una transcripción o grabación
Después de configurar los permisos, configure la aplicación para que reciba notificaciones de cambios para las transcripciones y las grabaciones de eventos disponibles o todos los eventos de reunión pertinentes. 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. 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 | Descripción | Rutas de acceso de recursos compatibles |
|---|---|---|
| Nivel de inquilino | Una transcripción o grabación está disponible para cualquier reunión en línea para un inquilino. | • Todas las transcripciones de una organización: communications/onlineMeetings/getAllTranscripts• Todas las grabaciones de una organización: communications/onlineMeetings/getAllRecordings |
| Nivel de reunión | Una transcripción o grabación está disponible para una reunión en línea específica. | • Todas las transcripciones de una reunión específica: communications/onlineMeetings/{onlineMeetingId}/transcripts • Todas las grabaciones para una reunión específica: communications/onlineMeetings/{onlineMeetingId}/recordings |
| Ámbito de usuario | Una transcripción o grabación está disponible para cualquier reunión en línea organizada por un usuario específico. | • Transcripción de llamadas que está disponible en una reunión organizada por un usuario específico: users/{userId}/onlineMeetings/getAllTranscripts • Una grabación de llamadas que está disponible en una reunión organizada por un usuario específico: users/{userId}/onlineMeetings/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. | • Transcripción de llamadas que está disponible en una reunión en la que se instala una aplicación de Teams determinada: appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllTrancripts • Una grabación de llamadas que está disponible en una reunión en la que se instala una aplicación de Teams determinada: 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 una vez finalizada la reunión en línea, 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.
Nota:
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 solo admiten reuniones programadas.