teams_send_channel_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 über Graph API eine Textnachricht an einen Microsoft Teams-Kanal. Erfordert connect_m365_account mit Chat.ReadWrite-/ChannelMessage.Send-Berechtigungen. team_id und channel_id müssen von teams_list_teams / teams_list_channels stammen. Beim ersten Aufruf wird eine Vorschau zurückgegeben. Stellen Sie confirm=true auf Senden ein.

Erforderliche Eingaben

team_id
channel_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": {
    "channel_id": {
      "description": "Channel ID from teams_list_channels, or the channel's name",
      "type": "string"
    },
    "confirm": {
      "description": "Set true to send; false returns preview",
      "type": "boolean"
    },
    "team_id": {
      "description": "Team ID from teams_list_teams, or the team's name",
      "type": "string"
    },
    "text": {
      "description": "Plain-text message body",
      "type": "string"
    }
  },
  "required": [
    "team_id",
    "channel_id",
    "text"
  ],
  "type": "object"
}

Dokumentationsbeispiel

Dokumentationsbeispiel für teams_send_channel_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.

{
  "channel_id": "demo-channel-001",
  "confirm": false,
  "team_id": "demo-team-001",
  "text": "Can we review the launch checklist on Tuesday?"
}

Windows