Zum Inhalt springen
Alle Werkzeuge

teams_send_message

Microsoft Teams · macOS · Windows

Wirkung: Senden. Status: bedingt verfügbar.

„Bedingte Verfügbarkeit“ bedeutet, dass das Werkzeug von Version, Plattform, Berechtigungen, Konto oder Konfiguration abhängen kann. Es ist nicht in jeder Installation aktiv.

macOS

Zweck

Sendet eine Textnachricht an einen Microsoft-Teams-Chat als verbundenes Microsoft-365-Konto für Beruf oder Schule (connect_m365_account), über Microsoft 365. Die chat_id MUSS aus teams_list_chats desselben Kontos stammen – erfinden Sie nie IDs. Dies ist ein Schreibvorgang: Der erste Aufruf gibt eine Vorschau zurück, die angibt, wer im Chat ist (oder dass das nicht gelesen werden konnte: chat_unresolved), der zweite Aufruf (mit confirm=true) sendet tatsächlich. Zeigen Sie dem Benutzer diese Teilnehmer vor der Bestätigung, vor allem wenn participants_state nicht "resolved" ist oder has_external_members true ist. sent:true bedeutet, dass Microsoft die Nachricht angenommen hat; teams_search_messages liest den Suchindex von Microsoft, der einem Versand hinterherhinken kann, daher ist eine Suche ohne Treffer direkt nach dem Senden KEIN Beleg dafür, dass das Senden fehlgeschlagen ist.

Erforderliche Eingaben

Die Namen bleiben exakt so erhalten, wie das Werkzeug sie verlangt. Die kanonischen technischen Definitionen auf Englisch stehen im ausklappbaren Schema unten.

Berechtigungen und Bestätigung

Das Schema deklariert einen ausdrücklichen Bestätigungsparameter. Prüfen Sie die Vorschau und autorisieren Sie den echten Vorgang gemäß Plattformvertrag.

Kanonisches technisches Schema auf Englisch — 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"
}

Dokumentationsbeispiel

Dokumentationsbeispiel für teams_send_message. Führen Sie dieses Beispiel nicht aus. Die gezeigten Argumente gehören zu einem fiktiven Datensatz; ermitteln Sie reale Kennungen und holen Sie vor einem echten Aufruf die Genehmigung ein.

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

Windows

Zweck

Sendet eine Nachricht an einen Microsoft-Teams-Chat über die Graph-API. Erfordert connect_m365_account. chat_id muss aus teams_list_chats stammen. Der erste Aufruf gibt eine Vorschau zurück, die angibt, wer im Chat ist (oder dass das nicht gelesen werden konnte: chat_unresolved); setzen Sie confirm=true, um zu senden. Zeigen Sie dem Benutzer diese Teilnehmer vor der Bestätigung, vor allem wenn participants_state nicht "resolved" ist oder has_external_members true ist.

Erforderliche Eingaben

Die Namen bleiben exakt so erhalten, wie das Werkzeug sie verlangt. Die kanonischen technischen Definitionen auf Englisch stehen im ausklappbaren Schema unten.

Berechtigungen und Bestätigung

Das Schema deklariert einen ausdrücklichen Bestätigungsparameter. Prüfen Sie die Vorschau und autorisieren Sie den echten Vorgang gemäß Plattformvertrag.

Kanonisches technisches Schema auf Englisch — 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"
    },
    "chat_id": {
      "description": "Chat ID from teams_list_chats",
      "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",
      "type": "string"
    }
  },
  "required": [
    "chat_id",
    "text"
  ],
  "type": "object"
}

Dokumentationsbeispiel

Dokumentationsbeispiel für teams_send_message. Führen Sie dieses Beispiel nicht aus. Die gezeigten Argumente gehören zu einem fiktiven Datensatz; ermitteln Sie reale Kennungen und holen Sie vor einem echten Aufruf die Genehmigung ein.

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