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 oder -Kanal. Erfordert, dass Microsoft Teams ausgeführt und angemeldet ist (das Token wird bei jedem Anruf frisch aus den lokalen Cookies von Teams gelesen). Die chat_id MUST stammen aus einem früheren teams_list_chats-Aufruf – erfinden Sie niemals IDs. Dies ist eine Schreiboperation: Der erste Aufruf gibt eine Vorschau zurück, der zweite Aufruf (mit confirm=true) sendet tatsächlich. sent:true bedeutet, dass die Nachricht aus der Konversation zurückgelesen wurde (Zustellung verifiziert) – vertrauen Sie dem Feld THAT, nicht einem Folgelesevorgang: teams_search_messages und teams_read_chat_messages lesen den lokalen Synchronisierungsindex von Teams, der einen verifizierten Versand um Minuten verzögern kann (einzelner beobachteter Fall: 3 Min., Nr. 2285). Ein Geschwisterlesevorgang ohne Ergebnis direkt nach dem Senden ist ein Beweis dafür, dass der Versand fehlgeschlagen ist. Eine Antwort mit dem Status „sent_unconfirmed“ bedeutet, dass der Server die Nachricht POST akzeptiert hat, die Nachricht jedoch überprüft werden konnte – sagen Sie dem Benutzer, er solle Teams selbst öffnen und prüfen, bevor er davon ausgeht, dass der Empfänger benachrichtigt wurde.

Erforderliche Eingaben

chat_id
text

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.

Verwenden Sie auf dieser Plattform nur die vom Benutzer autorisierten Apps, Konten und Ressourcen. Informationen zu den Verbindungs- und Berechtigungsanforderungen finden Sie in der plattformspezifischen Beschreibung dieses Tools. Dieser Katalog beansprucht keine zusätzlichen OAuth-Bereiche oder Betriebssystemberechtigungen.

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

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