teams_list_chats

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 chat di Microsoft Teams di un account Microsoft 365 (messaggi diretti, chat di gruppo e chat di riunione), dalla più recentemente attiva, lette da Microsoft 365. Ogni chat ha il proprio id (per teams_read_chat_messages), un titolo, gli altri partecipanti, il tipo (oneOnOne, group o meeting) e l'ultimo messaggio. participants nomina ogni altro membro; uno il cui nome non è stato possibile leggere compare come "unnamed member" (o "unnamed member (external)"), mai come vuoto. participants_state indica quanto fidarsi: resolved, unresolved (almeno uno senza nome), only_you (nessun altro nella chat) o unknown (non è stato possibile leggere l'elenco dei membri: participant_count e has_external_members sono allora assenti). Legge al massimo 20 pagine da 50 chat. 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 items to return (default 50)",
      "type": "integer"
    }
  },
  "required": [],
  "type": "object"
}

Esempio documentale

Esempio di documentazione per teams_list_chats. 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

Elenca le tue conversazioni di chat recenti di Microsoft Teams tramite Microsoft Graph, usando l'account Microsoft 365 collegato. Legge al massimo 20 pagine da 50 chat. Quando la lettura viene interrotta (da quel limite o perché la chiamata ha esaurito il tempo) la risposta ha truncated: true. participants nomina ogni altro membro; uno il cui nome non è stato possibile leggere compare come "unnamed member" (o "unnamed member (external)"), mai come vuoto. participants_state indica quanto fidarsi: resolved, unresolved (almeno uno senza nome), only_you (nessun altro nella chat) o unknown (non è stato possibile leggere l'elenco dei membri: participant_count e has_external_members sono allora assenti).

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": "Maximum chats to return (default: 50)",
      "type": "number"
    }
  },
  "type": "object"
}

Esempio documentale

{
  "limit": 5
}