teams_send_message

Microsoft Teams · macOS · Windows

Effet: envoi. É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

Envoie un message texte à une discussion ou un canal Microsoft Teams. Nécessite que Microsoft Teams soit en cours d'exécution et connecté (le jeton est lu à partir des cookies locaux de Teams à chaque appel). Le chat_id MUST provient d’un précédent appel teams_list_chats – ne fabriquez jamais d’identifiants. Il s'agit d'une opération d'écriture : le premier appel renvoie un aperçu, le deuxième appel (avec confirm=true) envoie réellement. sent:true signifie que le message a été relu à partir de la conversation (livraison vérifiée) — faites confiance au champ THAT, pas à une lecture de suivi : teams_search_messages et teams_read_chat_messages lisent le propre index de synchronisation local de Teams, ce qui peut retarder un envoi vérifié de quelques minutes (un seul cas observé : 3 min, #2285). Un frère sans résultat lu juste après l'envoi est la preuve que l'envoi a échoué. Une réponse avec le statut « sent_unconfirmed » signifie que le serveur a accepté le POST mais que le message a pu être vérifié. NOT : demandez à l'utilisateur d'ouvrir Teams lui-même et de vérifier avant de supposer que le destinataire a été averti.

Entrées requises

chat_id
text

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 déclare un paramètre de confirmation explicite. Vérifiez l’aperçu et autorisez l’opération réelle conformément au contrat de la plateforme.

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": {
    "chat_id": {
      "description": "Thread id from teams_list_chats (e.g. '19:<uuid>_<uuid>@unq.gbl.spaces' for 1:1, '19:<uuid>@thread.tacv2' for group)",
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to actually send. Without it, returns a preview without making any network call.",
      "type": "boolean"
    },
    "text": {
      "description": "Plain-text message body. Max 28000 chars. No formatting / mentions / attachments in v1.",
      "type": "string"
    }
  },
  "required": [
    "chat_id",
    "text"
  ],
  "type": "object"
}

Exemple documentaire

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

{
  "chat_id": "demo-chat-001",
  "confirm": false,
  "text": "Can we review the launch checklist on Tuesday?"
}

Windows