Tutti gli strumenti

teams_send_message

Microsoft Teams · macOS · Windows

Effetto: invio. Stato: disponibilità condizionata.

«Disponibilità condizionata» indica che lo strumento può dipendere da versione, piattaforma, autorizzazioni, account o configurazione. Non è necessariamente attivo ovunque.

macOS

Scopo

Invia un messaggio di testo a una chat o a un canale di Microsoft Teams. Microsoft Teams deve essere in esecuzione e con l’accesso effettuato (a ogni chiamata il token viene letto nuovamente dai cookie locali di Teams). chat_id DEVE provenire da una precedente chiamata a teams_list_chats: non inventare mai gli ID. Questa è un’operazione di scrittura: la prima chiamata restituisce un’anteprima, mentre la seconda (con confirm=true) invia davvero. sent:true significa che il messaggio è stato riletto dalla conversazione (consegna verificata): considera attendibile QUEL campo, non una lettura successiva, perché teams_search_messages e teams_read_chat_messages leggono l’indice di sincronizzazione locale di Teams, che può rimanere indietro di alcuni minuti rispetto a un invio verificato (unico caso osservato: 3 min, #2285). Una lettura correlata senza risultati subito dopo l’invio NON dimostra che l’invio sia fallito. Una risposta con stato "sent_unconfirmed" significa che il server ha accettato la richiesta POST ma NON è stato possibile verificare il messaggio: chiedi all’utente di aprire Teams e controllare direttamente prima di presumere che il destinatario sia stato avvisato.

Input obbligatori

I nomi restano esattamente quelli richiesti dallo strumento. Le definizioni tecniche canoniche in inglese sono nello schema espandibile qui sotto.

Autorizzazioni e conferma

Lo schema dichiara un parametro di conferma esplicito. Controlla l’anteprima e autorizza l’operazione reale secondo il contratto della piattaforma.

Schema tecnico canonico in inglese — 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"
}

Esempio documentale

Esempio di documentazione per teams_send_message. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.

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

Windows

Scopo

Invia Microsoft Teams e restituisce un risultato strutturato per l’uso nelle chiamate successive. Prima di una modifica mostra un’anteprima quando previsto; la modifica reale richiede confirm=true; gli identificatori devono provenire da una chiamata precedente e non vanno inventati; la prima chiamata prepara il risultato e la chiamata confermata esegue l’azione; usa Microsoft Graph API con i permessi richiesti. Parametri, valori e forme tecniche da mantenere invariati: connect_m365_account, chat_id, teams_list_chats, confirm=true.

Input obbligatori

I nomi restano esattamente quelli richiesti dallo strumento. Le definizioni tecniche canoniche in inglese sono nello schema espandibile qui sotto.

Autorizzazioni e conferma

Lo schema dichiara un parametro di conferma esplicito. Controlla l’anteprima e autorizza l’operazione reale secondo il contratto della piattaforma.

Schema tecnico canonico in inglese — Windows
{
  "properties": {
    "chat_id": {
      "description": "Chat ID from teams_list_chats",
      "type": "string"
    },
    "confirm": {
      "description": "Set true to send; false returns preview",
      "type": "boolean"
    },
    "text": {
      "description": "Plain-text message body",
      "type": "string"
    }
  },
  "required": [
    "chat_id",
    "text"
  ],
  "type": "object"
}

Esempio documentale

Esempio di documentazione per teams_send_message. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.

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