teams_read_transcript

macOS

Finalidade

Lê a transcrição de uma chamada do Microsoft Teams iniciada a partir de um chat ou de uma reunião do calendário (transcript_id de teams_list_transcripts) como linhas «HH:MM · pessoa: texto», no fuso horário deste computador, da mais antiga para a mais recente. Somente leitura. Uma chamada exige a permissão CallTranscripts.Read.All do Microsoft 365, e uma reunião OnlineMeetingTranscript.Read.All e OnlineMeetings.Read; um administrador da organização deve aprovar a das transcrições: sem ela, a resposta é consent_required e diz o que pedir ao administrador. Quando a organização desativou o acesso a transcrições ou oculta quem falou, a resposta diz isso (speakers: false significa que as linhas não têm pessoa). Retorna no máximo limit linhas (padrão 500, no máximo 2000); uma transcrição mais longa traz truncated: true. Requer uma conta de trabalho ou escola do Microsoft 365 conectada com connect_m365_account.

Entradas obrigatórias

• transcript_id

Os nomes são mantidos exatamente como a ferramenta exige. As definições técnicas canónicas em inglês estão no esquema expansível abaixo.

Permissões e confirmação

O esquema não declara um parâmetro explícito de confirmação. Isto não autoriza qualquer ação sem permissão; reveja o efeito e obtenha autorização.

• Utilize apenas os aplicativos, contas e recursos autorizados pelo usuário nesta plataforma. Consulte a descrição específica da plataforma desta ferramenta para saber os requisitos de conexão e permissão; este catálogo não reivindica escopos OAuth adicionais ou direitos de sistema operacional.

{
  "properties": {
    "account": {
      "description": "Which connected Microsoft 365 account to use: its email (UPN), its id from list_m365_accounts, or its display name when unique. Leave it out to use the default account.",
      "type": "string"
    },
    "limit": {
      "description": "Max lines to return (default 500, at most 2000)",
      "type": "integer"
    },
    "transcript_id": {
      "description": "Transcript ID from teams_list_transcripts (call:... or meeting:...)",
      "type": "string"
    }
  },
  "required": [
    "transcript_id"
  ],
  "type": "object"
}

Exemplo documental

Exemplo de documentação para teams_read_transcript. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.

{
  "limit": 200,
  "transcript_id": "demo-transcript-1"
}