다음을 통해 공유

애플리케이션의 콘텐츠 제안으로 이메일 요약 보강(프리뷰)

중요

  • 프로덕션 준비 미리 보기 기능입니다.
  • 프로덕션 준비 미리 보기에는 추가 사용 약관이 적용됩니다.

[이 문서는 시험판 문서이며 변경될 수 있습니다.]

Outlook의 코필로트와 Sales 앱을 함께 사용하는 경우 Outlook에 표시되는 전자 메일 요약에는 Dynamics 365 또는 Salesforce CRM과 같은 CRM(고객 관계 관리) 시스템에서 제공하는 판매 정보가 포함됩니다. Sales 앱에서 사용자 고유의 애플리케이션의 인사이트를 제공하는 전자 메일 요약 기능을 확장할 수 있습니다.

참고

이 API는 기존 이메일 요약 기술 API(작업 ID: scp-get-email-insights)를 새 버전으로 대체합니다.

API 설명

작업에 다음 API 설명을 추가해야 합니다. 이를 통해 Sales 앱은 기능을 보강하기 위해 호출할 올바른 API를 식별할 수 있습니다.

이 작업은 Outlook 요약 내의 C4S 이메일 요약 환경에 표시될 추가 영업 인사이트를 가져옵니다. 이 작업은 영업용 Copilot의 기존 기술을 향상시킵니다.

API 세부 정보

  • API 이름: 이메일 요약 기술 버전 2
  • Swagger 작업 ID: scp-get-email-insights-v2
  • Swagger 작업 방법: 게시
  • 경로: <PowerAppsConnectorHostName>/api/enhanceskills/email-insights-v2

입력 페이로드

이 페이로드는 API 요청의 요청 본문으로 사용됩니다.

입력 데이터 유형 필수 세부 사항 작업에 추가할 설명
리소스데이터 객체 네 추천 콘텐츠를 가져오는 데 사용할 리소스 데이터입니다. 데이터 구조의 경우 확장성 이메일 데이터 모델로 이동합니다. 이 입력은 이메일 스레드, 제목 및 기타 세부 정보의 모음인 이메일 콘텐츠를 식별합니다.
관련 엔티티 배열 없음 관련 엔터티의 배열입니다. 데이터 구조의 경우 관련 엔터티 데이터 모델로 이동합니다. 이 입력은 이메일 스레드와 관련된 CRM 레코드의 배열을 식별합니다.
crmType String 없음 CRM 시스템의 유형(연결된 경우)입니다. 유효한 값은 Salesforce 및 Dynamics 365입니다. 이 입력은 이메일 스레드와 관련된 레코드가 있는 CRM 유형을 나타냅니다.
crmOrgUrl String 없음 CRM 조직 URL입니다. 이 입력은 이메일 스레드와 관련된 레코드가 있는 CRM 환경의 URL을 나타냅니다.
최고 정수 없음 가져올 항목의 수입니다. 이 입력은 가져올 파일 링크의 수를 나타냅니다.
skip 정수 없음 건너뛸 항목의 수입니다. 이 입력은 추천 파일 링크를 가져올 때 건너뛸 항목 수를 나타냅니다.

확장성 이메일 데이터 모델

재산 유형 세부 사항 작업에 추가할 설명
plaintextBody String 전체 이메일 본문에는 이메일 스레드의 이전 메시지가 모두 포함됩니다. 이 입력은 이메일 스레드의 모든 콘텐츠를 텍스트 형식으로 제공합니다.
전체 HTML 본문 String 이메일 스레드의 모든 이전 메시지를 포함하는 이메일 본문의 전체 HTML 버전입니다. 이 입력은 이메일 스레드의 모든 콘텐츠를 HTML 형식으로 제공합니다.
주체 String 이메일 제목입니다. 이 입력은 이메일의 제목을 제공합니다.
발신 String 보낸 사람 이메일 주소. 이 입력은 보낸 사람의 이메일 주소를 제공합니다.
수신 문자열[] 수신자 이메일 주소. 이 입력은 수신자의 이메일 주소를 제공합니다.
참조 문자열[] 이메일의 참조 필드에 추가된 수신자의 이메일 주소입니다. 이 입력은 이메일의 참조 필드에 포함된 모든 수신자의 이메일 주소를 제공합니다.
숨은 참조 문자열[] 이메일의 숨은 참조 필드에 추가된 수신자의 이메일 주소입니다. 이 입력은 이메일의 숨은 참조 필드에 추가된 모든 수신자의 이메일 주소를 제공합니다.
발신일시 DateTimeOffset Offset 속성과 함께 UTC 형식의 이메일 날짜 및 시간입니다. 자세한 내용은 DateTimeOffset 구조(System)를 참조하십시오 이 입력은 이메일의 타임스탬프를 제공합니다.
messageId String 이메일의 Graph 메시지 ID입니다. 이 입력은 이메일의 메시지 ID를 제공합니다.
conversationId String 이메일 스레드의 Graph 대화 ID입니다. 이 입력은 이메일 스레드의 대화 ID를 제공합니다.
재산 유형 필수 세부 사항 작업에 추가할 설명
entityId String 네 거래처 또는 영업 기회와 같은 CRM 레코드의 유형입니다. 이 입력은 이메일 스레드와 관련된 CRM 레코드의 고유 식별자를 제공합니다.
entityType String 네 추천 콘텐츠에 사용할 CRM 레코드의 고유 식별자입니다. 이 입력은 이메일 스레드와 관련된 CRM의 레코드 종류를 식별합니다.
entitySource String 없음 이 입력은 현재 "연결된" 값 또는 빈 값을 포함하는 엔터티 원본을 나타냅니다. 이 입력은 엔터티 원본 형식을 나타냅니다.

출력 매개 변수

Sales 앱은 API에서 인사이트(개체) 목록을 수신해야 하며 각 인사이트에 특정 매개 변수가 있어야 합니다. Sales 앱이 출력을 올바르게 구문 분석할 수 있도록 하려면 응답 구조가 다음 표의 지침을 준수해야 합니다.

매개 변수 데이터 형식 필수 세부 사항
가치 배열 네

인사이트에 대한 스키마 섹션에 설명된 대로 정의된 인사이트(개체) 목록입니다.

참고: 이 매개 변수에는 인사이트 목록이 포함되어 있지만 Outlook 캔버스 환경에 대한 전자 메일 보강 요약에는 첫 번째 인사이트만 사용됩니다.
결과가 더 있음 부울 없음 더 많은 결과를 사용할 수 있는지 여부를 나타내는 값입니다.

인사이트에 대한 스키마

입력 데이터 유형/형식 필수 세부 사항 작업에 추가할 설명
인사이트 String 네 사용자에게 전달되는 인사이트(예: 이전에 함께 작업한 적이 있는 동료 Mona Kane, Ray Tanaka 및 Daniela Smith). 이 출력은 이메일 요약에 포함하려는 텍스트를 나타냅니다.

예

{
    "value": [
        {
            "insight": "Your colleagues Mona Kane, Ray Tanaka and Daniela Smith have worked with them before."
        },
        {
            "insight": "The email was opened three times in the last month."
        }
    ],
    "hasMoreResults": false
}

다음 이미지의 예는 API의 출력이 측면 창의 이메일 요약에 매핑되는 방법을 보여줍니다.

이메일 요약의 파트너 앱 인사이트를 보여주는 스크린샷.

범례:

  1. 인사이트의 제목. 제목이 같은 인사이트는 함께 그룹화됩니다.
  2. 인사이트에 대한 설명입니다. 각 인사이트에는 하나의 설명이 있습니다.

다음 이미지의 예는 API의 출력이 이메일 본문의 이메일 요약에 매핑되는 방법을 보여줍니다.

이메일 본문에 파트너 앱의 인사이트를 보여주는 스크린샷.

범례:

  1. 인사이트의 제목. 제목이 같은 인사이트는 함께 그룹화됩니다.
  2. 인사이트의 설명. 각 인사이트에는 하나의 설명이 있습니다.

Outlook의 Copilot을 통해 영업 정보를 사용하여 이메일 스레드 요약
애플리케이션의 데이터를 사용하여 기회 인사이트 보강
애플리케이션에서 얻은 인사이트로 CRM 레코드 세부 정보 보강
애플리케이션에서 얻은 인사이트로 CRM 레코드 요약 보강
파트너 애플리케이션을 사용하여 Microsoft 365 Copilot에서 판매 확장
애플리케이션의 파일 링크를 사용하여 이메일 초안 보강
Microsoft 365 Copilot의 Sales용 빌드 확장

  • Last updated on