Microsoft 365 Outlook 패키지

Microsoft 365 Outlook 패키지는 Microsoft Outlook 서버를 통해 Outlook 이메일을 자동화할 수 있습니다.

시작하기 전에

Microsoft는 Exchange Online용 EWS API를 더 이상 사용하지 않으며 사용자에게 Graph API로 이동할 것을 권장했습니다.

Upcoming API Deprecations in Exchange Web Services for Exchange Online 항목을 참조하십시오.

Microsoft 365 Outlook 패키지는 Graph API를 기반으로 하며 Microsoft 365 Outlook에서 이메일 및 폴더를 보내고 받고 수정하기 위한 이메일 관련 작업을 자동화하는 데 사용할 수 있습니다.
주: Graph API를 통합하려면 관리자가 액세스 권한을 부여해야 합니다. 그 후에 애플리케이션 액세스 정책을 구성하고 애플리케이션 권한 범위를 제한할 수 있습니다. 애플리케이션 액세스 정책 구성을 참조하십시오.
주: Microsoft의 Graph API에 대한 지원은 제한적으로 제공됩니다. 따라서 Microsoft 365용 Azure US GCC High 버전을 사용할 경우 다음에 작업 영향이 미칠 수 있습니다.
  • 전달, 답장, 전체 답장
  • 첨부 파일이 있을 경우의 전송 작업
주: Microsoft의 Graph API는 디지털 서명이 포함된 이메일의 첨부 파일 다운로드를 지원하지 않습니다.

다음 순서에 이 패키지를 사용하십시오.

  • 연결 작업을 사용하여 세션을 생성합니다.
  • 다양한 작업을 사용하여 Microsoft 365 Outlook 이메일과 관련된 태스크를 자동화합니다.
  • 연결 끊기 작업을 사용하여 Microsoft Outlook 서버에 대한 연결을 종료합니다.
Microsoft 365 Outlook 패키지는 Outlook 365에서 공유 사서함의 이메일 자동화를 지원합니다. 공유 사서함에서 검색된 이메일을 자동화하고 공유 사서함의 각 폴더 및 해당 하위 폴더에 액세스하여 이메일 관련 작업을 수행할 수 있습니다. 다음 요건이 완료되었는지 확인합니다.
  • 관리자가 공유 사서함에 대한 액세스를 활성화했습니다.
  • 필요한 위임 권한이 부여됩니다.
  • 공유 사서함은 Microsoft 365 Outlook 애플리케이션에 설정되어 있습니다.
Microsoft 365 Outlook 패키지를 사용할 때 중요한 프록시 고려 사항은 다음 테이블을 검토하십시오.
프록시 유형 설명 상태
인증 Control Room URL 및 그래프 API 엔드포인트에 대한 동일한 프록시 설정 지원됨
Control Room URL 및 그래프 API 엔드포인트에 대한 서로 다른 프록시 자격증명 지원되지 않음
Control Room URL에 대한 인증된 프록시 우회 및 그래프 API 엔드포인트에 대한 인증된 프록시 설정 지원되지 않음
비인증 Control Room URL 및 그래프 API 엔드포인트에 대한 동일한 설정 지원됨
Control Room URL 및 그래프 API 엔드포인트에 대한 다양한 프록시 설정 지원됨
인증 및 비인증 조합 Control Room URL에 대한 인증된 프록시 및 그래프 API 엔드포인트에 대한 인증되지 않은 프록시 설정 지원됨
Control Room URL에 대한 인증되지 않은 프록시 및 그래프 API 엔드포인트에 대한 인증된 프록시 설정 지원되지 않음
없음 Bot Runner 컴퓨터에서 프록시를 찾을 수 없습니다. 지원됨
주: 프록시 서버용 NTLM 인증을 사용하여 온라인으로 Exchange에 연결할 수 있습니다.

작업 Microsoft 365 Outlook의 패키지

Bot 편집기 화면의 작업 팔레트에서 Microsoft 365 Outlook 패키지의 다음 작업을 더블 클릭하거나 드래그합니다.
작업 설명
상태 변경 작업 Microsoft 365 Outlook의 상태 변경 패키지 항목을 참조하십시오.
폴더가 존재하는지 확인 Microsoft 365 Outlook 패키지의 폴더가 존재하는지 확인 작업 항목을 참조하십시오.
연결 Microsoft 365 Outlook 패키지의 작업 연결 사용 항목을 참조하십시오.
삭제 Microsoft 365 Outlook 패키지에서 작업 삭제 항목을 참조하십시오.
모두 삭제 Microsoft 365 Outlook 패키지의 모든 작업 삭제 항목을 참조하십시오.
연결 끊기 Microsoft 365 Outlook 패키지의 작업 연결 끊기 항목을 참조하십시오.
전달 작업 Microsoft 365 Outlook에서 패키지 전달 항목을 참조하십시오.
이동 Microsoft 365 Outlook 패키지의 이동 작업 항목을 참조하십시오.
모두 이동 Microsoft 365 Outlook 패키지의 모든 작업 이동 항목을 참조하십시오.
회신 작업 Microsoft 365 Outlook에서 패키지에 회신 항목을 참조하십시오.
모두 회신 작업 Microsoft 365 Outlook의 전체 패키지에 회신 항목을 참조하십시오.
모든 첨부파일 저장 작업 Microsoft 365 Outlook의 모든 첨부파일 패키지을 저장 항목을 참조하십시오.
첨부파일 저장 작업 Microsoft 365 Outlook에 첨부파일 패키지 저장 항목을 참조하십시오.
이메일 저장 작업 Microsoft 365 Outlook의 이메일 저장 패키지 항목을 참조하십시오.
보내기 작업 Microsoft 365 Outlook에서 패키지 보내기 항목을 참조하십시오.

Microsoft 365 Outlook에서 파일 스트림 지원

Microsoft 365 Outlook 패키지가 파일 스트림 기능을 지원합니다. 파일 스트림 기능을 사용하면 API 태스크를 생성, 관리 및 실행하여 첨부 파일이 있는 이메일을 보낼 수 있습니다. 전달, 회신, 모두 회신, 전송 작업이 이제 파일 스트림을 포함하는 파일 변수를 사용합니다. 파일 스트림 기능을 사용하면 데이터 소스에서 파일을 다운로드하지 않고도 이메일에 파일을 첨부할 수 있습니다.

주:
  • Microsoft 365 구독은 첨부 파일의 최대 허용 크기를 결정합니다. Microsoft 365 구독이 있는 경우 첨부 파일에 허용되는 최대 파일 크기는 150MB입니다. 개인 Microsoft 365 계정을 사용하는 경우 첨부 파일에 허용되는 최대 파일 크기는 25MB입니다.
  • 목록 변수를 사용하여 이메일에서 여러 파일을 첨부할 수도 있습니다. 모든 첨부 파일의 총 크기가 Microsoft 365 계정에 설정된 크기 제한을 초과하지 않도록 하십시오.
다음은 Microsoft 365 Outlook 패키지에서 파일 스트림 기능이 작동하는 높은 수준의 워크플로입니다.
  1. 파일 스트림과 호환되는 작업 중 하나를 사용하여 파일 스트림을 파일 변수에 보관합니다. 파일 스트림 호환 작업에 대한 자세한 내용은 파일 변수를 활용한 파일 스트리밍 항목을 참조하십시오.
  2. 파일 하위 유형으로 목록 변수를 생성합니다.
  3. 목록 패키지의 항목 추가 작업을 사용하여 파일 스트림을 보유하는 파일 변수를 목록 변수에 추가합니다.
  4. 업데이트된 목록 변수를 전달, 답장, 모두 회신, 보내기 작업의 설정에 있는 첨부 파일 옵션에서 첨부 파일로 사용합니다.
  5. 자동화를 실행하면, 자동화가 데이터 소스에서 파일을 스트리밍하여 이메일에 첨부 파일로 추가합니다. 자동화는 업로드가 완료될 때만 이메일을 보냅니다. 업로드가 완료되지 않으면 이메일은 메일함의 임시 보관함에 남아 있습니다. 이메일을 임시 보관함 폴더에서 수동으로 삭제한 후 자동화를 다시 실행해야 합니다.

다음은 모든 파일 스트림 지원 Microsoft 365 Outlook 작업을 사용할 때 표시될 수 있는 오류 메시지와 그 근본 원인입니다.

파일 스트림 메타데이터에서 파일 이름을 찾을 수 없습니다. 파일 스트림 메타데이터에 파일 이름이 포함되어 있는지 확인한 후 다시 시도하십시오.
파일 이름이 비어 있거나 파일 크기가 0KB인 경우, 시스템은 이 오류 메시지를 표시합니다.
첨부 파일이 25MB 크기 제한을 초과합니다. 더 작은 파일을 업로드한 후 다시 시도하십시오.
첨부 파일의 전체 크기가 25MB를 초과하면 시스템에서 이 오류 메시지를 표시합니다.
첨부 파일 “%s”를 찾을 수 없습니다. 경로를 확인한 후 다시 시도하십시오
첨부 파일이 소스 위치에 없으면, 시스템이 이 오류 메시지를 표시합니다.