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

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}

Apaga suavemente uma conversa. 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_grafico_conversa_listarMembrosConversa

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

Lista os participantes do chat. Retorna as 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 da taxa.

Parâmetros obrigatórios: chat-id

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

mcp_graph_chat_listChats

Ponto final:GET /v1.0/chats

Lista conversas para o chamador com 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 novas tentativas às cegas.

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

atualizarConversa_mcp_grafico_conversa

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

Atualiza propriedades de chat, como o tema apenas para chats de grupo. Falha com 400 se usado numa conversa individual, 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 (recuperar, 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.
• Agrupamento de mensagens e respostas.
• Gestão do papel dos membros.
• Suporte para consultas OData para filtragem e paginação.