Gerenciar o acesso à API de transcrição para reuniões do Teams

  • Aplica-se a: Microsoft Teams

APLICA-SE A:Imagem de uma marca de verificação para reuniões simImagem de um x para eventos não

Você pode usar o centro de administração do Teams ou o PowerShell para controlar se agentes e aplicativos podem acessar as transcrições de reuniões do Teams por meio de APIs do Microsoft Graph e se as transcrições incluem atribuição de orador. Você também pode controlar se agentes e aplicativos podem acessar transcrições em tempo real por meio do Work IQ.

Por padrão, o acesso ao Microsoft Graph está desativado, portanto, agentes e aplicativos não podem acessar transcrições de reuniões, independentemente das permissões no nível do aplicativo. O acesso ao QI de trabalho também está desativado por padrão. Para obter detalhes, consulte Gerenciar o acesso do Work IQ a transcrições em tempo real.

Usando o centro de administração do Teams

Para habilitar o acesso à API de transcrição usando o Centro de administração do Teams, siga estas etapas:

  1. Na navegação à esquerda do centro de administração do Teams, vá paraConfigurações de reunião de reuniões>.

  2. Em Acesso à API de transcrição, ative a alternância de acesso do Microsoft Graph para permitir que aplicativos e agentes acessem as transcrições das reuniões.

    Captura de tela da configuração de acesso à API de transcrição no centro de administração do Teams.

  3. Selecione Configurar e faça o seguinte:

    • Para incluir a atribuição do locutor nas transcrições acessadas por meio da API do Graph, ative a opção Incluir atribuição do locutor. Por padrão, a configuração está desabilitada.
    • Para permitir ou bloquear o acesso de aplicativos e agentes individuais às transcrições, use o link do centro de administração do Microsoft Entra para gerenciar as permissões de API para cada aplicativo.

Usando o Windows PowerShell

Para configurar o acesso à API de transcrição usando o PowerShell, use o cmdlet Set-CsTeamsMeetingConfiguration com os seguintes parâmetros:

  • -EnableGraphTranscriptAccess: quando definido como true, os agentes e aplicativos podem acessar as transcrições da reunião por meio de APIs do Graph.
  • -EnableAttributedTranscripts: quando definido como true, as transcrições acessadas por meio de APIs do Graph incluem a atribuição do locutor.

Por exemplo, para habilitar o acesso do Microsoft Graph às transcrições de reunião em sua organização e incluir a atribuição do locutor, execute o seguinte comando:

Set-CsTeamsMeetingConfiguration -EnableGraphTranscriptAccess $true -EnableAttributedTranscripts $true -Identity Global

Gerenciar o acesso do Work IQ às transcrições em tempo real

O Work IQ permite que agentes e aplicativos, incluindo aqueles criados por sua organização, recebam a transcrição de uma reunião ou chamada do Teams enquanto ela está em andamento. A configuração de acesso do Work IQ controla se eles podem. É independente do acesso ao Microsoft Graph e está desativado por padrão.

Importante

O acesso ao Work IQ entra em vigor em 14 de novembro de 2026. Se os aplicativos em sua organização já recebem transcrições em tempo real por meio do Work IQ, ative o acesso ao Work IQ antes dessa data para mantê-los funcionando.

Desativar o acesso ao QI de Trabalho não desativa a transcrição nem altera o acesso ao Microsoft Graph. As experiências de IA da Microsoft AI no Teams, como o Microsoft 365 Copilot, o Facilitador e o resumo inteligente, continuam funcionando conforme configurado.

Ativar o acesso ao QI de Trabalho

No Centro de administração do Teams, vá paraConfigurações de reunião de reunião>. Em Acesso à API de transcrição, ative o acesso ao WorkIQ.

Para usar o PowerShell, execute o cmdlet Set-CsTeamsMeetingConfiguration com o -EnableWorkIQTranscriptAccess parâmetro. Quando definido como true, os agentes e aplicativos podem acessar transcrições em tempo real por meio do Work IQ. Esse parâmetro requer a versão mais recente do módulo PowerShell do Teams.

Set-CsTeamsMeetingConfiguration -EnableWorkIQTranscriptAccess $true -Identity Global

Quando os aplicativos recebem transcrições em tempo real

Ativar o acesso ao QI de trabalho não fornece, por si só, uma transcrição aos aplicativos. Um aplicativo recebe uma transcrição em tempo real somente quando essas condições também são atendidas:

  • A IA é permitida na reunião, conforme mostrado na tabela a seguir.
  • A transcrição está em execução. O QI de trabalho não inicia a transcrição. Para obter mais informações, consulte Gerenciar transcrição e legendas para reuniões do Teams.
  • O aplicativo atua em nome de um usuário conectado e tem as permissões necessárias no Microsoft Entra ID.
  • O QI de Trabalho está habilitado para a organização desse usuário. Para obter mais informações, consulte Habilitar seu locatário para o Work IQ.
Permitir IA em todas as reuniões Acesso ao QI de Trabalho Resultado
Desabilitado Desligado ou ligado Nenhuma transcrição está disponível.
Habilitado Desabilitado As solicitações de QI de trabalho são negadas. Outras experiências de IA funcionam conforme configurado.
Habilitado Habilitado Agentes e aplicativos podem receber a transcrição em tempo real.

Como a configuração é aplicada

  • A organização do organizador decide. O Work IQ usa a configuração da organização que organizou a reunião, não a configuração da organização do aplicativo ou do usuário para o qual o aplicativo atua.
  • As transcrições em andamento continuam. Desativar o acesso ao Work IQ não impede as transcrições que os aplicativos já estão recebendo. Eles continuam até a reunião ou a chamada terminar. Novas solicitações são negadas.
  • As mudanças não são imediatas. Pode levar algum tempo até que uma alteração se aplique a novas solicitações.
  • Os nomes dos oradores estão incluídos. As transcrições em tempo real que os aplicativos recebem por meio do Work IQ incluem nomes de oradores. A configuração Incluir atribuição do locutor se aplica somente ao Microsoft Graph.
  • Última atualização em