Microsoft Teams

다운로드 33
업데이트 2026. 11. 20.

ms-teams-chat-messages

Microsoft Graph API를 이용하여 지정한 사용자가 참여한 1:1 및 그룹 채팅 메시지를 조회합니다.

문법

ms-teams-chat-messages [profile=STRING] user=STRING [duration=STRING] [from=DATETIME] [to=DATETIME] [limit=INT] [include-system=BOOL]

옵션

user=STRING
필수 옵션. 조회 대상 사용자의 계정(UPN) 또는 개체 ID. 여러 명은 쉼표(,)로 구분해서 입력합니다. 예: hong@example.com,user@example.com
profile=STRING
선택 옵션. Microsoft Teams Graph API 접속 프로파일 식별자. 미지정 시 등록된 모든 Microsoft Teams Graph API 접속 프로파일을 조회합니다.
duration=STRING
선택 옵션. 현재 시각으로부터 일정 시간 범위 이내의 메시지로 한정합니다. 예: 10m, 1h, 1d
from=DATETIME
선택 옵션. 조회 시작 시각. 미지정 시 종료 시각의 1일 전.
to=DATETIME
선택 옵션. 조회 종료 시각. 미지정 시 현재 시각.
limit=INT
선택 옵션. 사용자별로 조회할 최대 메시지 수. 1 이상의 정수를 지정합니다.
include-system=BOOL
선택 옵션. 멤버 변경 등 시스템 이벤트 메시지를 포함할지 여부. (기본값: f)

출력 필드

필드타입이름설명
_time날짜시각메시지 생성 시각
profile문자열접속 프로파일조회에 사용한 접속 프로파일 식별자. 예: ms_teams_graph
user문자열조회 대상 사용자메시지를 조회한 대상 사용자. 예: hong@example.com
msg_id문자열메시지 ID메시지 식별자
chat_id문자열채팅 ID메시지가 속한 채팅 식별자. 같은 대화의 메시지는 값이 동일함
updated날짜수정 시각메시지 최종 수정 시각. 조회 기간은 이 값을 기준으로 판정함
msg_type문자열메시지 유형message, chatEvent, typing, systemEventMessage
from_user_id문자열발신자 ID발신자 개체 ID. 발신자 정보가 없으면 null
from_user_name문자열발신자 이름발신자 표시 이름. 예: 홍길동
msg문자열메시지HTML 태그를 제거한 메시지 본문. 예: 회의 자료 공유드립니다
content_type문자열본문 형식원본 본문 형식. html 또는 text
importance문자열중요도normal, high, urgent