teams_call_history

Microsoft Teams · macOS · Windows

Effetto: lettura. Stato: disponibilità condizionata.

«Disponibilità condizionata» indica che lo strumento può dipendere da versione, piattaforma, autorizzazioni, account o configurazione. Non è necessariamente attivo ovunque.

macOS

Scopo

Elenca le chiamate e le riunioni di Microsoft Teams terminate nelle 50 chat più recenti dell'account, dalla più recente, da Microsoft 365: tipo di chiamata (call, meeting o screenShare), partecipanti, orari di inizio e fine e durata. Le chiamate fuori da una chat (chiamate telefoniche, riunioni di calendario senza chat) non vengono elencate e Microsoft non dice chi ha avviato una chiamata né se ha ricevuto risposta: direction e answered sono sempre vuoti. since/until facoltativi (YYYY-MM-DD) restringono l'intervallo. Esamina le 50 chat più recenti e, in ciascuna, i 50 messaggi più recenti non eliminati (leggendo al massimo 20 pagine da 50). Una chat che l'account non può leggere (403 o 404) viene saltata e conteggiata in skipped_chats. Quando la lettura viene interrotta (da quel limite o perché la chiamata ha esaurito il tempo) la risposta ha truncated: true. Richiede un account Microsoft 365 di lavoro o scuola collegato con connect_m365_account (gli account Microsoft personali non hanno letture di Teams). Quando non è collegato alcun account Microsoft 365, legge invece la cache locale dell'app Teams su questo Mac (richiede Accesso completo al disco, può essere indietro di ore o giorni); la source della risposta indica quale ha risposto (graph o local_cache).

Input obbligatori

Lo schema di questa piattaforma non dichiara input obbligatori. Possono comunque esistere selettori facoltativi o requisiti di esecuzione.

Autorizzazioni e conferma

Lo schema non dichiara un parametro di conferma esplicito. Ciò non autorizza azioni senza permesso: controlla l’effetto e ottieni l’autorizzazione.

Utilizza solo le app, gli account e le risorse autorizzate dall'utente su questa piattaforma. Consulta la descrizione specifica della piattaforma di questo strumento per i suoi requisiti di connessione e autorizzazione; questo catalogo non afferma ambiti OAuth aggiuntivi o diritti del sistema operativo.

Schema tecnico canonico in inglese — 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"
}

Esempio documentale

Esempio di documentazione per teams_call_history. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.

{
  "limit": 5
}

Windows

Scopo

Legge la cronologia delle chiamate e delle riunioni di Microsoft Teams tramite Microsoft Graph (l'account Microsoft 365 collegato), ricavata dagli eventi di fine chiamata nelle tue chat recenti di Teams. Ogni chiamata include partecipanti, orari di inizio / fine, durata, tipo di chiamata e un id di chiamata stabile. since/until facoltativi (YYYY-MM-DD) restringono l'intervallo, ad es. un raccoglitore giornaliero estrae le chiamate del giorno precedente. Esamina le 50 chat più recenti e, in ciascuna, i 50 messaggi più recenti non eliminati (leggendo al massimo 20 pagine da 50). Una chat che l'account non può leggere (403 o 404) viene saltata e conteggiata in skipped_chats. Quando la lettura viene interrotta (da quel limite o perché la chiamata ha esaurito il tempo) la risposta ha truncated: true.

Input obbligatori

Lo schema di questa piattaforma non dichiara input obbligatori. Possono comunque esistere selettori facoltativi o requisiti di esecuzione.

Autorizzazioni e conferma

Lo schema non dichiara un parametro di conferma esplicito. Ciò non autorizza azioni senza permesso: controlla l’effetto e ottieni l’autorizzazione.

Utilizza solo le app, gli account e le risorse autorizzate dall'utente su questa piattaforma. Consulta la descrizione specifica della piattaforma di questo strumento per i suoi requisiti di connessione e autorizzazione; questo catalogo non afferma ambiti OAuth aggiuntivi o diritti del sistema operativo.

Schema tecnico canonico in inglese — 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"
}

Esempio documentale

{
  "limit": 5
}