Obter transcrições e gravações de reuniões com as Graph APIs
Agora, pode configurar a sua aplicação para obter transcrições e gravações de reuniões do Microsoft Teams no cenário pós-reunião. A sua aplicação pode utilizar as APIs REST do Microsoft Graph para aceder e obter transcrições e gravações geradas para uma reunião do Teams agendada previamente.
Eis alguns casos de utilização para obter transcrições e gravações de reuniões com a Graph API:
| Caso de uso | Como as APIs de Transcrição e Gravação ajudam... |
|---|---|
| Tem de obter transcrições e gravações para capturar informações significativas de várias reuniões na vertical Vendas. É demorado e ineficaz controlar todas as reuniões e obter transcrições e gravações de reuniões manualmente. Após o fim da reunião, você precisará examinar as conversas em todas essas reuniões para obter informações úteis. | A utilização de Graph APIs na sua aplicação para obter transcrições e gravações de reuniões obtém-nas automaticamente de todas as reuniões relevantes para o seu propósito. A sua aplicação pode receber notificações de reunião e obter a transcrição e a gravação quando são geradas após o fim 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. | A utilização de Graph APIs na sua aplicação para obter transcrições e gravações após a reunião liberta-o a si e aos participantes para se concentrarem totalmente no debate. O conteúdo da transcrição e 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 |
Pode obter transcrição de reuniões, gravações ou ambos através de Graph APIs.
Observação
As APIs para obter conteúdo de transcrição e gravação de reuniões são APIs com tráfego limitado. Para obter mais informações, veja modelos de pagamento para as APIs de reunião.
Para obter a transcrição e a gravação de uma determinada reunião:
- Configurar permissões no ID do Microsoft Entra para aceder à transcrição e gravação
- Receber notificações quando as transcrições e gravações da reunião estiverem disponíveis
- Usar APIs do Graph para buscar a transcrição
- Utilizar Graph APIs para obter a gravação
Configurar permissões no ID do Microsoft Entra para aceder à transcrição e gravação
A sua aplicação tem de ter as permissões necessárias para obter transcrições e gravações. Pode aceder e obter transcrições e gravações para uma reunião do Teams através de permissões de aplicações em toda a organização ou permissões de aplicação de consentimento específico do recurso (RSC) para uma determinada reunião.
Usar permissões de aplicativo em toda a organização
Pode configurar a sua aplicação para aceder a transcrições e gravações de reuniões em todo o inquilino. Nesse caso, o organizador da reunião não precisa instalar seu aplicativo no chat de reunião do Teams. Quando o administrador inquilino autoriza as permissões de aplicação em toda a organização, a sua aplicação pode ler e aceder a transcrições e gravações para todas as reuniões no inquilino.
Para obter mais informações sobre as permissões de aplicações em toda a organização que podem ser concedidas à sua aplicação, consulte permissões de reuniões online.
Usar permissões de aplicativo RSC específicas de reunião
Se quiser que a sua aplicação obtenha transcrições e gravações apenas para a reunião do Teams onde está instalada, configure a permissão RSC específica da reunião para a sua aplicação. Os usuários autorizados podem instalar seu aplicativo no chat da reunião. Quando a reunião terminar, a sua aplicação pode fazer a chamada à API para obter a transcrição e gravação dessa reunião.
Para obter mais informações sobre as permissões RSC específicas da reunião, consulte Permissões RSC para uma conversa ou reunião.
Depois de configurar as permissões, configure a sua aplicação 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 o ID da reunião e o ID do organizador que ajudam a aceder ao conteúdo de transcrição e à gravação. A sua aplicação pode obter a transcrição e a gravação de uma reunião quando esta é gerada depois de terminar. O conteúdo da transcrição está disponível como .vtt ficheiro. A gravação da reunião está disponível como um .mp4 ficheiro.
Para obter mais informações sobre como a sua aplicação pode saber quando uma transcrição ou gravação está disponível após o fim da reunião online, consulte Receber notificações quando estiverem disponíveis transcrições e gravações.
Para obter mais informações sobre como a sua aplicação pode saber quando as reuniões terminam, consulte Subscrever notificações de alteração e utilizar o Bot Framework para obter o ID da reunião e o ID do organizador.
Observação
O processo para chamar AS APIs do Graph para aceder e obter transcrições e gravações permanece o mesmo para as permissões de aplicação RSC específicas da reunião e as permissões de aplicações em toda a organização. Estas APIs só suportam reuniões agendadas.