teams_search_messages

Microsoft Teams · macOS · Windows

Effet: lecture. État: disponibilité conditionnelle.

«Disponibilité conditionnelle» signifie que l’outil peut dépendre de la version, de la plateforme, des autorisations, du compte ou de la configuration. Il n’est pas forcément actif partout.

macOS

Objectif

Recherche dans les messages de conversation et de canal Microsoft Teams d'un compte Microsoft 365 avec Microsoft Search : par texte et, facultativement, par expéditeur et plage de dates. Utilisez-le pour trouver où un sujet a été abordé sans connaître la conversation. Les résultats arrivent dans l'ordre de pertinence de Microsoft (et non du plus récent au plus ancien), et body est un extrait autour de la correspondance, pas le message entier ; lisez la conversation avec teams_read_chat_messages pour le reste. Renvoie au plus 100 résultats issus d'au plus 4 pages de la recherche. Lorsque la lecture est interrompue (par cette limite, ou parce que l'appel a manqué de temps), la réponse contient truncated: true. Nécessite un compte professionnel ou scolaire Microsoft 365 connecté avec connect_m365_account (les comptes Microsoft personnels n'ont pas de lectures Teams). Lorsqu'aucun compte Microsoft 365 n'est connecté du tout, il lit à la place le cache local de l'application Teams sur ce Mac (nécessite l'accès complet au disque, peut avoir des heures ou des jours de retard) ; le champ source de la réponse indique lequel a répondu (graph ou local_cache).

Entrées requises

Le schéma de cette plateforme ne déclare aucune entrée requise. Des sélecteurs facultatifs ou des conditions d’exécution peuvent néanmoins exister.

Autorisations et confirmation

Le schéma ne déclare aucun paramètre de confirmation explicite. Cela n’autorise aucune action sans permission : vérifiez l’effet et obtenez une autorisation.

Utilisez uniquement les applications, comptes et ressources autorisés par l'utilisateur sur cette plateforme. Consultez la description spécifique à la plate-forme de cet outil pour connaître ses exigences de connexion et d'autorisation ; ce catalogue ne revendique pas d'étendues OAuth ou de droits d'exploitation supplémentaires pour le système d'exploitation.

Schéma technique canonique en anglais — 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"
}

Exemple documentaire

Exemple de documentation pour teams_search_messages. N’exécutez pas cet exemple. Les arguments présentés appartiennent à un jeu de données fictif ; résolvez les identifiants réels et obtenez une autorisation avant tout appel réel.

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

Windows

Objectif

Recherche dans votre historique de conversations et de messages directs Microsoft Teams (toutes les conversations à la fois) par texte, nom de l'expéditeur et/ou plage de dates. Utilisez-le pour trouver où un sujet a été abordé dans Teams sans connaître la conversation. Renvoie les messages correspondants (les plus pertinents d'abord), chacun avec un extrait et la conversation d'origine. Renvoie au plus 100 résultats issus d'au plus 4 pages de la recherche. Lorsque la lecture est interrompue (par cette limite, ou parce que l'appel a manqué de temps), la réponse contient truncated: true.

Entrées requises

Le schéma de cette plateforme ne déclare aucune entrée requise. Des sélecteurs facultatifs ou des conditions d’exécution peuvent néanmoins exister.

Autorisations et confirmation

Le schéma ne déclare aucun paramètre de confirmation explicite. Cela n’autorise aucune action sans permission : vérifiez l’effet et obtenez une autorisation.

Utilisez uniquement les applications, comptes et ressources autorisés par l'utilisateur sur cette plateforme. Consultez la description spécifique à la plate-forme de cet outil pour connaître ses exigences de connexion et d'autorisation ; ce catalogue ne revendique pas d'étendues OAuth ou de droits d'exploitation supplémentaires pour le système d'exploitation.

Schéma technique canonique en anglais — 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"
}

Exemple documentaire

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