Obter transcrições e gravações de reunião usando APIs do Graph

  • Artigo

Agora você pode configurar seu aplicativo para buscar transcrições e gravações de reunião do Microsoft Teams no cenário pós-reunião. Seu aplicativo pode usar APIs REST do Microsoft Graph para acessar e buscar transcrições e gravações geradas para uma reunião do Teams agendada previamente.

Aqui estão alguns casos de uso para buscar transcrições e gravações de reunião usando API do Graph:

Caso de uso Como as APIs de transcrição e gravação ajudam...
Você precisa obter transcrições e gravações para capturar insights significativos de várias reuniões na vertical de Vendas. É demorado e ineficiente acompanhar todas as reuniões e recuperar transcrições e gravações de reunião manualmente. Após o fim da reunião, você precisará examinar as conversas em todas essas reuniões para obter informações úteis. O uso de APIs do Graph em seu aplicativo para buscar transcrições e gravações de reunião as recupera automaticamente de todas as reuniões relevantes para sua finalidade. Seu aplicativo pode receber notificações de reunião e obter a transcrição e a gravação quando ela for gerada após o término da reunião. Esses dados podem ser usados para obter:
• Análise agregada de insights e inteligência
• Novos clientes potenciais e destaques
• Acompanhamentos e resumos da reunião
Como uma iniciativa de RH, você está realizando uma sessão de debate para entender e melhorar a saúde e a produtividade dos funcionários. Ter que fazer anotações continuamente para fornecer um resumo pós-reunião pode impedir o fluxo de pensamentos e você pode não capturar todas as sugestões valiosas. Após a sessão, você precisará analisar a discussão para coletar pontos de dados para planejar melhorias. Usar APIs do Graph em seu aplicativo para buscar transcrições e gravações pós-reunião libera você e os participantes a se concentrarem totalmente na discussão. O conteúdo da transcrição e da gravação da reunião está disponível para:
• Análise de envolvimento e sentimento
• Listar tarefas ou problemas
• Acompanhamento de reuniões e notificações

Você pode buscar transcrição de reunião, gravação ou ambos usando APIs do Graph.

Observação

As APIs para buscar a transcrição da reunião e o conteúdo da gravação são APIs limitadas. Para obter mais informações, consulte modelos de pagamento para APIs de reunião.

Para buscar a transcrição e a gravação de uma reunião específica:

Configurar permissões no Microsoft Entra ID para acessar transcrição e gravação

Seu aplicativo deve ter as permissões necessárias para buscar transcrições e gravações. Ele pode acessar e buscar transcrições e gravações para uma reunião do Teams usando permissões de aplicativo em toda a organização ou permissões de aplicativo RSC (consentimento específico do recurso) para uma reunião específica.

Usar permissões de aplicativo em toda a organização

Você pode configurar seu aplicativo para acessar transcrições e gravações de reunião em todo o locatário. Nesse caso, o organizador da reunião não precisa instalar seu aplicativo no chat de reunião do Teams. Quando o administrador do locatário autoriza as permissões de aplicativo em toda a organização, seu aplicativo pode ler e acessar transcrições e gravações para todas as reuniões no locatário.

Para obter mais informações sobre as permissões de aplicativo em toda a organização que podem ser concedidas ao seu aplicativo, consulte permissões de reunião online.

Usar permissões de aplicativo RSC específicas de reunião

Se você quiser que seu aplicativo busque transcrições e gravações somente para a reunião do Teams em que ele está instalado, configure a permissão RSC específica da reunião para seu aplicativo. Os usuários autorizados podem instalar seu aplicativo no chat da reunião. Após o término da reunião, seu aplicativo pode fazer a chamada de API para obter a transcrição e a gravação dessa reunião.

Para obter mais informações sobre as permissões RSC específicas da reunião, confira Permissões RSC para um chat ou reunião.

Depois de configurar as permissões, configure seu aplicativo para receber notificações de alteração para transcrições e gravações de eventos disponíveis ou todos os eventos de reunião relevantes. As notificações contêm ID da reunião e ID do organizador que ajudam a acessar o conteúdo da transcrição e a gravação. Seu aplicativo pode buscar a transcrição e a gravação de uma reunião quando ela é gerada após o término. O conteúdo da transcrição está disponível como .vtt arquivo. A gravação da reunião está disponível como um .mp4 arquivo.

Para obter mais informações sobre como seu aplicativo pode saber quando as reuniões terminam, confira assinar notificações de alteração e usar o Bot Framework para obter a ID da reunião e a ID do organizador.

Para obter mais informações sobre como seu aplicativo pode saber quando uma transcrição ou gravação está disponível após o término da reunião online, consulte ser notificado quando transcrições e gravações estiverem disponíveis.

Observação

O processo para chamar APIs do Graph para acessar e recuperar transcrições e gravações permanece o mesmo para permissões de aplicativo RSC específicas da reunião e permissões de aplicativo em toda a organização. Atualmente, essas APIs dão suporte apenas a reuniões agendadas.

Próxima etapa

Obter a ID da reunião e a ID do organizador

Confira também