Microsoft Teams

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

ms-teams-chat-messages-batch

Microsoft Graph API를 이용하여 입력 레코드의 사용자별 채팅 메시지를 일괄 조회합니다.

문법

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

옵션

profile=STRING
필수 옵션. Microsoft Teams Graph API 접속 프로파일 식별자. 하나만 지정할 수 있습니다.
user-field=STRING
선택 옵션. 사용자 계정(UPN) 또는 개체 ID가 담긴 입력 필드 이름. (기본값: user)
duration=STRING
선택 옵션. 현재 시각으로부터 일정 시간 범위 이내의 메시지로 한정합니다. 예: 10m, 1h, 1d
from=DATETIME
선택 옵션. 조회 시작 시각. 미지정 시 종료 시각의 1일 전.
to=DATETIME
선택 옵션. 조회 종료 시각. 미지정 시 현재 시각.
limit=INT
선택 옵션. 입력 레코드별로 조회할 최대 메시지 수. 1 이상의 정수를 지정합니다.
include-system=BOOL
선택 옵션. 멤버 변경 등 시스템 이벤트 메시지를 포함할지 여부. (기본값: f)

입력 필드

필드타입필수설명
user문자열Y조회 대상 사용자의 계정(UPN) 또는 개체 ID. 예: hong@example.com. user-field 옵션으로 다른 필드 이름을 지정할 수 있음

출력 필드

필드타입이름설명
_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
_error문자열에러유효하지 않은 입력 또는 API 호출 실패 메시지. 실패한 입력 레코드에만 포함됨