teams_read_channel_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

Lit les publications les plus récentes d'un canal Microsoft Teams (team_id issu de teams_list_teams, channel_id issu de teams_list_channels), de la plus ancienne à la plus récente, depuis Microsoft 365. Publications de premier niveau uniquement : les réponses ne sont pas incluses. La lecture des messages de canal exige une autorisation qu'approuve un administrateur de l'organisation Microsoft 365 ; sans elle, la réponse est consent_required et indique quoi faire. Lit au plus 20 pages de 50 publications, supprimées comprises. 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

team_id
channel_id

Les noms restent exactement ceux exigés par l’outil. Les définitions techniques canoniques en anglais figurent dans le schéma dépliable ci-dessous.

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"
    },
    "channel_id": {
      "description": "Channel ID from teams_list_channels",
      "type": "string"
    },
    "limit": {
      "description": "Max items to return (default 50)",
      "type": "integer"
    },
    "team_id": {
      "description": "Team ID from teams_list_teams",
      "type": "string"
    }
  },
  "required": [
    "team_id",
    "channel_id"
  ],
  "type": "object"
}

Exemple documentaire

Exemple de documentation pour teams_read_channel_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.

{
  "channel_id": "demo-channel-001",
  "team_id": "demo-team-001"
}

Windows