teams_search_messages

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

Doorzoekt de Microsoft Teams-chat- en kanaalberichten van een Microsoft 365-account met Microsoft Search: op tekst en optioneel op afzender en datumbereik. Gebruik het om te vinden waar iets is besproken zonder de chat te kennen. Resultaten komen in de relevantievolgorde van Microsoft (niet nieuwste eerst) en body is een fragment rond de overeenkomst, niet het hele bericht; lees de chat met teams_read_chat_messages voor de rest. Retourneert maximaal 100 resultaten uit maximaal 4 pagina's van de zoekopdracht. Wanneer het lezen wordt afgekapt (door die grens, of omdat de aanroep geen tijd meer had) bevat het antwoord truncated: true. Vereist een Microsoft 365-werk- of schoolaccount dat is verbonden met connect_m365_account (persoonlijke Microsoft-accounts hebben geen Teams-leesrechten). Wanneer er helemaal geen Microsoft 365-account is verbonden, wordt in plaats daarvan de lokale cache van de Teams-app op deze Mac gelezen (vereist Volledige schijftoegang, kan uren of dagen achterlopen); source in het antwoord geeft aan welke van de twee 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.

Gebruik uitsluitend de apps, accounts en bronnen waarvoor de gebruiker op dit platform toestemming heeft gegeven. Raadpleeg de platformspecifieke beschrijving van deze tool voor de verbindings- en toestemmingsvereisten; deze catalogus veronderstelt geen aanvullende OAuth-bereiken of OS-rechten.

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"
    },
    "from_sender": {
      "description": "Only messages from this sender (name or email; optional)",
      "type": "string"
    },
    "limit": {
      "description": "Max results (default 25, max 100)",
      "type": "integer"
    },
    "query": {
      "description": "Text to search for",
      "type": "string"
    },
    "since": {
      "description": "Only messages on/after this date, YYYY-MM-DD (optional)",
      "type": "string"
    },
    "until": {
      "description": "Only messages on/before this date, YYYY-MM-DD (optional)",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

Documentatievoorbeeld

Documentatievoorbeeld voor teams_search_messages. 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,
  "query": "launch checklist"
}

Windows

Doel

Doorzoekt uw Microsoft Teams-chat- en directe-berichtenhistorie (alle gesprekken tegelijk) op tekst, naam van de afzender en/of datumbereik. Gebruik dit om te vinden waar iets in Teams is besproken zonder te weten in welke chat. Retourneert overeenkomende berichten (meest relevante eerst), elk met een fragment en de chat waaruit ze komen. Retourneert maximaal 100 resultaten uit maximaal 4 pagina's van de zoekopdracht. Wanneer het lezen wordt afgekapt (door die grens, of omdat de aanroep geen tijd meer had) bevat het antwoord truncated: true.

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.

Gebruik uitsluitend de apps, accounts en bronnen waarvoor de gebruiker op dit platform toestemming heeft gegeven. Raadpleeg de platformspecifieke beschrijving van deze tool voor de verbindings- en toestemmingsvereisten; deze catalogus veronderstelt geen aanvullende OAuth-bereiken of OS-rechten.

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"
    },
    "from_sender": {
      "description": "Filter to a sender by name (optional)",
      "type": "string"
    },
    "limit": {
      "description": "Max results (default 25, max 100)",
      "type": "integer"
    },
    "query": {
      "description": "Text to find in messages",
      "type": "string"
    },
    "since": {
      "description": "Only messages on/after this date, YYYY-MM-DD (optional)",
      "type": "string"
    },
    "until": {
      "description": "Only messages on/before this date, YYYY-MM-DD (optional)",
      "type": "string"
    }
  },
  "type": "object"
}

Documentatievoorbeeld

{
  "limit": 5,
  "query": "launch checklist"
}