teams_read_chat_messages

Microsoft Teams · macOS · Windows

Efeito: leitura. Estado: disponibilidade condicionada.

«Disponibilidade condicionada» significa que a ferramenta pode depender da versão, plataforma, permissões, conta ou configuração. Não significa que esteja ativa em todas as instalações.

macOS

Finalidade

Lê as mensagens mais recentes de uma conversa do Microsoft Teams (chat_id de teams_list_chats), das mais antigas para as mais novas, do Microsoft 365. As mensagens apagadas são ignoradas; um evento do sistema (um membro adicionado, uma chamada) aparece como [kind]. Os horários são ISO 8601 no fuso horário deste computador, com o seu deslocamento (2026-10-11T14:05-03:00). Lê no máximo 20 páginas de 50 mensagens, incluindo as apagadas. Quando a leitura é cortada (por esse limite, ou porque a chamada ficou sem tempo), a resposta traz truncated: true. Precisa de uma conta Microsoft 365 corporativa ou escolar conectada com connect_m365_account (contas pessoais da Microsoft não têm leituras do Teams). Quando nenhuma conta do Microsoft 365 está conectada, lê em vez disso o cache local do app Teams neste Mac (precisa de Acesso Total ao Disco, pode estar horas ou dias atrasado); o source da resposta diz qual respondeu (graph ou local_cache).

Entradas obrigatórias

chat_id

Os nomes são mantidos exatamente como a ferramenta exige. As definições técnicas canónicas em inglês estão no esquema expansível abaixo.

Permissões e confirmação

O esquema não declara um parâmetro explícito de confirmação. Isto não autoriza qualquer ação sem permissão; reveja o efeito e obtenha autorização.

Utilize apenas os aplicativos, contas e recursos autorizados pelo usuário nesta plataforma. Consulte a descrição específica da plataforma desta ferramenta para saber os requisitos de conexão e permissão; este catálogo não reivindica escopos OAuth adicionais ou direitos de sistema operacional.

Esquema técnico canónico em inglês — 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",
      "type": "string"
    },
    "limit": {
      "description": "Max items to return (default 50)",
      "type": "integer"
    }
  },
  "required": [
    "chat_id"
  ],
  "type": "object"
}

Exemplo documental

Exemplo de documentação para teams_read_chat_messages. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.

{
  "chat_id": "demo-chat-001"
}

Windows