teams_read_chat_messages

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

Legge i messaggi più recenti di una chat di Microsoft Teams (chat_id da teams_list_chats), dal più vecchio, da Microsoft 365. I messaggi eliminati vengono saltati; un evento di sistema (un membro aggiunto, una chiamata) compare come [kind]. Gli orari sono in ISO 8601 nel fuso orario di questo computer, con il relativo scarto (2026-10-11T14:05-03:00). Legge al massimo 20 pagine da 50 messaggi, compresi quelli eliminati. 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

chat_id

I nomi restano esattamente quelli richiesti dallo strumento. Le definizioni tecniche canoniche in inglese sono nello schema espandibile qui sotto.

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"
    },
    "chat_id": {
      "description": "Chat ID from teams_list_chats",
      "type": "string"
    },
    "limit": {
      "description": "Max items to return (default 50)",
      "type": "integer"
    }
  },
  "required": [
    "chat_id"
  ],
  "type": "object"
}

Esempio documentale

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

{
  "chat_id": "demo-chat-001"
}

Windows