Informazioni di riferimento su Work IQ Teams (anteprima)

Strumenti di chat

mcp_graph_chat_addChatMember

Endpoint:POST /v1.0/chats/{chat-id}/members

Aggiunge un membro a una chat usando user@odata.bind, @odata.type e ruoli facoltativi (membro, proprietario). Restituisce un codice di errore 409 se il membro è già presente, un codice di errore 400 per riferimenti utente non validi o un codice di errore 403 se i criteri limitano l'aggiunta.

Parametri obbligatori: chat-id, @odata.type, user@odata.bind, ruoli

mcp_graph_chat_createChat

Endpoint:POST /v1.0/chats

Crea una nuova chat Teams con chatType (oneOnOne richiede esattamente due partecipanti, il gruppo ne richiede più di due) e i membri. Restituisce un valore 400 se oneOnOne il numero di membri non è corretto, 409 se gli stessi partecipanti hanno già una chat o 403 se il chiamante non dispone dei diritti.

Parametri richiesti:chatType componenti

mcp_graph_chat_deleteChat

Endpoint:DELETE /v1.0/chats/{chat-id}

Elimina temporaneamente una chat. Restituisce un codice 403 se l'autorizzazione è assente o un codice 404 se è già stata eliminata ed è soggetta ai criteri di conservazione dell'affittuario.

Parametri obbligatori: chat-id

mcp_graph_chat_deleteChatMessage

Endpoint:POST /v1.0/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/softDelete

Rimuove temporaneamente un messaggio di chat. Restituisce il codice 403 senza Chat.ReadWrite, il codice 404 per ID non validi e potrebbe comunque mantenere il messaggio per garantire la conformità.

Parametri obbligatori: user-id, chat-id, chatMessage-ID

mcp_graph_chat_getChat

Endpoint:GET /v1.0/chats/{chat-id}

Recupera una chat per ID. Restituisce metadati come tipo e argomento. Restituisce un valore 404 se la chat non esiste o non è visibile oppure 403 se le autorizzazioni vengono negate.

Parametri obbligatori: chat-id

mcp_graph_chat_getChatMessage

Endpoint:GET /v1.0/chats/{chat-id}/messages/{message-id}

Recupera un messaggio di chat in base all'ID. Restituisce un valore 404 se il messaggio non esiste o è nascosto oppure 403 senza diritti appropriati.

Parametri obbligatori: chat-id, message-id

mcp_graph_chat_listChatMembers

Endpoint:GET /v1.0/chats/{chat-id}/members

Elenca i partecipanti alla chat. Restituisce i ruoli (membro, proprietario o ospite). Restituisce un valore 403 senza autorizzazioni di lettura o 404 se la chat non viene trovata.

Parametri obbligatori: chat-id

mcp_graph_chat_listChatMessages

Endpoint:GET /v1.0/chats/{chat-id}/messages

Elenca i messaggi in una chat con i facoltativi $top, $filter e $orderby. Restituisce risultati paginati. La conformità potrebbe nascondere il contenuto. Gli errori includono un 400 per richieste non valide e un 429 per limitazioni del traffico.

Parametri obbligatori: chat-id

Parametri facoltativi:$top, $filter, $orderby

mcp_graph_chat_listChats

Endpoint:GET /v1.0/chats

Elenca le chat per il chiamante con facoltativo $top, $filter, $expande $orderby. Restituisce solo chat visibili; le chat nascoste o di sistema potrebbero essere escluse. Restituisce un valore 400 per espressioni di ordinamento non valide.

Parametri facoltativi:$top, $orderby, $expand, $filter

mcp_graph_chat_postMessage

Endpoint:POST /v1.0/chats/{chat-id}/messages

Invia un nuovo messaggio di testo normale in una chat. Richiede chat-id e body.content non vuoto, perché supporta solo testo. Potrebbe restituire un codice 429 per la limitazione della larghezza di banda, un codice 403 se mancano i permessi o un codice 404 se la chat non è valida. Non tentativi di riprova idempotent—avoid alla cieca.

Parametri obbligatori: chat-id, body

mcp_graph_chat_updateChat

Endpoint:PATCH /v1.0/chats/{chat-id}

Aggiorna le proprietà della chat, ad esempio l'argomento solo per le chat di gruppo. Ha esito negativo con 400 se usato in una chat uno a uno, 403 senza diritti o 404 se la chat non è stata trovata.

Parametri obbligatori: chat-id, topic

mcp_graph_chat_updateChatMessage

Endpoint:PATCH /v1.0/chats/{chat-id}/messages/{message-id}

Aggiorna un messaggio di chat con nuovo contenuto di testo normale. Alcuni messaggi di sistema o conformità bloccano la modifica. L'operazione restituisce un valore 403 o 400 se la modifica non è consentita o 409 per i conflitti.

Parametri obbligatori: chat-id, message-id

Strumenti per canali e team

mcp_graph_teams_addChannelMember

Endpoint:POST /v1.0/teams/{team-id}/channels/{channel-id}/members

Aggiunge un membro a un canale privato o condiviso usando user@odata.bind, @odata.type e ruoli facoltativi (proprietario o vuoto). Errore nei canali standard. Restituisce un valore 409 se il membro è già presente e 403 se mancano le autorizzazioni.

Parametri richiesti: team-id, channel-id, displayName, ruoli, user@odata.bind, @odata.type

mcp_graph_teams_createChannel

Endpoint:POST /v1.0/teams/{team-id}/channels

Crea un canale in un team con displayName, descrizione facoltativa, membershipType (standard, privato, condiviso) e membri facoltativi. I canali privati o condivisi richiedono membri espliciti. I duplicati o l'appartenenza non valida causano 400 o 409.

Parametri obbligatori: team-id, displayName

Parametri facoltativi: description, membershipType, members

mcp_graph_teams_createPrivateChannel

Endpoint:POST /v1.0/teams/{team-id}/channels

Crea un canale privato impostando membershipType su private. È necessario includere membri quando si crea il canale e l'elenco dei membri deve avere almeno un proprietario. Restituisce un valore 400 se mancano i membri, 409 per i nomi duplicati o 403 se il chiamante non dispone delle autorizzazioni.

Parametri obbligatori: team-id, displayName, members

mcp_graph_teams_getChannel

Endpoint:GET /v1.0/teams/{team-id}/channels/{channel-id}

Recupera un canale con facoltativo $select e $filter. Restituisce un valore 404 se il canale non viene trovato o se il chiamante non dispone di access, 403 se le autorizzazioni non sono sufficienti o 400 per i filtri non supportati.

Parametri obbligatori: team-id, channel-id

Parametri facoltativi:$select, $filter

mcp_graph_teams_getTeam

Endpoint:GET /v1.0/teams/{team-id}

Recupera le proprietà del team con i componenti opzionali $select e $expand. Restituisce un valore 403 o 404 se il team non è accessibile.

Parametri obbligatori: team-id

Parametri facoltativi:$select, $expand

mcp_graph_teams_listChannelMembers

Endpoint:GET /v1.0/teams/{team-id}/channels/{channel-id}/members

Elenca tutti i membri di un canale Microsoft Teams specifico. Restituisce i metadati relativi a ogni membro, ad esempio identità, ruoli e stato di appartenenza. Queste informazioni sono utili per controllare la partecipazione al canale, verificare l'appartenenza prima degli aggiornamenti dei ruoli o garantire la conformità.

Parametri obbligatori: team-id, channel-id

Parametri facoltativi:$top, $expand

mcp_graph_teams_listChannelMessages

Endpoint:GET /v1.0/teams/{team-id}/channels/{channel-id}/messages

Elenca i messaggi in un canale. Usare i parametri facoltativi $top e $expand per personalizzare i risultati. Ad esempio, usare $expand per includere risposte. L'impaginazione viene gestita tramite @odata.nextLink. Restituisce un valore 403 senza autorizzazione di lettura o 400 per le opzioni di query non valide.

Parametri obbligatori: team-id, channel-id

Parametri facoltativi:$top, $expand

mcp_graph_teams_listChannels

Endpoint:GET /v1.0/teams/{team-id}/allChannels

Elenca i canali in un team. Usare i parametri facoltativi $select o $filter per personalizzare i risultati. Restituisce canali privati e condivisi solo se il chiamante è un membro. Ha esito negativo con un valore 403 se il chiamante non dispone di diritti di lettura o 400 su query OData non valide.

Parametri obbligatori: team-id

Parametri facoltativi:$select, $filter

mcp_graph_teams_listTeams

Endpoint:GET /v1.0/users/{user-id}/joinedTeams

Elenca i team a cui si è unito un utente specifico. Restituisce solo le appartenenze dell'utente, non tutti i team tenant. Restituisce un valore 403 se il chiamante non può eseguire query sull'utente o su 404 se l'ID non è valido.

Parametri obbligatori: user-id

mcp_graph_teams_postChannelMessage

Endpoint:POST /v1.0/teams/{team-id}/channels/{channel-id}/messages

Invia un messaggio di testo normale a un canale. Richiede team-id, channel-id e body.content. Restituisce un valore 403 senza ChannelMessage.Send, 404 se il canale non è stato trovato o 400 se il contenuto non è presente.

Parametri obbligatori: team-id, channel-id, body

mcp_grafica_team_rispondiAlMessaggioDelCanale

Endpoint:POST /v1.0/teams/{team-id}/channels/{channel-id}/messages/{message-id}/replies

Risponde a un messaggio in un canale usando body.content. È supportato solo il testo normale. Restituisce un valore 404 se il messaggio padre non viene trovato, un valore 403 per insufficiente autorizzazione, o un valore 400 per contenuto non valido.

Parametri obbligatori: team-id, channel-id, message-id, corpo

mcp_graph_teams_updateChannel

Endpoint:PATCH /teams/{team-id}/channels/{channel-id}

Aggiorna un canale con un nuovo displayName o una nuova descrizione. Potrebbero applicarsi restrizioni a canali speciali come General. Restituisce un valore 403 senza diritti, 409 per i nomi duplicati o 400 per l'input non valido.

Parametri obbligatori: team-id, channel-id

Parametri facoltativi: displayName, description

mcp_graph_teams_updateChannelMember

Endpoint:PATCH /teams/{team-id}/channels/{channel-id}/members/{membership-id}

Aggiorna il ruolo di un membro in un canale privato o condiviso modificando i ruoli. I canali standard ereditano i ruoli dal team e in genere rifiutano gli aggiornamenti. Restituisce un valore 400 se si tenta di eseguire un tentativo su canali standard, 403 se non è stato autorizzato o 404 se il membro non è stato trovato.

Parametri obbligatori: id-squadra, id-canale, id-membro, ruoli

Operazioni supportate

• Gestione delle chat (creazione, lettura, aggiornamento, eliminazione)
• Operazioni di messaggio (invio, recupero, modifica, eliminazione)
• Gestione dei canali (creazione, configurazione, elenco)
• Gestione dei membri (aggiunta, aggiornamento, elenco)
• Operazioni del team (recuperare, elencare)

Funzionalità chiave

• Operazioni complete di creazione, lettura, aggiornamento ed eliminazione (CRUD) per chat e canali
• Supporto per canali privati, condivisi e standard
• Thread dei messaggi e risposte
• Gestione dei ruoli dei membri
• Supporto delle query OData per il filtro e l'impaginazione