Vai al contenuto
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 di Microsoft Teams come account Microsoft 365 di lavoro o scuola collegato (connect_m365_account), tramite Microsoft 365. Il chat_id DEVE provenire da teams_list_chats dello stesso account: non inventare mai gli id. È un'operazione di scrittura: la prima chiamata restituisce un'anteprima che indica chi partecipa alla chat (oppure che non è stato possibile leggerlo: chat_unresolved), la seconda chiamata (con confirm=true) invia davvero. Mostra all'utente quei partecipanti prima di confermare, soprattutto quando participants_state non è "resolved" o has_external_members è true. sent:true significa che Microsoft ha accettato il messaggio; teams_search_messages legge l'indice di ricerca di Microsoft, che può essere in ritardo rispetto a un invio, quindi una ricerca senza risultati subito dopo l'invio NON è la prova che l'invio sia fallito.

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

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 un messaggio a una chat di Microsoft Teams tramite l'API Graph. Richiede connect_m365_account. chat_id deve provenire da teams_list_chats. La prima chiamata restituisce un'anteprima che indica chi partecipa alla chat (oppure che non è stato possibile leggerlo: chat_unresolved); imposta confirm=true per inviare. Mostra all'utente quei partecipanti prima di confermare, soprattutto quando participants_state non è "resolved" o has_external_members è 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": {
    "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"
}

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?"
}