teams_call_history

Microsoft Teams · macOS · Windows

Efecto: lectura. Estado: disponibilidad controlada.

«Disponibilidad controlada» significa que la herramienta figura en los artefactos publicados y puede depender de versión, plataforma, permisos, cuenta o configuración. Esta referencia no promete que esté activa en todas las instalaciones. Que una herramienta figure para macOS no implica que esté disponible en Windows, ni al revés.

macOS

Propósito

Lista las llamadas y reuniones de Microsoft Teams que terminaron en los 50 chats más recientes de la cuenta, de la más nueva a la más antigua, desde Microsoft 365: tipo de llamada (call, meeting o screenShare), participantes, horas de inicio y fin y duración. Las llamadas fuera de un chat (llamadas telefónicas, reuniones del calendario sin chat) no se listan, y Microsoft no indica quién inició una llamada ni si fue contestada: direction y answered siempre están vacíos. since/until opcionales (YYYY-MM-DD) acotan el rango. Examina los 50 chats más recientes y, en cada uno, sus 50 mensajes más nuevos que no estén eliminados (leyendo como máximo 20 páginas de 50). Un chat que la cuenta no puede leer (403 o 404) se omite y se cuenta en skipped_chats. Cuando la lectura se corta (por ese límite o porque la llamada se quedó sin tiempo), la respuesta incluye truncated: true. Necesita una cuenta de Microsoft 365 de trabajo o escuela conectada con connect_m365_account (las cuentas personales de Microsoft no tienen lecturas de Teams). Cuando no hay ninguna cuenta de Microsoft 365 conectada, lee en su lugar la caché local de la app Teams en este Mac (necesita Acceso total al disco, puede ir horas o días atrasada); el source de la respuesta indica cuál respondió (graph o local_cache).

Entradas obligatorias

El esquema de esta plataforma no declara entradas obligatorias. Aun así, pueden existir selectores opcionales o requisitos de ejecución.

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.

Esquema técnico canónico en inglés — macOS

{
  "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 calls to return (default 50), newest first",
      "type": "integer"
    },
    "since": {
      "description": "Only calls on/after this date, YYYY-MM-DD (optional)",
      "type": "string"
    },
    "until": {
      "description": "Only calls on/before this date, YYYY-MM-DD (optional)",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

Ejemplo documental

Ejemplo de documentación para teams_call_history. 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": 5
}

Windows

Propósito

Lee el historial de llamadas y reuniones de Microsoft Teams mediante Microsoft Graph (la cuenta de Microsoft 365 conectada), derivado de los eventos de fin de llamada de tus chats recientes de Teams. Cada llamada incluye participantes, horas de inicio y fin, duración, tipo de llamada y un id de llamada estable. since/until opcionales (YYYY-MM-DD) acotan el rango; p. ej., un recolector diario obtiene las llamadas del día anterior. Examina los 50 chats más recientes y, en cada uno, sus 50 mensajes más nuevos que no estén eliminados (leyendo como máximo 20 páginas de 50). Un chat que la cuenta no puede leer (403 o 404) se omite y se cuenta en skipped_chats. Cuando la lectura se corta (por ese límite o porque la llamada se quedó sin tiempo), la respuesta incluye truncated: true.

Entradas obligatorias

El esquema de esta plataforma no declara entradas obligatorias. Aun así, pueden existir selectores opcionales o requisitos de ejecución.

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.

Esquema técnico canónico en inglés — Windows

{
  "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 calls to return (default 50), newest first",
      "type": "integer"
    },
    "since": {
      "description": "Only calls on/after this date, YYYY-MM-DD (optional)",
      "type": "string"
    },
    "until": {
      "description": "Only calls on/before this date, YYYY-MM-DD (optional)",
      "type": "string"
    }
  },
  "type": "object"
}

Ejemplo documental

{
  "limit": 5
}