teams_send_message

Microsoft Teams · macOS · Windows

Effect: verzenden. 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

Verstuurt een tekstbericht naar een Microsoft Teams-chat als een gekoppeld zakelijk of school Microsoft 365-account (connect_m365_account), via Microsoft 365. De chat_id MOET uit teams_list_chats van hetzelfde account komen — verzin nooit id's. Dit is een schrijfbewerking: de eerste aanroep geeft een voorbeeld terug dat zegt wie er in de chat zit (of dat dit niet kon worden gelezen: chat_unresolved), de tweede aanroep (met confirm=true) verstuurt echt. Toon de gebruiker die deelnemers vóór het bevestigen, vooral wanneer participants_state niet "resolved" is of has_external_members true is. sent:true betekent dat Microsoft het bericht heeft geaccepteerd; teams_search_messages leest de zoekindex van Microsoft, die achter kan lopen op een verzending, dus een zoekopdracht zonder resultaat direct na het verzenden is GEEN bewijs dat het verzenden mislukte.

Vereiste invoer

chat_id
text

De namen blijven exact zoals het hulpmiddel ze vereist. De canonieke technische definities in het Engels staan in het uitklapbare schema hieronder.

Machtigingen en bevestiging

Het schema bevat een expliciete bevestigingsparameter. Controleer het voorbeeld en autoriseer de echte bewerking volgens het platformcontract.

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"
    },
    "chat_id": {
      "description": "Chat id from teams_list_chats (e.g. '19:<uuid>_<uuid>@unq.gbl.spaces' for 1:1, '19:<id>@thread.v2' for a group)",
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to actually send. Without it, returns a preview and sends nothing: the preview reads who is in the chat (`chat`: title, participants, participant_count, participants_state, has_external_members), or says chat_unresolved when that could not be read.",
      "type": "boolean"
    },
    "text": {
      "description": "Plain-text message body. Max 28000 chars. No formatting / mentions / attachments.",
      "type": "string"
    }
  },
  "required": [
    "chat_id",
    "text"
  ],
  "type": "object"
}

Documentatievoorbeeld

Documentatievoorbeeld voor teams_send_message. 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.

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

Windows