본문으로 건너뛰기
모든 도구

teams_read_channel_messages

Microsoft Teams · macOS · Windows

효과: 읽기. 상태: 조건부 제공.

‘조건부 제공’은 도구가 버전, 플랫폼, 권한, 계정 또는 설정에 따라 달라질 수 있음을 뜻하며 모든 설치에서 활성화되었다는 의미는 아닙니다.

macOS

목적

Microsoft 365에서 Microsoft Teams 채널의 최근 게시물(team_id는 teams_list_teams, channel_id는 teams_list_channels에서 확인)을 오래된 순으로 읽습니다. 최상위 게시물만 포함하며 답글은 포함되지 않습니다. 채널 메시지를 읽으려면 Microsoft 365 조직 관리자가 승인하는 권한이 필요하며, 권한이 없으면 응답은 consent_required이고 해야 할 일을 안내합니다. 최대 20페이지, 페이지당 게시물 50개를 읽으며 삭제된 것도 포함됩니다. 읽기가 그 한도 때문에, 또는 호출이 시간 초과되어 중단되면 응답에 truncated: true가 포함됩니다. connect_m365_account로 연결한 회사 또는 학교 Microsoft 365 계정이 필요합니다(개인 Microsoft 계정은 Teams를 읽을 수 없음). 연결된 Microsoft 365 계정이 전혀 없으면 대신 이 Mac에 있는 Teams 앱의 로컬 캐시를 읽습니다(전체 디스크 접근 권한이 필요하며, 몇 시간 또는 며칠 뒤처져 있을 수 있음). 응답의 source가 어느 쪽이 응답했는지(graph 또는 local_cache) 알려 줍니다.

필수 입력

입력 이름은 도구가 요구하는 정확한 형태로 유지됩니다. 영문 정식 기술 정의는 아래 펼칠 수 있는 스키마에 있습니다.

권한 및 확인

스키마에 명시적 확인 매개변수가 없습니다. 이는 무단 작업을 허용하지 않습니다. 효과를 검토하고 승인을 받으세요.

영문 정식 기술 스키마 — 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"
    },
    "channel_id": {
      "description": "Channel ID from teams_list_channels",
      "type": "string"
    },
    "limit": {
      "description": "Max items to return (default 50)",
      "type": "integer"
    },
    "team_id": {
      "description": "Team ID from teams_list_teams",
      "type": "string"
    }
  },
  "required": [
    "team_id",
    "channel_id"
  ],
  "type": "object"
}

문서 예시

teams_read_channel_messages 문서 예시입니다. 이 예시를 실행하지 마세요. 표시된 인수는 가상 데이터 세트에 속합니다. 실제 호출 전에 실제 식별자를 확인하고 승인을 받으세요.

{
  "channel_id": "demo-channel-001",
  "team_id": "demo-team-001"
}

Windows

목적

특정 Teams 채널의 메시지를 읽습니다(최상위 게시물만 해당하며 답글은 포함되지 않음). 최대 20페이지, 페이지당 게시물 50개를 읽으며 삭제된 것도 포함됩니다. 읽기가 그 한도 때문에, 또는 호출이 시간 초과되어 중단되면 응답에 truncated: true가 포함됩니다.

필수 입력

입력 이름은 도구가 요구하는 정확한 형태로 유지됩니다. 영문 정식 기술 정의는 아래 펼칠 수 있는 스키마에 있습니다.

권한 및 확인

스키마에 명시적 확인 매개변수가 없습니다. 이는 무단 작업을 허용하지 않습니다. 효과를 검토하고 승인을 받으세요.

영문 정식 기술 스키마 — 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"
    },
    "channel_id": {
      "description": "Channel ID from teams_list_channels (within that team)",
      "type": "string"
    },
    "limit": {
      "description": "Maximum messages (default: 50)",
      "type": "number"
    },
    "team_id": {
      "description": "Team ID from teams_list_teams",
      "type": "string"
    }
  },
  "required": [
    "team_id",
    "channel_id"
  ],
  "type": "object"
}

문서 예시

teams_read_channel_messages 문서 예시입니다. 이 예시를 실행하지 마세요. 표시된 인수는 가상 데이터 세트에 속합니다. 실제 호출 전에 실제 식별자를 확인하고 승인을 받으세요.

{
  "channel_id": "demo-channel-001",
  "team_id": "demo-team-001"
}