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 API do Graph:
| 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 |
| Um vendedor de uma empresa tecnológica líder tem de se ligar a clientes e fechar negócios. Com várias reuniões agendadas através do Teams e calendário do Outlook, é fundamental assistir a todas as chamadas e manter-se atualizado sobre debates e atualizações mais recentes. | Pode criar uma aplicação com as seguintes capacidades: • Notifique-o quando estiver agendada uma reunião com o Teams ou o calendário do Outlook. • Ative a definição da sua aplicação AutoRecording=true para estas reuniões. • Adicione um bot como participante da reunião para apresentar uma faixa que indica que a reunião está a ser gravada e que o conteúdo será utilizado pela sua aplicação para análise. • Permitir que a sua aplicação aceda a gravações e transcrições de reuniões. • Permita a sua aplicação sem exigir a aprovação do administrador para as OnlineMeetingRecording.Read.All permissões, uma vez que a obtenção da aprovação do administrador para estas permissões pode ser morosa. Eis uma aplicação de exemplo que mostra este cenário de caso de utilização. |
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 Microsoft Entra ID 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 Microsoft Entra ID 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 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.
Receber notificações quando estiver disponível uma transcrição ou gravaçã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.
Pode utilizar os seguintes tipos de notificação de alteração para a sua aplicação:
| Âmbito da Subscrição | Descrição | Trajetórias dos recursos com suporte |
|---|---|---|
| Nível do locatário | Está disponível uma transcrição ou gravação para qualquer reunião online para um inquilino. | • Todas as transcrições numa organização: communications/onlineMeetings/getAllTranscripts• Todas as gravações numa organização: communications/onlineMeetings/getAllRecordings |
| Nível de reunião | Está disponível uma transcrição ou gravação para uma reunião online específica. | • Todas as transcrições de uma reunião específica: communications/onlineMeetings/{onlineMeetingId}/transcripts • Todas as gravações de uma reunião específica: communications/onlineMeetings/{onlineMeetingId}/recordings |
| Âmbito do utilizador | Está disponível uma transcrição ou gravação para qualquer reunião online organizada por um utilizador específico. | • Uma transcrição de chamadas que fica disponível numa reunião organizada por um utilizador específico: users/{userId}/onlineMeetings/getAllTranscripts • Uma gravação de chamada que fica disponível numa reunião organizada por um utilizador específico: users/{userId}/onlineMeetings/getAllRecordings |
| Com âmbito de aplicação | Está disponível uma transcrição ou gravação para qualquer reunião em que esteja instalada uma aplicação teams específica. | • Uma transcrição de chamadas que fica disponível numa reunião onde está instalada uma determinada aplicação do Teams: appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllTrancripts • Uma gravação de chamada que fica disponível numa reunião onde está instalada uma determinada aplicação do Teams: appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllRecordings |
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.