Ir para o conteúdo
Todas as ferramentas

teams_search_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

Pesquisa as mensagens de chat e de canal do Microsoft Teams de uma conta do Microsoft 365 com o Microsoft Search: por texto e, opcionalmente, por remetente e intervalo de datas. Use para descobrir onde algo foi discutido sem saber o chat. Os resultados vêm na ordem de relevância da Microsoft (não do mais recente para o mais antigo), e body é um trecho ao redor da correspondência, não a mensagem inteira; leia o chat com teams_read_chat_messages para ver o resto. Retorna no máximo 100 resultados de no máximo 4 páginas da pesquisa. Quando a leitura é cortada (por esse limite, ou porque a chamada ficou sem tempo), a resposta traz truncated: true. Requer uma conta corporativa ou escolar do Microsoft 365 conectada com connect_m365_account (contas pessoais da Microsoft não têm leituras do Teams). Quando não há nenhuma conta do Microsoft 365 conectada, lê em vez disso o cache local do app do Teams neste Mac (requer Acesso Total ao Disco, pode estar horas ou dias atrasado); o source da resposta diz qual deles 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.

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"
    },
    "from_sender": {
      "description": "Only messages from this sender (name or email; optional)",
      "type": "string"
    },
    "limit": {
      "description": "Max results (default 25, max 100)",
      "type": "integer"
    },
    "query": {
      "description": "Text to search for",
      "type": "string"
    },
    "since": {
      "description": "Only messages on/after this date, YYYY-MM-DD (optional)",
      "type": "string"
    },
    "until": {
      "description": "Only messages on/before this date, YYYY-MM-DD (optional)",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

Exemplo documental

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

{
  "limit": 5,
  "query": "launch checklist"
}

Windows

Finalidade

Pesquisa seu histórico de chats e mensagens diretas do Microsoft Teams (todas as conversas de uma vez) por texto, nome do remetente e/ou intervalo de datas. Use para descobrir onde algo foi discutido no Teams sem saber o chat. Retorna as mensagens correspondentes (as mais relevantes primeiro), cada uma com um trecho e o chat de origem. Retorna no máximo 100 resultados de no máximo 4 páginas da pesquisa. Quando a leitura é cortada (por esse limite, ou porque a chamada ficou sem tempo), a resposta traz truncated: true.

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.

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"
    },
    "from_sender": {
      "description": "Filter to a sender by name (optional)",
      "type": "string"
    },
    "limit": {
      "description": "Max results (default 25, max 100)",
      "type": "integer"
    },
    "query": {
      "description": "Text to find in messages",
      "type": "string"
    },
    "since": {
      "description": "Only messages on/after this date, YYYY-MM-DD (optional)",
      "type": "string"
    },
    "until": {
      "description": "Only messages on/before this date, YYYY-MM-DD (optional)",
      "type": "string"
    }
  },
  "type": "object"
}

Exemplo documental

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

{
  "limit": 5,
  "query": "launch checklist"
}