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 of -kanaal. Microsoft Teams moet actief en aangemeld zijn (bij elke aanroep wordt het token opnieuw uit de lokale cookies van Teams gelezen). De chat_id MOET afkomstig zijn van een eerdere aanroep van teams_list_chats; verzin nooit ID's. Dit is een schrijfbewerking: de eerste aanroep retourneert een voorbeeld, de tweede aanroep (met confirm=true) verzendt daadwerkelijk. sent:true betekent dat het bericht uit het gesprek is teruggelezen (bezorging geverifieerd); vertrouw op DAT veld, niet op een vervolguitlezing: teams_search_messages en teams_read_chat_messages lezen de eigen lokale synchronisatie-index van Teams, die minuten kan achterlopen op een geverifieerde verzending (één waargenomen geval: 3 min, #2285). Een zusteraanroep zonder resultaten direct na het verzenden bewijst NIET dat de verzending is mislukt. Een antwoord met status "sent_unconfirmed" betekent dat de server de POST heeft geaccepteerd maar dat het bericht NIET kon worden geverifieerd; vraag de gebruiker Teams zelf te openen en dit te controleren voordat je aanneemt dat de ontvanger een melding heeft gekregen.

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": {
    "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"
}

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