Ir para o conteúdo
Todas as ferramentas

teams_call_history

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 chamadas e reuniões do Microsoft Teams que terminaram nas 50 conversas mais recentes da conta, das mais novas para as mais antigas, do Microsoft 365: tipo de chamada (call, meeting ou screenShare), participantes, horários de início e fim e duração. As chamadas fora de uma conversa (ligações telefônicas, reuniões de calendário sem conversa) não são listadas, e a Microsoft não informa quem iniciou uma chamada nem se ela foi atendida: direction e answered ficam sempre vazios. since/until opcionais (YYYY-MM-DD) restringem o intervalo. Examina as 50 conversas mais recentes e, em cada uma, as suas 50 mensagens mais novas que não foram apagadas (lendo no máximo 20 páginas de 50). Uma conversa que a conta não consegue ler (403 ou 404) é ignorada e contada em skipped_chats. 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.

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 calls to return (default 50), newest first",
      "type": "integer"
    },
    "since": {
      "description": "Only calls on/after this date, YYYY-MM-DD (optional)",
      "type": "string"
    },
    "until": {
      "description": "Only calls on/before this date, YYYY-MM-DD (optional)",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

Exemplo documental

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

Lê o histórico de chamadas e reuniões do Microsoft Teams pelo Microsoft Graph (a conta do Microsoft 365 conectada), derivado dos eventos de fim de chamada nas suas conversas recentes do Teams. Cada chamada inclui participantes, horários de início / fim, duração, tipo de chamada e um id de chamada estável. since/until opcionais (YYYY-MM-DD) restringem o intervalo — por exemplo, um coletor diário obtém as chamadas do dia anterior. Examina as 50 conversas mais recentes e, em cada uma, as suas 50 mensagens mais novas que não foram apagadas (lendo no máximo 20 páginas de 50). Uma conversa que a conta não consegue ler (403 ou 404) é ignorada e contada em skipped_chats. 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"
    },
    "limit": {
      "description": "Max calls to return (default 50), newest first",
      "type": "integer"
    },
    "since": {
      "description": "Only calls on/after this date, YYYY-MM-DD (optional)",
      "type": "string"
    },
    "until": {
      "description": "Only calls on/before this date, YYYY-MM-DD (optional)",
      "type": "string"
    }
  },
  "type": "object"
}

Exemplo documental

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