다음을 통해 공유


Office 365 그룹 메일

Office 365 그룹 메일 커넥터를 사용하면 사용자가 Office 365 그룹 사서함에 있는 데이터를 사용할 수 있습니다. 이 커넥터의 기능은 단일 사용자의 개인 사서함과 독립적으로 작동하며 사용자가 조직 내에서 액세스할 수 있는 모든 그룹과 함께 작업할 수 있도록 합니다. 커넥터는 Microsoft Graph API에서 작동하며 Graph API 내의 Office 365 그룹 설명서에 지정된 용어를 사용합니다. 커넥터 설명서에서 자세히 알아보세요.

이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.

서비스 클래스 Regions
Copilot Studio 스탠다드 모든 Power Automate 지역
논리 앱 스탠다드 모든 Logic Apps 지역
Power Apps 스탠다드 모든 Power Apps 지역
Power Automate 스탠다드 모든 Power Automate 지역
연락처
이름 Microsoft
URL Microsoft LogicApps 지원
Microsoft Power Automate 지원
Microsoft Power Apps 지원
커넥터 메타데이터
게시자 Microsoft
웹 사이트 https://docs.microsoft.com/en-us/graph/api/resources/groups-overview?view=graph-rest-1.0
카테고리 생산력

필수 조건

이 커넥터를 사용하려면 조직 내의 Office 365 그룹에 액세스할 수 있는 사용자 계정이 필요합니다.

또한 Microsoft 365 그룹에 대한 Microsoft Graph API 설명서를 검토하여 데이터가 API 내에서 구조화되는 방식을 이해하는 것이 좋습니다. 이 커넥터를 사용하기 전에 검토해야 하는 핵심 용어(예: "conversation", "thread", "post")가 있습니다.

알려진 문제 및 제한 사항

"저장소에서 지정된 개체를 찾을 수 없습니다." 오류 문제를 해결하려면 다음을 수행할 수 있습니다.

  • 계정에 대한 사용 권한을 확인합니다.
  • 현재 Office 365 그룹 메일 연결을 삭제하고 새 연결을 만듭니다.

멤버 자격 없이 "공용" 그룹에 액세스

인증된 사용자는 구성원인 그룹 및 조직 내의 모든 "공용" 그룹에서 그룹 데이터에 액세스할 수 있습니다. 커넥터 환경에서 그룹을 선택할 때 커넥터는 선택할 그룹의 동적 드롭다운을 제공합니다. 보다 깔끔한 환경의 경우 이 드롭다운은 인증된 사용자가 구성원인 그룹으로만 자동으로 채워집니다.

드롭다운에 채워지지 않은 조직 내의 "공용" 그룹에 액세스하려면 맨 아래로 스크롤하고 사용자 지정 값 입력을 선택하여 커넥터 드롭다운에서 그룹 ID를 제공해야 합니다.

조직 내에서 그룹 ID를 찾으려면 다음 단계를 수행합니다.

  1. Microsoft Graph Explorer로 이동하여 왼쪽 위에 있는 사용자로 인증합니다.

  2. 샘플 쿼리 섹션에서 그룹을 선택한 다음 조직의 모든 그룹을 가져옵니다.

  3. 응답 미리 보기에서 검색하려는 조직 내의 그룹을 찾습니다. 커넥터 드롭다운 환경의 id 사용자 지정 값으로 속성의 값을 제공합니다.

  4. 그룹 표시 유형이 공용으로 설정되어 있는지 확인하거나 사용자가 그룹 내의 데이터에 액세스할 수 없는지 확인합니다.

  5. 그룹을 찾을 수 없는 경우 링크를 복사하여 페이지 맨 위에 있는 쿼리로 실행하여 액세스할 수 있는 @odata.nextLink 결과의 다음 페이지를 확인해야 할 수 있습니다.

메일 트리거

동시에 많은 전자 메일이 전송되는 경우 트리거에서 일부 전자 메일을 놓칠 수 있습니다. 이는 커넥터가 늦은 전자 메일이 포함된 일괄 처리를 처리한 후 전자 메일이 늦게 "표시"되는 전자 메일 처리 지연의 기본 시스템 제한 때문입니다.

사용 중단 정보

이 커넥터에 대한 전자 메일 반출 제어 지원이 부족하여 "게시 전달" 작업이 일시적으로 사용되지 않습니다. 지원을 제공하기 위해 노력하고 있으며 완료되면 작업을 업데이트할 예정입니다.

제한 한도

Name 호출 갱신 기간
연결당 API 호출 100 60초
트리거 폴링 빈도 1 60초

동작

HTTP 요청 보내기

호출할 Microsoft Graph REST API 요청을 생성합니다. 더 알아보세요: https://docs.microsoft.com/en-us/graph/use-the-api

게시물 전달(미리 보기)

받는 사람에게 게시물을 전달합니다.

게시물 전달 [사용되지 않음]

이 작업은 더 이상 사용되지 않습니다. 대신 게시를 전달 하세요.

받는 사람에게 게시물을 전달합니다.

게시물에 회신

게시물에 회신하고 그룹 대화에서 지정된 스레드에 새 게시물을 추가합니다.

게시물의 첨부 파일 나열

게시물에 속하는 첨부 파일 목록을 검색합니다.

그룹 대화 가져오기

특정 대화의 속성을 검색합니다.

그룹에서 새 대화 만들기

이 그룹에서 새 대화를 만듭니다.

그룹의 대화 나열

이 그룹의 모든 대화를 가져옵니다.

그룹의 스레드 나열

그룹의 모든 스레드를 가져옵니다.

대화 스레드 가져오기

그룹에 속한 특정 스레드를 가져옵니다.

대화 스레드 만들기

지정된 대화에서 새 스레드를 만듭니다.

대화 스레드 삭제

지정된 대화 스레드를 삭제합니다.

대화 스레드에 회신

그룹 대화의 스레드에 회신하고 새 게시물을 추가합니다.

대화 스레드의 게시물 나열

지정된 대화 스레드의 모든 게시물을 가져옵니다.

대화의 대화 스레드 나열

그룹 대화의 모든 스레드를 가져옵니다.

스레드 게시물 가져오기

지정된 스레드에서 게시물을 검색합니다.

스레드를 만들어 새 그룹 대화 시작

먼저 스레드를 만들어 새 그룹 대화를 시작합니다.

HTTP 요청 보내기

호출할 Microsoft Graph REST API 요청을 생성합니다. 더 알아보세요: https://docs.microsoft.com/en-us/graph/use-the-api

매개 변수

Name 필수 형식 Description
URI
Uri True string

전체 또는 상대 URI입니다. 예: https://graph.microsoft.com/{version}/{resource}.

메서드
Method True string

HTTP 메서드(기본값은 GET)입니다.

Body binary

요청 본문 콘텐츠입니다.

콘텐츠 유형 (Content-Type)
ContentType string

본문의 콘텐츠 형식 헤더입니다(기본값은 application/json).

CustomHeader1
CustomHeader1 string

사용자 지정 헤더 1. 형식으로 지정: header-name: header-value

CustomHeader2
CustomHeader2 string

사용자 지정 헤더 2. 형식으로 지정: header-name: header-value

CustomHeader3
CustomHeader3 string

사용자 지정 헤더 3. 형식으로 지정: header-name: header-value

CustomHeader4
CustomHeader4 string

사용자 지정 헤더 4. 형식으로 지정: header-name: header-value

CustomHeader5
CustomHeader5 string

사용자 지정 헤더 5. 형식으로 지정: header-name: header-value

반환

게시물 전달(미리 보기)

받는 사람에게 게시물을 전달합니다.

매개 변수

Name 필수 형식 Description
그룹 메일
groupMail True string

드롭다운에서 그룹을 선택하거나 그룹 메일 주소를 입력합니다.

대화 식별자
conversationId True string

대화 ID를 입력합니다.

스레드 ID
threadId True string

대화 스레드 ID를 입력합니다.

게시 ID
postId True string

게시 ID를 입력합니다.

주석
Comment html

게시물과 함께 전달하도록 댓글을 달 수 있습니다.

Address
Address email

이메일 주소.

게시물 전달 [사용되지 않음]

이 작업은 더 이상 사용되지 않습니다. 대신 게시를 전달 하세요.

받는 사람에게 게시물을 전달합니다.

매개 변수

Name 필수 형식 Description
그룹 아이디
groupId True string

드롭다운에서 그룹을 선택하거나 그룹 ID를 입력합니다.

스레드 ID
threadId True string

대화 스레드 ID를 입력합니다.

게시 ID
postId True string

게시 ID를 입력합니다.

주석
comment string

게시물과 함께 전달하도록 댓글을 달 수 있습니다.

Address
Address email

이메일 주소.

게시물에 회신

게시물에 회신하고 그룹 대화에서 지정된 스레드에 새 게시물을 추가합니다.

매개 변수

Name 필수 형식 Description
그룹 아이디
groupId True string

드롭다운에서 그룹을 선택하거나 그룹 ID를 입력합니다.

스레드 ID
threadId True string

대화 스레드 ID를 입력합니다.

게시 ID
postId True string

게시 ID를 입력합니다.

Content
content True html

새 대화의 내용입니다.

카테고리
categories array of string

게시물과 연결된 범주입니다.

Address
Address email

이메일 주소.

첨부 파일 이름
Name True string

첨부 파일의 이름입니다.

첨부 파일 콘텐츠
ContentBytes True byte

첨부 파일의 내용입니다.

게시물의 첨부 파일 나열

게시물에 속하는 첨부 파일 목록을 검색합니다.

매개 변수

Name 필수 형식 Description
그룹 아이디
groupId True string

드롭다운에서 그룹을 선택하거나 그룹 ID를 입력합니다.

스레드 ID
threadId True string

대화 스레드 ID를 입력합니다.

게시 ID
postId True string

게시 ID를 입력합니다.

반환

Name 경로 형식 Description
value
value array of Attachment

게시물의 첨부 파일이 포함된 배열입니다.

그룹 대화 가져오기

특정 대화의 속성을 검색합니다.

매개 변수

Name 필수 형식 Description
그룹 아이디
groupId True string

드롭다운에서 그룹을 선택하거나 그룹 ID를 입력합니다.

대화 식별자
conversationId True string

대화 ID를 입력합니다.

반환

대화 개체입니다.

그룹에서 새 대화 만들기

이 그룹에서 새 대화를 만듭니다.

매개 변수

Name 필수 형식 Description
그룹 아이디
groupId True string

드롭다운에서 그룹을 선택하거나 그룹 ID를 입력합니다.

새 항목
topic True string

새 대화의 주제입니다.

Content
content True html

새 대화의 내용입니다.

카테고리
categories array of string

게시물과 연결된 범주입니다.

Address
Address email

이메일 주소.

첨부 파일 이름
Name True string

첨부 파일의 이름입니다.

첨부 파일 콘텐츠
ContentBytes True byte

첨부 파일의 내용입니다.

반환

만든 대화 세부 정보를 사용한 응답입니다.

대화 개체를 만들었습니다.
CreateConversationResponse

그룹의 대화 나열

이 그룹의 모든 대화를 가져옵니다.

매개 변수

Name 필수 형식 Description
그룹 아이디
groupId True string

드롭다운에서 그룹을 선택하거나 그룹 ID를 입력합니다.

반환

Name 경로 형식 Description
value
value array of Conversation

그룹의 스레드 나열

그룹의 모든 스레드를 가져옵니다.

매개 변수

Name 필수 형식 Description
그룹 아이디
groupId True string

드롭다운에서 그룹을 선택하거나 그룹 ID를 입력합니다.

반환

Name 경로 형식 Description
value
value array of ConversationThread

대화 스레드 가져오기

그룹에 속한 특정 스레드를 가져옵니다.

매개 변수

Name 필수 형식 Description
그룹 아이디
groupId True string

드롭다운에서 그룹을 선택하거나 그룹 ID를 입력합니다.

스레드 ID
threadId True string

대화 스레드 ID를 입력합니다.

반환

대화 스레드 개체입니다.

대화 스레드 만들기

지정된 대화에서 새 스레드를 만듭니다.

매개 변수

Name 필수 형식 Description
그룹 아이디
groupId True string

드롭다운에서 그룹을 선택하거나 그룹 ID를 입력합니다.

대화 식별자
conversationId True string

대화 ID를 입력합니다.

새 항목
topic True string

새 대화의 주제입니다.

Content
content True html

새 대화의 내용입니다.

카테고리
categories array of string

게시물과 연결된 범주입니다.

Address
Address email

이메일 주소.

첨부 파일 이름
Name True string

첨부 파일의 이름입니다.

첨부 파일 콘텐츠
ContentBytes True byte

첨부 파일의 내용입니다.

반환

대화 스레드 삭제

지정된 대화 스레드를 삭제합니다.

매개 변수

Name 필수 형식 Description
그룹 아이디
groupId True string

드롭다운에서 그룹을 선택하거나 그룹 ID를 입력합니다.

스레드 ID
threadId True string

대화 스레드 ID를 입력합니다.

대화 스레드에 회신

그룹 대화의 스레드에 회신하고 새 게시물을 추가합니다.

매개 변수

Name 필수 형식 Description
그룹 아이디
groupId True string

드롭다운에서 그룹을 선택하거나 그룹 ID를 입력합니다.

스레드 ID
threadId True string

대화 스레드 ID를 입력합니다.

Content
content True html

새 대화의 내용입니다.

카테고리
categories array of string

게시물과 연결된 범주입니다.

Address
Address email

이메일 주소.

첨부 파일 이름
Name True string

첨부 파일의 이름입니다.

첨부 파일 콘텐츠
ContentBytes True byte

첨부 파일의 내용입니다.

대화 스레드의 게시물 나열

지정된 대화 스레드의 모든 게시물을 가져옵니다.

매개 변수

Name 필수 형식 Description
그룹 아이디
groupId True string

드롭다운에서 그룹을 선택하거나 그룹 ID를 입력합니다.

스레드 ID
threadId True string

대화 스레드 ID를 입력합니다.

반환

Name 경로 형식 Description
value
value array of Post

지정된 스레드의 게시물을 포함하는 배열입니다.

대화의 대화 스레드 나열

그룹 대화의 모든 스레드를 가져옵니다.

매개 변수

Name 필수 형식 Description
그룹 아이디
groupId True string

드롭다운에서 그룹을 선택하거나 그룹 ID를 입력합니다.

대화 식별자
conversationId True string

대화 ID를 입력합니다.

반환

Name 경로 형식 Description
value
value array of ConversationThread

스레드 게시물 가져오기

지정된 스레드에서 게시물을 검색합니다.

매개 변수

Name 필수 형식 Description
그룹 아이디
groupId True string

드롭다운에서 그룹을 선택하거나 그룹 ID를 입력합니다.

스레드 ID
threadId True string

대화 스레드 ID를 입력합니다.

게시 ID
postId True string

게시 ID를 입력합니다.

반환

conversationThread 엔터티 내의 개별 Post 항목을 나타냅니다.

Post

스레드를 만들어 새 그룹 대화 시작

먼저 스레드를 만들어 새 그룹 대화를 시작합니다.

매개 변수

Name 필수 형식 Description
그룹 아이디
groupId True string

드롭다운에서 그룹을 선택하거나 그룹 ID를 입력합니다.

새 항목
topic True string

새 대화의 주제입니다.

Content
content True html

새 대화의 내용입니다.

카테고리
categories array of string

게시물과 연결된 범주입니다.

Address
Address email

이메일 주소.

첨부 파일 이름
Name True string

첨부 파일의 이름입니다.

첨부 파일 콘텐츠
ContentBytes True byte

첨부 파일의 내용입니다.

반환

트리거

새 전자 메일이 그룹에 도착하는 경우

새 전자 메일이 그룹에 도착하는 경우

새 전자 메일이 그룹에 도착하는 경우

새 전자 메일이 그룹에 도착하는 경우

매개 변수

Name 필수 형식 Description
그룹 아이디
groupId True string

드롭다운에서 그룹을 선택하거나 그룹 ID를 입력합니다.

반환

Name 경로 형식 Description
value
value array of ConversationTriggerResponse

트리거의 응답입니다.

정의

대화

대화 개체입니다.

Name 경로 형식 Description
대화 식별자
id string

대화의 고유 식별자입니다.

대화 항목
topic string

대화의 주제입니다.

첨부 파일이 있나요?
hasAttachments boolean

이 대화 내의 게시물에 첨부 파일이 하나 이상 있는지 여부를 나타냅니다.

마지막으로 배달된 타임스탬프
lastDeliveredDateTime date-time

타임스탬프 형식은 ISO 8601 형식을 사용하는 날짜 및 시간 정보를 나타내며 항상 UTC 시간입니다.

고유한 보낸 사람 배열
uniqueSenders array of string

이 대화에 메시지를 보낸 모든 사용자입니다.

Preview
preview string

이 대화의 최신 게시물 본문에 대한 간단한 요약입니다.

ConversationThread

대화 스레드 개체입니다.

Name 경로 형식 Description
대화 스레드 ID
id string

대화 스레드의 고유 식별자입니다.

대화 항목
topic string

대화의 주제입니다.

첨부 파일이 있나요?
hasAttachments boolean

이 대화 내의 게시물에 첨부 파일이 하나 이상 있는지 여부를 나타냅니다.

마지막으로 배달된 타임스탬프
lastDeliveredDateTime date-time

타임스탬프 형식은 ISO 8601 형식을 사용하는 날짜 및 시간 정보를 나타내며 항상 UTC 시간입니다.

고유한 보낸 사람 배열
uniqueSenders array of string

이 대화에 메시지를 보낸 모든 사용자입니다.

Preview
preview string

이 대화의 최신 게시물 본문에 대한 간단한 요약입니다.

잠겨 있나요?
isLocked boolean

스레드가 잠겨 있는지를 나타냅니다.

toRecipients
toRecipients array of EmailAddress

받는 사람: 스레드의 받는 사람입니다.

ccRecipients
ccRecipients array of EmailAddress

참조: 스레드의 받는 사람입니다.

올리기

conversationThread 엔터티 내의 개별 Post 항목을 나타냅니다.

Name 경로 형식 Description
게시 ID
id string

게시물의 고유 식별자입니다.

게시물의 타임스탬프 생성
createdDateTime date-time
게시물의 마지막으로 수정된 타임스탬프
lastModifiedDateTime date-time
키 변경
changeKey string

게시물의 버전을 식별합니다.

대화 식별자
conversationId string

게시물이 속한 대화의 고유 ID입니다.

대화 스레드 ID
conversationThreadId string

게시물이 속한 대화 스레드의 고유 ID입니다.

카테고리
categories array of string

게시물과 연결된 범주입니다.

수신된 타임스탬프
receivedDateTime date-time

수신된 타임스탬프를 게시합니다.

첨부 파일이 있나요?
hasAttachments boolean

게시물에 첨부 파일이 하나 이상 있는지 여부를 나타냅니다.

새 참가자
newParticipants array of EmailAddress

이 게시물의 일부로 스레드에 추가된 대화 참가자입니다.

body
body ItemBody

메시지, 이벤트 또는 그룹 게시물과 같은 항목 본문의 속성을 나타냅니다.

보낸 사람
from EmailAddress
발송인
sender EmailAddress
attachments
attachments array of Attachment

첨부 파일

Name 경로 형식 Description
첨부 파일 ID
id string

첨부 파일의 ID입니다.

첨부 파일 이름
name string

첨부 파일 이름입니다.

첨부 파일 콘텐츠 형식
contentType string

첨부 파일의 콘텐츠 형식입니다.

첨부 파일 크기
size integer

첨부 파일의 크기입니다.

첨부 파일 콘텐츠 바이트
contentBytes byte

첨부 파일의 내용입니다.

이메일 주소

Name 경로 형식 Description
사용자의 이름
emailAddress.name string
사용자의 전자 메일 주소
emailAddress.address email

ItemBody

메시지, 이벤트 또는 그룹 게시물과 같은 항목 본문의 속성을 나타냅니다.

Name 경로 형식 Description
본문 콘텐츠 형식
contentType string

본문의 콘텐츠 형식입니다.

본문 내용
content string

본문의 내용입니다.

CreateConversationResponse

만든 대화 세부 정보를 사용한 응답입니다.

Name 경로 형식 Description
대화 식별자
id string

새 대화 ID입니다.

대화 스레드
threads array of object

대화 스레드를 만들었습니다.

스레드 ID
threads.id string

새 스레드 ID입니다.

NewConversationThreadResponse

Name 경로 형식 Description
대화 스레드 ID
id string

새 대화 스레드 ID입니다.

ConversationTriggerResponse

새 전자 메일이 도착하면 트리거 응답이 발생합니다.

Name 경로 형식 Description
대화 식별자
id string

대화 고유 식별자입니다.

마지막으로 배달된 타임스탬프
lastDeliveredDateTime date-time

타임스탬프 형식은 ISO 8601 형식을 사용하는 날짜 및 시간 정보를 나타내며 항상 UTC 시간입니다.

threads
threads array of ConversationThreadTriggerResponse

ConversationThreadTriggerResponse

대화 스레드 개체입니다.

Name 경로 형식 Description
대화 스레드 ID
id string

대화 스레드의 고유 식별자입니다.

게시물
posts array of PostTriggerResponse

PostTriggerResponse

conversationThread 엔터티 내의 개별 Post 항목을 나타냅니다.

Name 경로 형식 Description
게시 ID
id string

게시물의 고유 식별자입니다.

게시물의 마지막으로 수정된 타임스탬프
lastModifiedDateTime date-time
키 변경
changeKey string

게시물의 버전을 식별합니다.

ObjectWithoutType