Obter transcrições e gravações de reuniões com as Graph APIs

Observação

As APIs para obter transcrições e gravações 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.

Agora pode configurar a sua aplicação para obter transcrições e gravações do Microsoft Teams após o fim da reunião ou chamada. A sua aplicação pode utilizar as APIs REST do Microsoft Graph para aceder e obter transcrições e gravações geradas para as seguintes instâncias:

  • uma reunião online agendada
  • uma chamada ad hoc

Casos de uso

Eis alguns casos de utilização para obter transcrições e gravações de reuniões com API do Graph.

Caso de uso Descrição Como as APIs ajudam
Obter transcrições e gravações de reuniões automaticamente para instâncias agendadas , como reuniões online Enquanto gestor de vendas, tem de obter transcrições e gravações para capturar informações significativas de várias reuniões na vertical Vendas. Controlar todas as reuniões e obter transcrições e gravações de reuniões manualmente das mesmas para obter informações úteis é moroso e ineficiente. Utilize Graph APIs na sua aplicação para obter transcrições e gravações de reuniões automaticamente a partir de todas as reuniões relevantes para o seu objetivo. A sua aplicação recebe notificações de reunião e obtém 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
Obter transcrições e gravações pós-reunião para instâncias agendadas , como reuniões online 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. Depois de terminar, terá de analisar o debate para recolher pontos de dados para melhorar o planeamento. Ter de tomar notas continuamente para fornecer um resumo pós-reunião pode impedir o fluxo de pensamentos e pode não capturar todas as sugestões valiosas. 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
Criar uma aplicação personalizada para instâncias agendadas , como reuniões online Enquanto vendedor numa 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. Crie 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 é 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.
Obter transcrições e gravações pós-reunião para instâncias ad hoc Enquanto gestor de projetos, a sua função requer que faça chamadas espontâneas de grupo ou um-para-um, que não podem ser agendadas previamente. Sem um convite para reunião, os IDs de reunião não são gerados e, por conseguinte, não é possível aceder a transcrições e gravações. Retirar notas copiosas deixa muito espaço para perder itens de ação críticos. Utilizar 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. Ao utilizar permissões CallTranscripts.Read.All e CallRecordings.Read.All, a transcrição de chamadas está disponível para:
• Capturar itens de ação importantes
• Listar tarefas ou problemas
• Acompanhamento de reuniões e notificações
Obter transcrição e gravações pós-chamada para chamadas RTPC Tem um call center onde os assistentes humanos fornecem suporte ao cliente através de chamadas RTPC recebidas ou enviadas através do Microsoft Teams. Os assistentes têm de atualizar manualmente os sistemas externos de registo com notas de cada chamada após o fim da chamada. A utilização de Graph APIs na sua aplicação para obter transcrições e gravações pós-chamada reduz o trabalho manual exigido por cada assistente para atualizar os registos. Além disso, permite que a sua aplicação acione automatizações com a transcrição de chamadas.

Obter transcrições e gravações de reuniões e chamadas

Para obter a transcrição e a gravação de uma determinada reunião e chamada:

  1. Configurar permissões no Microsoft Entra ID para aceder à transcrição e gravação
  2. Receber notificações quando as transcrições e gravações da reunião estiverem disponíveis
  3. Usar APIs do Graph para buscar a transcrição
  4. 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.

Observação

  • São necessárias novas permissões para adhocCalls (paralelas a OnlineMeetings) para os recursos acima.
  • Subscreva dois recursos separados e com âmbito adequado (um para onlineMeetings e outro para adhocCalls). Estes recursos fornecem os URLs a utilizar para obter os dados.

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

Para reuniões e chamadas online, 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.

Observação

As permissões baseadas na aplicação e as permissões delegadas do utilizador são permitidas para chamadas ad hoc.

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.

Observação

As permissões baseadas em RSC para chamadas ad hoc não estão ativadas.

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 quando disponíveis ou todas as reuniões e chamadas ad hoc relevantes. Para reuniões online, 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 após o fim da reunião. Para chamadas ad hoc, o ID da reunião não estará disponível, uma vez que se trata de eventos espontâneos (RTPC, 1:1, chamadas de grupo). Embora não existam restrições no caminho das notificações para chamadas ad hoc, getAll as APIs também não estão disponíveis para instâncias de chamada ad hoc (por exemplo, lista de artefactos ao nível da chamada). 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 ou chamada para um inquilino. Todas as transcrições numa organização:
• Para reuniões online: communications/onlineMeetings/getAllTranscripts
• Para chamadas: communications/adhocCalls/getAllTranscripts

Todas as gravações numa organização:
• Para reuniões online: communications/onlineMeetings/getAllRecordings
• Para chamadas: communications/adhocCalls/getAllRecordings
Nível de reunião ou chamada Está disponível uma transcrição ou gravação para uma reunião ou chamada específica.
Todas as transcrições de uma reunião específica: communications/onlineMeetings/{onlineMeetingId}/transcripts

Todas as gravações para uma reunião específica: communications/onlineMeetings/{onlineMeetingId}/recordings

Todas as transcrições de uma chamada ad hoc específica: /communications/adhocCalls/{callId}/transcripts

Todas as gravações para uma chamada ad hoc específica: /communications/adhocCalls/{callId}/recordings
Âmbito do utilizador Está disponível uma transcrição ou gravação para qualquer reunião online organizada ou chamada ad hoc iniciada por um utilizador específico. Uma transcrição de chamada que fica disponível numa reunião organizada por um utilizador específico ou numa chamada em que a transcrição é iniciada por um utilizador especificado:
• Para reuniões online: users/{userId}/onlineMeetings/getAllTranscripts
• Para chamadas ad hoc: users/{userId}/adhocCalls/getAllTranscripts

Uma gravação de chamada que fica disponível numa reunião organizada por um utilizador específico ou numa chamada em que a transcrição é iniciada por um utilizador especificado:
• Para reuniões online: users/{userId}/onlineMeetings/getAllRecordings
• Para chamadas ad hoc: users/{userId}/adhocCalls/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. Não aplicável para chamadas ad hoc. Uma transcrição de chamadas que fica disponível numa reunião onde está instalada uma determinada aplicação do Teams:
• Para reuniões online: appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllTranscripts

Uma gravação de chamada que fica disponível numa reunião onde está instalada uma determinada aplicação do Teams:
• Para reuniões online: 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 ou chamada ad hoc, 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.

Importante

  • 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 suportam reuniões de chat privadas, reuniões de canal e chamadas ad hoc apenas em beta.
  • Para chamadas ad hoc:

Obter resumos de reuniões geradas por IA para instâncias de reunião online

A sua aplicação pode obter diretamente resumos de reuniões geradas por IA, incluindo resumos de conversação, itens de ação e menções através da API Insights da IA reunião. Para obter mais informações, veja Obter informações sobre reuniões com a API Insights da IA reunião.

Exemplos de código

Nome do exemplo Descrição Node.js C#
Bot de transcrição de reuniões online Esta aplicação de exemplo obtém transcrições de reuniões com o Microsoft API do Graph e apresenta-as numa caixa de diálogo. View View
Gravações de transcrições de reuniões online Esta aplicação de exemplo obtém transcrições e gravações de reuniões do Teams com as Graph APIs. View View
Transcrições e gravações de chamadas ad hoc Esta aplicação de exemplo obtém transcrições e gravações de reuniões com Graph APIs para chamadas ad hoc, incluindo chamadas RTPC, 1:1 e chamadas de grupo. View

Próxima etapa

Receber notificações quando as transcrições e gravações da reunião estiverem disponíveis

Confira também

  • Last updated on