teams_list_chats

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

Lista as conversas do Microsoft Teams de uma conta do Microsoft 365 — mensagens diretas, conversas em grupo e conversas de reunião — das mais recentemente ativas para as menos, lidas do Microsoft 365. Cada conversa tem o seu id (para teams_read_chat_messages), um título, os outros participantes, o seu tipo (oneOnOne, group ou meeting) e a sua última mensagem. participants nomeia todos os outros membros; um cujo nome não pôde ser lido aparece como "unnamed member" (ou "unnamed member (external)"), nunca como nada. participants_state diz até que ponto confiar nele: resolved, unresolved (pelo menos um sem nome), only_you (ninguém mais na conversa) ou unknown (a lista de membros não pôde ser lida: participant_count e has_external_members ficam então ausentes). Lê no máximo 20 páginas de 50 conversas. 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

O esquema desta plataforma não declara entradas obrigatórias. Ainda podem existir seletores opcionais ou requisitos de execução.

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"
    },
    "limit": {
      "description": "Max items to return (default 50)",
      "type": "integer"
    }
  },
  "required": [],
  "type": "object"
}

Exemplo documental

Exemplo de documentação para teams_list_chats. 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.

{
  "limit": 5
}

Windows

Finalidade

Lista suas conversas recentes do Microsoft Teams pelo Microsoft Graph, usando a conta do Microsoft 365 conectada. Lê no máximo 20 páginas de 50 conversas. Quando a leitura é cortada (por esse limite, ou porque a chamada ficou sem tempo), a resposta traz truncated: true. participants nomeia todos os outros membros; um cujo nome não pôde ser lido aparece como "unnamed member" (ou "unnamed member (external)"), nunca como nada. participants_state diz até que ponto confiar nele: resolved, unresolved (pelo menos um sem nome), only_you (ninguém mais na conversa) ou unknown (a lista de membros não pôde ser lida: participant_count e has_external_members ficam então ausentes).

Entradas obrigatórias

O esquema desta plataforma não declara entradas obrigatórias. Ainda podem existir seletores opcionais ou requisitos de execução.

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 — Windows

{
  "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"
    },
    "limit": {
      "description": "Maximum chats to return (default: 50)",
      "type": "number"
    }
  },
  "type": "object"
}

Exemplo documental

{
  "limit": 5
}