Microsoft Teams

Visão geral

O Microsoft Teams é a plataforma de colaboração corporativa da Microsoft 365, reunindo chat, videochamadas, canais temáticos e armazenamento de arquivos em um único ambiente. Com a integração no SquadOS, seus agentes podem enviar mensagens em chats e canais, criar e gerenciar equipes, agendar reuniões online, verificar a presença de usuários e pesquisar arquivos e mensagens — tudo de forma automatizada via Microsoft Graph API.

• Site oficial: https://www.microsoft.com/pt-br/microsoft-teams/
• Documentação na Composio: docs.composio.dev/toolkits/microsoft_teams

Autenticação

Esta ferramenta utiliza OAuth 2.0 (OAUTH2) para conectar. Também suporta autenticação de aplicativo (S2S_OAUTH2) para cenários servidor-a-servidor.

Você vai precisar dos seguintes campos:

Campo	Obrigatório	Descrição
client_id	Sim	ID do aplicativo registrado no Azure Entra ID (anteriormente Azure AD).
client_secret	Sim	Segredo do cliente gerado no portal Azure para o aplicativo registrado.
tenant_id	Sim	ID do locatário (tenant) Microsoft 365 da sua organização.

Como obter a credencial

1. Acesse o portal Azure e faça login com uma conta de administrador da organização.
2. Vá em Azure Active Directory (ou Microsoft Entra ID) → Registros de aplicativo → Novo registro.
3. Preencha o nome do aplicativo, selecione o tipo de conta desejado e defina o URI de redirecionamento.
4. Após criar o aplicativo, copie o ID do aplicativo (cliente) e o ID do diretório (locatário).
5. Acesse Certificados e segredos → Novo segredo do cliente, defina a validade e copie o valor gerado.
6. Em Permissões de API, adicione as permissões do Microsoft Graph necessárias (ex.: Chat.ReadWrite, Channel.ReadBasic.All, Team.ReadBasic.All, Presence.Read).
7. Clique em Conceder consentimento do administrador para ativar as permissões.

Dica

Para uso com delegated permissions (OAUTH2), o usuário autorizará o acesso na tela de login da Microsoft. Para application permissions (S2S_OAUTH2), o administrador concede consentimento de forma centralizada no portal Azure — nenhuma interação do usuário final é necessária.

Como conectar no SquadOS

1. Acesse Ferramentas no menu lateral (/admin/tools).
2. Abra a aba Disponíveis e procure por Microsoft Teams.
3. Clique no card para abrir o modal de detalhes e em Conectar.
4. Você é levado para a página de conexão segura hospedada pela Composio, onde autoriza o acesso via OAuth 2.0 com sua conta Microsoft organizacional.
5. Ao concluir, você volta para o SquadOS com a conta conectada e a ferramenta disponível para os agentes. (Detalhes do fluxo em Ferramentas da Organização.)

Ações disponíveis

Nota

Esta integração expõe 163 ações no total. Abaixo estão as principais; a lista completa está na documentação da Composio.

Enviar mensagem em canal

MICROSOFT_TEAMS_TEAMS_POST_CHANNEL_MESSAGE

Publica uma nova mensagem de nível superior em um canal do Microsoft Teams. Use para enviar notificações, alertas ou atualizações automáticas a um canal específico.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
team_id	string	Sim	Identificador único (GUID) do time do Microsoft Teams que contém o canal.
channel_id	string	Sim	Identificador único do canal dentro do time onde a mensagem será publicada.
content	string	Sim	Conteúdo da mensagem. Pode ser texto simples ou HTML, conforme definido por content_type.
content_type	string	Não	Formato do conteúdo: text (padrão) ou html.
subject	string	Não	Assunto da mensagem do canal, em texto simples.
importance	string	Não	Importância da mensagem: normal, high ou urgent. Padrão: normal.
mentions	array	Não	Lista de entidades mencionadas na mensagem. Use com conteúdo HTML contendo tags <at>.
attachments	array	Não	Referências a objetos anexos, como arquivos, abas ou reuniões.
summary	string	Não	Texto resumido para notificações push e visualizações de resumo.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Enviar mensagem em chat

MICROSOFT_TEAMS_TEAMS_POST_CHAT_MESSAGE

Envia uma mensagem (texto ou HTML) para um chat existente no Microsoft Teams. O conteúdo deve ser HTML válido se content_type for html.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
chat_id	string	Sim	Identificador único do chat do Microsoft Teams que receberá a mensagem.
content	string	Sim	Conteúdo da mensagem em texto simples ou HTML (veja content_type).
content_type	string	Não	Formato do conteúdo: text (simples) ou html.
subject	string	Não	Assunto da mensagem, em texto simples.
importance	string	Não	Importância da mensagem: normal, high ou urgent. Padrão: normal.
mentions	array	Não	Lista de entidades mencionadas. Entidades suportadas: usuário, bot, time, canal, chat e tag.
attachments	array	Não	Referências a objetos anexos, como arquivos, abas ou cartões adaptáveis.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Responder mensagem em canal

MICROSOFT_TEAMS_POST_MESSAGE_REPLY

Envia uma resposta a uma mensagem existente em um canal do Microsoft Teams, identificada por message_id.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
team_id	string	Sim	Identificador único (GUID) do time que hospeda o canal. Para canais compartilhados, use o ID do time anfitrião (host team).
channel_id	string	Sim	Identificador único do canal contendo a mensagem a responder. Canais padrão usam o formato 19:{alfanumérico}@thread.tacv2.
message_id	string	Sim	Identificador único da mensagem no canal à qual esta resposta se destina.
content	string	Sim	Corpo da mensagem de resposta. Pode ser texto simples ou HTML, conforme content_type.
content_type	string	Não	Formato do conteúdo: text ou html. Padrão: text.
importance	string	Não	Prioridade da mensagem: normal, high ou urgent.
mentions	array	Não	Lista de entidades mencionadas na resposta.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar chat

MICROSOFT_TEAMS_TEAMS_CREATE_CHAT

Cria um novo chat. Se já existir um chat oneOnOne com os membros especificados, os detalhes desse chat são retornados; chats de grupo são sempre criados como novos. O usuário autenticado DEVE ser incluído como membro.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
chatType	string	Sim	Tipo do chat: oneOnOne (entre dois usuários) ou group (grupo com múltiplos usuários).
members	array	Sim	Lista de membros. O usuário autenticado DEVE ser incluído. Para chat oneOnOne, exatamente dois membros; para grupo, pelo menos dois membros, com um deles com papel owner.
topic	string	Não	Assunto do chat. Obrigatório para chats de grupo; ignorado para oneOnOne.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar time

MICROSOFT_TEAMS_CREATE_TEAM

Cria um novo time no Microsoft Teams, com canais, membros e configurações opcionais.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
displayName	string	Sim	Nome de exibição do time como aparecerá no Microsoft Teams.
visibility	string	Não	Visibilidade do time: private (apenas donos adicionam membros), public (qualquer pessoa da organização pode entrar) ou hiddenMembership. Padrão: public.
description	string	Não	Descrição breve do propósito do time. Máximo de 1024 caracteres.
members	array	Não	Lista de membros iniciais do time. Pelo menos um membro com papel owner é recomendado.
channels	array	Não	Canais a criar no time. O canal General é criado automaticamente.
templateOdataBind	string	Não	Referência ao template do time (ex.: standard, educationClass).

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar canal

MICROSOFT_TEAMS_CREATE_CHANNEL

Cria um novo canal padrão, privado ou compartilhado dentro de um time do Microsoft Teams.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
team_id	string	Sim	GUID do time do Microsoft Teams onde o novo canal será criado.
name	string	Sim	Nome de exibição do novo canal. Máximo de 50 caracteres. Não pode conter os caracteres ~ # % & * { } + / \ : < > ? | ' " , ou iniciar com _ ou ..
description	string	Não	Descrição opcional do propósito do canal. Máximo de 1024 caracteres.
membership_type	string	Não	Tipo de acesso: standard (todos os membros do time), private (subconjunto de membros) ou shared (pode incluir pessoas fora do time).
is_favorite_by_default	boolean	Não	Se o canal deve ser marcado como recomendado para todos os membros.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar times

MICROSOFT_TEAMS_TEAMS_LIST

Recupera os times do Microsoft Teams acessíveis pelo usuário autenticado, com suporte a filtro, seleção de propriedades e paginação.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
top	integer	Não	Número máximo de times a retornar por página (1–999).
filter	string	Não	String de filtro OData v4.0 (ex.: startsWith(displayName,'A')).
select	string	Não	Propriedades do time separadas por vírgula a recuperar (ex.: id,displayName,description).
count	boolean	Não	Quando true, inclui o total de itens na propriedade @odata.count da resposta.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar canais do time

MICROSOFT_TEAMS_TEAMS_LIST_CHANNELS

Recupera os canais de um time do Microsoft Teams, com opções para incluir canais compartilhados, filtrar resultados e selecionar propriedades.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
team_id	string	Sim	Identificador único (GUID/UUID) do time do Microsoft Teams.
filter	string	Não	Expressão de filtro OData v4 (ex.: startswith(displayName,'Sales') ou membershipType eq 'private').
select	string	Não	Propriedades do canal separadas por vírgula a retornar (ex.: id,displayName,description).
include_shared_channels	boolean	Não	Se true, inclui canais compartilhados com o time.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar mensagens do canal

MICROSOFT_TEAMS_TEAMS_LIST_CHANNEL_MESSAGES

Lista mensagens de um canal do Teams quando team_id e channel_id são conhecidos. Use para enumerar o histórico de mensagens e obter message_id para operações subsequentes.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
team_id	string	Sim	Identificador único (GUID) do time do Microsoft Teams.
channel_id	string	Sim	Identificador único do canal dentro do time.
top	integer	Não	Número máximo de mensagens a retornar por página (1–50).
expand	string	Não	Parâmetro de expansão. Apenas replies é suportado, incluindo respostas às mensagens (até 1.000 por mensagem).

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar membros do time

MICROSOFT_TEAMS_LIST_TEAM_MEMBERS

Lista os membros de um time do Microsoft Teams. Use para auditorias de acesso ou envio de notificações direcionadas.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
team_id	string	Sim	GUID do time do Microsoft Teams do qual recuperar os membros.
top	integer	Não	Número máximo de membros a solicitar por página (1–999).
filter	string	Não	Expressão de filtro OData opcional para filtrar membros por userId, displayName ou email.
select	string	Não	Lista de propriedades separadas por vírgula a incluir na resposta (ex.: id,displayName,email).
next_link	string	Não	URL @odata.nextLink opaca retornada por uma resposta anterior para paginação.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Adicionar membro ao time

MICROSOFT_TEAMS_ADD_TEAM_MEMBER

Adiciona um usuário a um time do Microsoft Teams. Use ao conceder ou atualizar a associação de um usuário.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
team_id	string	Sim	ID único (GUID) do time ao qual o membro será adicionado.
user_id	string	Sim	Graph ID (GUID) ou userPrincipalName (e-mail) do usuário a adicionar. Usuários convidados devem ser referenciados por ID de objeto.
roles	array	Não	Papéis a atribuir ao membro: ['owner'] para dono do time ou ['guest'] para convidado. Omita para adicionar como membro padrão.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Remover membro do time

MICROSOFT_TEAMS_REMOVE_TEAM_MEMBER

Remove um membro de um time do Microsoft Teams.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
team_id	string	Sim	Identificador único do time.
membership_id	string	Sim	Identificador único da associação do membro no time.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar reunião online

MICROSOFT_TEAMS_CREATE_MEETING

Agenda uma nova reunião online no Microsoft Teams não vinculada a nenhum evento de calendário.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
subject	string	Sim	Assunto ou título da reunião online.
start_date_time	string	Sim	Data e hora de início da reunião no formato ISO 8601 (ex.: 2024-08-15T10:00:00Z).
end_date_time	string	Sim	Data e hora de término da reunião no formato ISO 8601. Deve ser posterior a start_date_time.
user_id	string	Não	ID do usuário em cujo nome criar a reunião. Necessário ao usar permissões de aplicativo (S2S).
participants	array	Não	Lista opcional de participantes a convidar para a reunião.
allow_recording	boolean	Não	Indica se a gravação está habilitada para a reunião.
allowed_presenters	string	Não	Especifica quem pode ser apresentador: everyone (padrão), organization, roleIsPresenter ou organizer.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter presença do usuário

MICROSOFT_TEAMS_GET_PRESENCE

Obtém as informações de presença de um usuário específico. Use para verificar disponibilidade, status de atividade ou localização de trabalho.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
user_id	string	Sim	Identificador único (GUID) ou nome principal de usuário (UPN) do usuário. Use me para obter a presença do usuário autenticado.
select	string	Não	Propriedades OData a incluir na resposta (ex.: availability,activity).
expand	string	Não	Lista de relacionamentos a expandir (ex.: statusMessage).

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Definir presença

MICROSOFT_TEAMS_SET_PRESENCE

Define o status de presença de um usuário no Microsoft Teams. Combinações válidas: Available/Available, Busy/InACall, Busy/InAConferenceCall, Away/Away ou DoNotDisturb/Presenting.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
user_id	string	Sim	Identificador único (GUID) do usuário cuja sessão de presença será definida.
session_id	string	Sim	ID da sessão de presença do aplicativo. Deve corresponder ao ID do aplicativo (appId) do token OAuth.
availability	string	Sim	Informação de presença base: Available, Busy, Away ou DoNotDisturb.
activity	string	Sim	Informação suplementar à disponibilidade: Available, InACall, InAConferenceCall, Away ou Presenting.
expiration_duration	string	Não	Duração da sessão no formato ISO 8601 (ex.: PT1H). Intervalo válido: PT5M a PT4H.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Pesquisar mensagens

MICROSOFT_TEAMS_SEARCH_MESSAGES

Pesquisa mensagens do Microsoft Teams usando sintaxe KQL poderosa. Suporta filtros por remetente (from:), data (sent:), anexos e lógica booleana. Funciona em todos os chats e canais acessíveis ao usuário. Requer conta Microsoft 365 organizacional (Azure AD/Entra ID) — não funciona com contas pessoais.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
query	string	Não	String de busca KQL. Exemplos: from:usuario@empresa.com AND sent>=2024-10-01, punchlist OR termination, sent>today-30 AND hasattachment:yes. Deixe vazio para retornar mensagens recentes (usa sent>=2020-01-01).
size	integer	Não	Número máximo de resultados por página.
from_index	integer	Não	Índice inicial (base 0) para paginação.
enable_top_results	boolean	Não	Se true, ordena por relevância; caso contrário, por data decrescente.
region	string	Não	Região geográfica: NAM, EMEA ou APAC. Obrigatório apenas com permissões de aplicativo (S2S).

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Pesquisar arquivos

MICROSOFT_TEAMS_SEARCH_FILES

Pesquisa arquivos no Microsoft Teams usando sintaxe KQL. Permite buscar por nome, tipo, conteúdo, autor e data de modificação em todos os times e canais.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
query	string	Sim	Consulta de busca para arquivos no Teams. Suporta palavras-chave, nomes de arquivo e busca por conteúdo. Exemplos: filetype:pdf AND lastmodifiedtime>=2024-10-01, contract AND budget, filename:report AND author:usuario@empresa.com.
size	integer	Não	Número máximo de resultados por página.
from_index	integer	Não	Índice inicial (base 0) para paginação.
region	string	Não	Região geográfica para a requisição de busca. Obrigatório apenas com permissões de aplicativo (S2S): NAM, EMEA ou APAC.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter mensagem de canal

MICROSOFT_TEAMS_GET_CHANNEL_MESSAGE

Recupera uma mensagem específica de um canal do Microsoft Teams usando os IDs do time, canal e mensagem.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
team_id	string	Sim	ID do time que contém o canal onde a mensagem está localizada.
channel_id	string	Sim	ID do canal dentro do time especificado que contém a mensagem.
message_id	string	Sim	ID da mensagem a recuperar do canal.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter chat

MICROSOFT_TEAMS_GET_CHAT

Recupera um único chat pelo seu ID. Use para obter detalhes sobre uma conversa específica.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
chat_id	string	Sim	Identificador único do chat a recuperar, no formato 19:abc123def456@thread.v2 para chats em grupo ou 19:user1_user2@unq.gbl.spaces para chats individuais.
expand	array	Não	Lista de entidades relacionadas a expandir na resposta. Valores suportados: members (inclui todos os membros) e lastMessagePreview (inclui prévia da última mensagem).

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter perfil do usuário

MICROSOFT_TEAMS_GET_MY_PROFILE

Recupera o perfil de um usuário (id, UPN, e-mail, nome de exibição). Suporta autenticação delegada (user_id=me) e autenticação de aplicativo (especifique ID ou UPN do usuário).

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
user_id	string	Não	Identificador único (GUID) ou nome principal de usuário (e-mail) do usuário. Use me para autenticação delegada (usuário conectado).
select	string	Não	Lista de propriedades separadas por vírgula a incluir na resposta. Padrão: id, userPrincipalName, mail e displayName.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar usuários

MICROSOFT_TEAMS_LIST_USERS

Lista todos os usuários da organização. Use para recuperar usuários do diretório com filtro, paginação e seleção de campos.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
top	integer	Não	Número máximo de usuários a retornar por página (1–999). Padrão: 100.
filter	string	Não	Filtro OData para refinar resultados por valores de propriedade (ex.: startswith(displayName,'A')).
search	string	Não	Consulta de texto avançado para pesquisa em propriedades do usuário. Requer cabeçalho ConsistencyLevel: eventual.
select	string	Não	Lista de propriedades de usuário separadas por vírgula a incluir (ex.: id,displayName,mail).
orderby	string	Não	Cláusula OData para ordenar resultados (ex.: displayName desc).

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar times do usuário

MICROSOFT_TEAMS_LIST_USER_JOINED_TEAMS

Lista os times dos quais um usuário especificado é membro direto. Use para auditorias de acesso ou associação.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
user_id	string	Sim	ID do usuário ou nome principal de usuário (UPN) para consultar os times associados. Use me para consultar os times do usuário autenticado.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Atualizar time

MICROSOFT_TEAMS_UPDATE_TEAM

Atualiza as propriedades de um time do Microsoft Teams, como nome, descrição, visibilidade ou configurações de membros, mensagens e diversão.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
team_id	string	Sim	Identificador único (GUID) do time a atualizar.
displayName	string	Não	Novo nome do time.
description	string	Não	Nova descrição do time. Máximo de 1024 caracteres.
visibility	string	Não	Visibilidade do time: private ou public.
memberSettings	object	Não	Configurações que controlam o que os membros podem fazer no time.
messagingSettings	object	Não	Configurações que controlam as funcionalidades de mensagens no time.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Arquivar time

MICROSOFT_TEAMS_ARCHIVE_TEAM

Arquiva um time do Microsoft Teams. Use após confirmar o ID do time; retorna 202 se aceito.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
team_id	string	Sim	Identificador único (GUID) do time a arquivar.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Desarquivar time

MICROSOFT_TEAMS_UNARCHIVE_TEAM

Restaura um time do Microsoft Teams arquivado para o estado ativo.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
team_id	string	Sim	Identificador único (GUID) do time arquivado a restaurar.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Adicionar membro ao chat

MICROSOFT_TEAMS_ADD_CHAT_MEMBER

Adiciona um conversationMember a um chat do Microsoft Teams. Use ao adicionar um usuário a uma conversa de chat existente.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
chat_id	string	Sim	Identificador único do chat ao qual o membro será adicionado.
user_id	string	Sim	Graph ID (GUID) ou userPrincipalName (e-mail) do usuário a adicionar ao chat.
roles	array	Não	Papéis a atribuir ao membro: owner ou guest. Deixe vazio para adicionar como membro padrão.
visible_history_start_date_time	string	Não	Timestamp indicando até onde o histórico da conversa é compartilhado com o membro, no formato ISO 8601 (ex.: 2021-01-01T00:00:00Z).

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Fixar mensagem em chat

MICROSOFT_TEAMS_PIN_MESSAGE

Fixa uma mensagem em um chat do Microsoft Teams para facilitar o acesso posterior.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
chat_id	string	Sim	Identificador único do chat onde a mensagem será fixada.
message_id	string	Sim	Identificador único da mensagem a fixar no chat.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar chats

MICROSOFT_TEAMS_CHATS_GET_ALL_CHATS

Recupera todos os chats acessíveis pelo usuário autenticado no Microsoft Teams.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
top	integer	Não	Número máximo de chats a retornar por página.
filter	string	Não	Expressão de filtro OData para refinar os chats retornados.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Enviar notificação de atividade

MICROSOFT_TEAMS_SEND_ACTIVITY_NOTIFICATION

Envia notificações de atividade para destinatários especificados no Microsoft Teams. Use para enviar notificações personalizadas a usuários, membros de time ou de canal.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
activityType	string	Sim	Tipo de atividade notificada. Deve corresponder a um tipo de atividade definido no manifesto do aplicativo Teams.
topic	object	Sim	Tópico da notificação, incluindo source, value e webUrl opcional para deep linking.
previewText	object	Sim	Texto de prévia exibido na notificação.
recipients	array	Sim	Array de destinatários que receberão a notificação. Cada destinatário deve especificar @odata.type e campos de ID correspondentes.
templateParameters	array	Não	Array opcional de parâmetros de template como pares chave-valor para customizar o conteúdo da notificação.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.