Referência do Teams (pré-visualização)

Descrição geral

Ferramentas de chat

mcp_graph_chat_addChatMember

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

Adiciona um membro a um chat usando user@odata.bind, @odata.type, e funções opcionais (membro, proprietário). Devolve um código de erro 409 se o membro já estiver presente, um código de erro 400 para referências de utilizador inválidas, ou um código de erro 403 se as políticas restringirem a adição.

Parâmetros obrigatórios: chat-id, @odata.type, user@odata.bind, funções

mcp_graph_chat_createChat

Ponto final:POST /v1.0/chats

Cria um novo chat no Teams com chatType (oneOnOne requer exatamente dois participantes, o grupo exige mais de dois) e membros. Devolve 400 se oneOnOne tiver o número errado de membros, 409 se os mesmos participantes já tiverem conversa, ou 403 se o interlocutor não tiver direitos.

Parâmetros exigidos:chatType, membros

mcp_graph_chat_deleteChat

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

Elimina de forma recuperável um chat. Devolve um 403 se faltar permissão ou um 404 se já tiver sido eliminado. As políticas de retenção de inquilinos regem esta operação.

Parâmetros obrigatórios: chat-id

mcp_graph_chat_deleteChatMessage

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

Apaga suavemente uma mensagem de chat. Devolve um 403 sem Chat.ReadWrite, um 404 para IDs inválidos, e pode ainda assim manter a mensagem para conformidade.

Parâmetros necessários: user-id, chat-id, chatMessage-id

mcp_graph_chat_getChat

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

Obtém um chat pelo ID. Devolve metadados como tipo e tópico. Devolve um 404 se o chat não existir ou não for visível, ou um 403 se as permissões forem negadas.

Parâmetros obrigatórios: chat-id

mcp_graph_chat_getChatMessage

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

Recupera uma mensagem de chat por identificação. Devolve um 404 se a mensagem não existir ou estiver oculta, ou um 403 sem os direitos adequados.

Parâmetros obrigatórios: chat-id, message-id

mcp_graph_chat_listChatMembers

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

Lista os participantes do chat. Devolve funções (membro, proprietário ou convidado). Devolve um 403 sem permissões de leitura ou um 404 se o chat não for encontrado.

Parâmetros obrigatórios: chat-id

mcp_graph_chat_listChatMessages

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

Lista mensagens num chat com opcionais $top, $filter, e $orderby. Devolve resultados paginados. A conformidade pode esconder conteúdo. Os erros incluem um 400 para consultas inválidas e um 429 para limitação.

Parâmetros obrigatórios: chat-id

Parâmetros Opcionais:$top, $filter, $orderby

mcp_graph_chat_listChats

Ponto final:GET /v1.0/chats

Lista os chats para o chamador com os parâmetros opcionais $top, $filter, $expand e $orderby. Só devolve conversas visíveis; Conversas ocultas ou do sistema podem ser excluídas. Devolve 400 para expressões de ordenação inválidas.

Parâmetros opcionais:$top, $orderby, $expand, $filter

mcp_graph_chat_postMessage

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

Publica uma nova mensagem em texto simples num chat. Precisa de chat-id e nonempty body.content; Só é suportado texto. Pode devolver um 429 por limitação, um 403 se faltarem permissões, ou um 404 se o chat for inválido. Não é idempotent—avoid evitar novas tentativas cegas.

Parâmetros necessários: chat-id, corpo

mcp_graph_chat_updateChat

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

Atualiza propriedades de chat, como o tema apenas para chats de grupo. Falha com 400 se utilizado numa conversa entre duas pessoas, 403 sem direitos ou 404 se o chat não for encontrado.

Parâmetros obrigatórios: chat-id, tópico

mcp_graph_chat_updateChatMessage

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

Atualiza uma mensagem de chat com novo conteúdo em texto simples. Algumas mensagens de sistema ou de conformidade bloqueiam a edição. A operação devolve um 403 ou 400 se a edição não for permitida, ou um 409 em caso de conflitos.

Parâmetros obrigatórios: chat-id, message-id

Ferramentas para canais e equipas

mcp_graph_teams_addChannelMember

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

Adiciona um membro a um canal privado ou partilhado usando user@odata.bind, @odata.type, e funções opcionais (proprietário ou vazio). Falha em canais padrão. Devolve um 409 se o membro já estiver presente, e um 403 se não tiver permissões.

Parâmetros obrigatórios: team-id, channel-id, displayName, funções, user@odata.bind, @odata.type

mcp_graph_teams_createChannel

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

Cria um canal numa equipa com displayName, descrição opcional, membershipType (padrão, privado, partilhado) e membros opcionais. Os canais privados ou partilhados exigem membros explícitos. Duplicados ou uma associação inválida originam um erro 400 ou 409.

Parâmetros necessários: team-id, displayName

Parâmetros opcionais: descrição, tipoDeMembro, membros

mcp_graph_teams_createPrivateChannel

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

Cria um canal privado definindo membershipType para private. Deve incluir membros ao criar o canal, e a lista de membros deve ter pelo menos um proprietário. Devolve um 400 se os membros estiverem em falta, um 409 para nomes duplicados, ou um 403 se o chamador não tiver permissões.

Parâmetros obrigatórios: team-id, displayName, membros

mcp_graph_teams_getChannel

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

Obtém um canal com $select e $filter opcionais. Devolve um 404 se o canal não for encontrado ou se o chamador não tiver acesso, um 403 se as permissões forem insuficientes, ou um 400 se filtros não suportados.

Parâmetros obrigatórios: team-id, channel-id

Parâmetros Opcionais:$select$filter

mcp_graph_teams_getTeam

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

Obtém as propriedades da equipa com os parâmetros opcionais $select e $expand. Devolve um 403 ou 404 se a equipa estiver inacessível.

Parâmetros obrigatórios: team-id

Parâmetros Opcionais:$select$expand

mcp_graph_teams_listChannelMembers

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

Lista todos os membros de um canal específico do Microsoft Teams. Devolve metadados sobre cada membro, como identidade, funções e estado de membro. Esta informação é útil para auditar a participação no canal, verificar a adesão antes das atualizações de funções ou garantir a conformidade.

Parâmetros obrigatórios: team-id, channel-id

Parâmetros Opcionais:$top$expand

mcp_graph_teams_listChannelMessages

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

Lista mensagens num canal. Utilize os parâmetros opcionais $top e $expand para personalizar os resultados. Por exemplo, utilize $expand para incluir respostas. A paginação é tratada através de @odata.nextLink. Devolve um 403 sem permissão de leitura ou 400 por opções de consulta inválidas.

Parâmetros obrigatórios: team-id, channel-id

Parâmetros Opcionais:$top$expand

mcp_graph_teams_listChannels

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

Lista os canais de uma equipa. Utilize os parâmetros opcionais $select ou $filter para personalizar os resultados. Retorna canais privados e partilhados apenas se o interlocutor for membro. Falha com um 403 se o chamador não tiver direitos de leitura ou com um 400 em consultas OData inválidas.

Parâmetros obrigatórios: team-id

Parâmetros Opcionais:$select$filter

mcp_graph_teams_listTeams

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

Lista as equipas às quais um utilizador específico pertence. Devolve apenas as associações desse utilizador, não as equipas de inquilinos. Devolve um 403 se o chamador não conseguir consultar o utilizador ou um 404 se o ID for inválido.

Parâmetros necessários: user-id

mcp_graph_teams_postChannelMessage

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

Publica uma mensagem em texto simples num canal. O requer team-id, channel-id e body.content. Devolve um 403 sem o ChannelMessage.Send, um 404 se o canal não for encontrado, ou um 400 se o conteúdo estiver em falta.

Parâmetros obrigatórios: ID da equipa, ID do canal, corpo

mcp_graph_teams_replyToChannelMessage

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

Responde a uma mensagem num canal usando body.content. Só é suportado texto simples. Devolve um 404 se a mensagem principal não for encontrada, um 403 sem direitos, ou um 400 para conteúdo inválido.

Parâmetros obrigatórios: equipa-id, canal-id, mensagem-id, corpo

mcp_graph_teams_updateChannel

Ponto final:PATCH /teams/{team-id}/channels/{channel-id}

Atualiza um canal com uma nova displayName ou descrição. Restrições podem aplicar-se a canais especiais como o General. Devolve um 403 sem direitos, um 409 em nomes duplicados, ou um 400 por entrada inválida.

Parâmetros obrigatórios: team-id, channel-id

Parâmetros opcionais: displayName, descrição

mcp_graph_teams_updateChannelMember

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

Atualiza o papel de um membro num canal privado ou partilhado, mudando de funções. Os canais padrão herdam as funções da equipa e normalmente rejeitam atualizações. Devolve um 400 se tentado nos canais padrão, um 403 se não autorizado, ou um 404 se o membro não for encontrado.

Parâmetros obrigatórios: team-id, channel-id, membership-id, funções

Operações suportadas

• Gestão de chat (criar, ler, atualizar, eliminar)
• Operações de mensagens (enviar, recuperar, editar, eliminar)
• Gestão de canal (criar, configurar, listar)
• Gestão de membros (adicionar, atualizar, listar)
• Operações da equipa (obter, listar)

Principais características

• Operações completas de criar, ler, atualizar e eliminar (CRUD) para chats e canais.
• Suporte para canais privados, partilhados e padrão.
• Encadeamento de mensagens e respostas.
• Gestão do papel dos membros.
• Suporte para consultas OData para filtragem e paginação.