Obtenha transcrições e gravações de reuniões usando APIs do Graph

Observação

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

Agora você pode configurar seu aplicativo para buscar transcrições e gravações do Microsoft Teams após o término da reunião ou chamada. Seu aplicativo pode usar APIs REST do Microsoft Graph para acessar e buscar transcrições e gravações geradas para as seguintes instâncias:

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

Casos de uso

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

Caso de uso Descrição Como as APIs ajudam
Busque transcrições e gravações de reuniões automaticamente para instâncias agendadas , como reuniões online Como gerente de vendas, você precisa obter transcrições e gravações para capturar insights significativos de várias reuniões na vertical de vendas. Manter o controle de todas as reuniões e recuperar transcrições e gravações de reuniões manualmente para obter informações úteis é demorado e ineficiente. Use APIs do Graph em seu aplicativo para buscar transcrições e gravações de reuniões automaticamente de todas as reuniões relevantes para sua finalidade. Seu aplicativo recebe notificações de reunião e obtém a transcrição e a gravação quando elas são geradas 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
Busque transcrições e gravações após a 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 que ela terminar, você precisará analisar a discussão para coletar pontos de dados para planejar melhorias. Ter que fazer anotações continuamente para fornecer um resumo pós-reunião pode impedir o fluxo de ideias e você pode não capturar todas as sugestões valiosas. Usar APIs do Graph em seu aplicativo para buscar transcrições e gravações após a reunião libera você e os participantes para se concentrarem totalmente na discussão. 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 um aplicativo personalizado para instâncias agendadas , como reuniões online Como vendedor de uma empresa líder em tecnologia, você deve se conectar com clientes e fechar negócios. Com várias reuniões agendadas por meio do calendário do Teams e do Outlook, é crucial participar de todas as chamadas e manter-se atualizado sobre as discussões e atualizações mais recentes. Crie um aplicativo com as seguintes funcionalidades:
• Notificá-lo quando uma reunião for agendada usando o calendário do Teams ou do Outlook.
• Habilite seu aplicativo para definir AutoRecording=true para essas reuniões.
• Adicione um bot como participante da reunião para exibir uma faixa indicando que a reunião está sendo gravada e que o conteúdo é usado pelo seu aplicativo para análise.
• Permita que seu aplicativo acesse gravações e transcrições de reuniões.
• Permita seu aplicativo sem exigir a aprovação do administrador para as permissões, pois obter a OnlineMeetingRecording.Read.All aprovação do administrador para essas permissões pode ser demorado.
Aqui está um aplicativo de exemplo que mostra esse cenário de caso de uso.
Buscar transcrições e gravações pós-reunião para instâncias ad hoc Como gerente de projetos, sua função exige que você faça chamadas espontâneas em grupo ou individuais, que não podem ser agendadas com antecedência. Sem um convite de reunião, as IDs de reunião não são geradas e, portanto, transcrições e gravações não podem ser acessadas. Fazer anotações abundantes deixa muito espaço para perder itens de ação críticos. Use APIs do Graph em seu aplicativo para buscar transcrições e gravações após a reunião libera você e os participantes para se concentrarem totalmente na discussão. Usando permissões CallTranscripts.Read.All e CallRecordings.Read.All, a transcrição de chamada está disponível para:
• Captura de itens de ação importantes
• Listagem de tarefas ou problemas
• Acompanhamento de reuniões e notificações
Buscar transcrição e gravações pós-chamada para chamadas PSTN Você tem um call center onde assistentes humanos fornecem suporte ao cliente usando chamadas PSTN de entrada ou de saída usando o Microsoft Teams. Os assistentes precisam atualizar manualmente os sistemas externos de registro com notas de cada chamada após o término da chamada. O uso de APIs do Graph em seu aplicativo para buscar transcrições e gravações após a chamada reduz o trabalho manual necessário para cada assistente para atualizar os registros. Além disso, ele permite que seu aplicativo dispare automações usando a transcrição de chamadas.

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

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

  1. Configurar permissões no Microsoft Entra ID para acessar a transcrição e a gravação
  2. Seja notificado quando as transcrições e gravações da reunião estiverem disponíveis
  3. Usar APIs do Graph para buscar a transcrição
  4. Usar APIs do Graph para buscar gravações

Configurar permissões no Microsoft Entra ID para acessar a transcrição e a 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.

Além disso, o acesso a transcrições e notificações de alteração de transcrição é regido por duas configurações de administrador de locatário independente:

  • Acesso à API do Graph às transcrições. Quando desabilitadas, todas as solicitações de transcrição (metadados metadataContente content) retornam 403 Forbidden com o GraphAccessToTranscriptsDisabled código de erro interno, independentemente do formato solicitado.

  • Atribuição do locutor. Quando desabilitado, o conteúdo da transcrição só pode ser recuperado sem informações do application/vnd.microsoft.graph.transcript+text locutor no formato.

Para obter mais informações, consulte as seções sobre controles de administrador de locatários na documentação sobre assinaturas de notificação de alteração e a operação Obter callTranscript.

Observação

  • Novas permissões para adhocCalls (parallel to OnlineMeetings) são necessárias para os recursos acima.
  • Assine dois recursos separados com escopo apropriado (um para onlineMeetings e outro para adhocCalls). Esses recursos fornecem as URLs a serem usadas para buscar os dados.

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

Para reuniões e chamadas online, você pode configurar seu aplicativo para acessar transcrições e gravações de reuniões no 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 autoriza as permissões de aplicativo em toda a organização, seu aplicativo pode ler e acessar transcrições e gravações de 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.

Observação

Permissões baseadas em aplicativo e permissões delegadas pelo usuário são permitidas para chamadas ad hoc.

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

Se você deseja que seu aplicativo busque transcrições e gravações somente para a reunião do Teams em que 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 à 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, consulte Permissões RSC para um chat ou reunião.

Observação

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

Seja notificado quando uma transcrição ou gravação estiver disponível

Depois de configurar as permissões, configure seu aplicativo 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 a ID da reunião e a ID do organizador que ajudam no acesso ao conteúdo e à gravação da transcrição. Seu aplicativo pode buscar a transcrição e a gravação de uma reunião quando elas forem geradas após o término da reunião. Para chamadas ad hoc, a ID da reunião não estará disponível, pois são eventos espontâneos (PSTN, 1:1, chamadas em grupo). Embora não haja restrições no caminho de 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, listagem de artefatos no nível de chamada). 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.

Você pode usar os seguintes tipos de notificação de alteração para seu aplicativo:

Escopo da assinatura Descrição Trajetórias dos recursos com suporte
Nível do locatário Uma transcrição ou gravação está disponível para qualquer reunião online ou chamada para um locatário. Todas as transcrições em uma organização:
• Para reuniões online: communications/onlineMeetings/getAllTranscripts
• Para chamadas: communications/adhocCalls/getAllTranscripts

Todas as gravações em uma organização:
• Para reuniões online: communications/onlineMeetings/getAllRecordings
• Para chamadas: communications/adhocCalls/getAllRecordings
Nível de reunião ou chamada Uma transcrição ou gravação está disponível 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 de 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
Escopo do usuário Uma transcrição ou gravação está disponível para qualquer reunião online, organizada ou chamada ad hoc iniciada por um usuário específico. Uma transcrição de chamada que se torna disponível em uma reunião organizada por um usuário específico ou em uma chamada em que a transcrição é iniciada por um usuário especificado:
• Para reuniões online: users/{userId}/onlineMeetings/getAllTranscripts
• Para chamadas ad hoc: users/{userId}/adhocCalls/getAllTranscripts

Uma gravação de chamada que se torna disponível em uma reunião organizada por um usuário específico ou em uma chamada em que a transcrição é iniciada por um usuário especificado:
• Para reuniões online: users/{userId}/onlineMeetings/getAllRecordings
• Para chamadas ad hoc: users/{userId}/adhocCalls/getAllRecordings
No escopo do aplicativo Uma transcrição ou gravação está disponível para qualquer reunião em que um aplicativo específico do teams esteja instalado. Não aplicável para chamadas ad hoc. Uma transcrição de chamada que fica disponível em uma reunião em que um determinado aplicativo do Teams está instalado:
• Para reuniões online: appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllTranscripts

Uma gravação de chamada que se torna disponível em uma reunião em que um determinado aplicativo do Teams está instalado:
• Para reuniões online: appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllRecordings

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 ou chamada ad hoc, consulte Seja notificado quando as transcrições e gravações estiverem disponíveis.

Para obter mais informações sobre como seu aplicativo pode saber quando as reuniões terminam, consulte inscrever-se para alterar notificações e usar o Bot Framework para obter a ID da reunião e a ID do organizador.

Importante

  • 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.
  • Essas APIs dão suporte a reuniões de chat privadas, reuniões de canal e chamadas ad hoc somente na versão beta.
  • Para chamadas ad hoc:

Obtenha resumos de reuniões gerados por IA para instâncias de reunião online

Seu aplicativo pode buscar diretamente resumos de reuniões gerados por IA, incluindo resumos de conversas, itens de ação e menções usando a API de Insights da IA de Reunião. Para obter mais informações, consulte Obter insights de reuniões com a API de Insights da IA de Reunião.

Exemplos de código

Nome do exemplo Descrição Node.js C# Python
Reuniões de bot Este exemplo demonstra como lidar com eventos de reunião em tempo real e recuperar transcrições de reuniões no Microsoft Teams. View View View
Gravações de transcrições de reuniões online Este aplicativo de exemplo recupera transcrições e gravações de reuniões do Teams usando APIs do Graph. View View NA
Transcrições e gravações de chamadas ad hoc Este aplicativo de exemplo recupera transcrições e gravações de reuniões usando APIs do Graph para chamadas ad hoc, incluindo PSTN, 1:1 e chamadas de grupo. View NA NA

Próxima etapa

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

Confira também

  • Last updated on