teams_read_transcript

macOS

Propósito

Lee la transcripción de una llamada de Microsoft Teams iniciada desde un chat o de una reunión del calendario (transcript_id de teams_list_transcripts) como líneas «HH:MM · persona: texto», en la zona horaria de este equipo, de la más antigua a la más reciente. Solo lectura. Una llamada necesita el permiso de Microsoft 365 CallTranscripts.Read.All, y una reunión OnlineMeetingTranscript.Read.All y OnlineMeetings.Read; un administrador de la organización debe aprobar el de la transcripción: sin él la respuesta es consent_required e indica qué pedirle al administrador. Cuando la organización desactivó el acceso a las transcripciones u oculta quién habló, la respuesta lo dice (speakers: false significa que las líneas no tienen persona). Devuelve como máximo limit líneas (por defecto 500, como máximo 2000); una transcripción más larga tiene truncated: true. Necesita una cuenta de trabajo o escuela de Microsoft 365 conectada con connect_m365_account.

Entradas obligatorias

• transcript_id

Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.

Permisos y confirmación

El esquema no declara un parámetro explícito de confirmación. Esto no autoriza a actuar sin permiso: revisa el efecto y obtén autorización antes de una llamada real.

• Utilice únicamente las aplicaciones, cuentas y recursos autorizados por el usuario en esta plataforma. Consulte la descripción específica de la plataforma de esta herramienta para conocer sus requisitos de conexión y permisos. Este catálogo no afirma alcances OAuth adicionales ni derechos de sistema operativo.

{
  "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"
}

Ejemplo documental

Ejemplo de documentación para teams_read_transcript. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

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