teams_call_history

Microsoft Teams · macOS · Windows

Эффект: чтение. Статус: условно доступен.

«Условная доступность» означает, что инструмент может зависеть от версии, платформы, разрешений, учётной записи или настроек. Он доступен не во всех установках.

macOS

Назначение

Показывает звонки и встречи Microsoft Teams, завершившиеся в 50 самых недавних чатах аккаунта, сначала новые, из Microsoft 365: тип звонка (call, meeting или screenShare), участники, время начала и окончания и длительность. Звонки вне чата (телефонные звонки, встречи из календаря без чата) не перечисляются, а Microsoft не сообщает, кто начал звонок и был ли он принят: direction и answered всегда пусты. Необязательные since/until (YYYY-MM-DD) сужают диапазон. Просматривает 50 самых недавних чатов и в каждом — 50 новейших неудалённых сообщений (читая не более 20 страниц по 50). Чат, который аккаунт не может прочитать (403 или 404), пропускается и учитывается в skipped_chats. Если чтение оборвано (из-за этого предела или потому, что вызов не уложился во время), в ответе будет truncated: true. Требуется рабочий или учебный аккаунт Microsoft 365, подключённый через connect_m365_account (у личных аккаунтов Microsoft чтения Teams нет). Если аккаунт Microsoft 365 не подключён вовсе, читает локальный кэш приложения Teams на этом Mac (нужен Full Disk Access, данные могут отставать на часы или дни); source в ответе показывает, кто ответил (graph или local_cache).

Обязательные входные данные

Схема этой платформы не объявляет обязательных входных данных. Необязательные селекторы или требования среды всё же могут применяться.

Разрешения и подтверждение

Схема не объявляет явного параметра подтверждения. Это не разрешает действовать без согласия: проверьте эффект и получите разрешение.

Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях OAuth или разрешениях OS.

Каноническая техническая схема на английском — 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"
}

Пример для документации

Пример документации для teams_call_history. Не выполняйте этот пример. Показанные аргументы относятся к вымышленному набору данных; перед реальным вызовом найдите настоящие идентификаторы и получите разрешение.

{
  "limit": 5
}

Windows

Назначение

Читает историю звонков и встреч Microsoft Teams через Microsoft Graph (подключённый аккаунт Microsoft 365), восстановленную по событиям завершения звонков в ваших недавних чатах Teams. Каждый звонок содержит участников, время начала и окончания, длительность, тип звонка и стабильный id звонка. Необязательные since/until (YYYY-MM-DD) сужают диапазон — например, ежедневный сборщик получает звонки за предыдущий день. Просматривает 50 самых недавних чатов и в каждом — 50 новейших неудалённых сообщений (читая не более 20 страниц по 50). Чат, который аккаунт не может прочитать (403 или 404), пропускается и учитывается в skipped_chats. Если чтение оборвано (из-за этого предела или потому, что вызов не уложился во время), в ответе будет truncated: true.

Обязательные входные данные

Разрешения и подтверждение

Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях OAuth или разрешениях OS.

Каноническая техническая схема на английском — 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"
}

Пример для документации

{
  "limit": 5
}