Naar de inhoud
Alle hulpmiddelen

teams_list_chats

Microsoft Teams · macOS · Windows

Effect: lezen. Status: voorwaardelijk beschikbaar.

‘Voorwaardelijke beschikbaarheid’ betekent dat het hulpmiddel kan afhangen van versie, platform, machtigingen, account of configuratie. Het is niet in elke installatie actief.

macOS

Doel

Toont de Microsoft Teams-chats van een Microsoft 365-account — directe berichten, groepschats en vergaderchats — het laatst actieve eerst, gelezen uit Microsoft 365. Elke chat heeft zijn id (voor teams_read_chat_messages), een titel, de andere deelnemers, zijn type (oneOnOne, group of meeting) en zijn laatste bericht. participants noemt elk ander lid; iemand van wie de naam niet kon worden gelezen, verschijnt als "unnamed member" (of "unnamed member (external)"), nooit als niets. participants_state zegt hoeveel je kunt vertrouwen: resolved, unresolved (minstens één zonder naam), only_you (niemand anders in de chat) of unknown (de ledenlijst kon niet worden gelezen: participant_count en has_external_members ontbreken dan). Leest maximaal 20 pagina's van 50 chats. Wordt het lezen afgebroken (door die grens, of omdat de aanroep geen tijd meer had), dan bevat het antwoord truncated: true. Vereist een zakelijk of school Microsoft 365-account dat is gekoppeld met connect_m365_account (persoonlijke Microsoft-accounts hebben geen Teams-leesrechten). Is er helemaal geen Microsoft 365-account gekoppeld, dan leest het in plaats daarvan de lokale cache van de Teams-app op deze Mac (vereist Volledige schijftoegang, kan uren of dagen achterlopen); de source van het antwoord zegt welke heeft geantwoord (graph of local_cache).

Vereiste invoer

Het schema van dit platform vermeldt geen vereiste invoer. Optionele selectors of uitvoeringsvereisten kunnen nog steeds gelden.

Machtigingen en bevestiging

Het schema bevat geen expliciete bevestigingsparameter. Dit geeft geen toestemming om te handelen; controleer het effect en vraag autorisatie.

Canoniek technisch schema in het Engels — 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"
}

Documentatievoorbeeld

Documentatievoorbeeld voor teams_list_chats. Voer dit voorbeeld niet uit. De getoonde argumenten verwijzen naar fictieve gegevens; zoek vóór een echte aanroep de werkelijke identificatoren op en vraag toestemming.

{
  "limit": 5
}

Windows

Doel

Toont je recente Microsoft Teams-chatgesprekken via Microsoft Graph, met het gekoppelde Microsoft 365-account. Leest maximaal 20 pagina's van 50 chats. Wordt het lezen afgebroken (door die grens, of omdat de aanroep geen tijd meer had), dan bevat het antwoord truncated: true. participants noemt elk ander lid; iemand van wie de naam niet kon worden gelezen, verschijnt als "unnamed member" (of "unnamed member (external)"), nooit als niets. participants_state zegt hoeveel je kunt vertrouwen: resolved, unresolved (minstens één zonder naam), only_you (niemand anders in de chat) of unknown (de ledenlijst kon niet worden gelezen: participant_count en has_external_members ontbreken dan).

Vereiste invoer

Het schema van dit platform vermeldt geen vereiste invoer. Optionele selectors of uitvoeringsvereisten kunnen nog steeds gelden.

Machtigingen en bevestiging

Het schema bevat geen expliciete bevestigingsparameter. Dit geeft geen toestemming om te handelen; controleer het effect en vraag autorisatie.

Canoniek technisch schema in het Engels — 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"
}

Documentatievoorbeeld

Documentatievoorbeeld voor teams_list_chats. Voer dit voorbeeld niet uit. De getoonde argumenten verwijzen naar fictieve gegevens; zoek vóór een echte aanroep de werkelijke identificatoren op en vraag toestemming.

{
  "limit": 5
}