다음을 통해 공유

애플리케이션에서 얻은 인사이트로 CRM 레코드 요약 보강(프리뷰)

  • 아티클

중요

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

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

준비 중인 회의나 읽고 있는 이메일의 맥락을 더 잘 이해하기 위해 판매자는 고객 문의, 우려 사항 및 메모와 같은 관련 고객 관계 관리(CRM) 정보를 원합니다. 영업용 Copilot은 AI를 사용하여 각 CRM 레코드의 요약을 생성합니다. 이 요약은 판매 단계, 예산 및 예상 마감 날짜와 같은 중요한 세부 정보를 강조합니다. 영업용 Copilot에서 제공하는 CRM 레코드 요약 기능을 자체 애플리케이션의 인사이트로 확장할 수 있습니다.

API 설명

작업에 다음 API 설명을 추가해야 합니다. 이러한 방식으로 영업용 Copilot은 기능을 보강하기 위해 호출해야 하는 올바른 API를 식별할 수 있습니다.

이 작업은 C4S 레코드 요약 카드에 표시될 CRM 레코드와 관련된 추가 영업 인사이트를 가져옵니다. 이 작업은 영업용 Copilot의 기존 기술을 향상시킵니다.

입력 매개 변수

Copilot for Sales는 API에 다음 입력 매개 변수를 제공하도록 설계되었습니다.

입력 데이터 유형/형식 필수 세부 사항 작업에 추가할 설명
recordType String 네 활동과 같은 관련 인사이트가 요청되는 CRM의 엔터티 또는 개체 유형입니다. 이 값에는 지역화할 수 있는 표시 이름이 아니라 엔터티 또는 개체 형식의 언어에 구애받지 않는 고유 이름이 포함됩니다. 예를 들어 거래처 및 영업 기회가 있습니다. 이 입력은 인사이트가 요청되는 CRM의 엔터티 또는 개체 유형을 나타냅니다.
recordId String 네 CRM 레코드의 고유 식별자입니다. 이 입력은 인사이트가 요청되는 CRM 레코드의 고유 식별자를 나타냅니다.
startDateTime '날짜-시간' 형식의 문자열 없음 인사이트를 조회할 시작 날짜 및 시간입니다. 형식은 OpenAPI 사양을 따릅니다. 예를 들어 2017-07-21T17:32:28Z와 같습니다. 이 입력은 요청된 인사이트의 시작 날짜와 시간을 나타냅니다.
endDateTime '날짜-시간' 형식의 문자열 없음 인사이트를 조회할 종료 날짜 및 시간입니다. 형식은 OpenAPI 사양을 따릅니다. 예를 들어 2017-07-21T17:32:28Z와 같습니다. 이 입력은 요청된 인사이트의 종료 날짜와 시간을 나타냅니다.
최고 Integer 없음 가져올 인사이트 수입니다. 이 입력은 가져올 인사이트 수를 나타냅니다.
skip Integer 없음 건너뛸 인사이트 수입니다. 이 입력은 건너 뛸 인사이트 수를 나타냅니다.
crmType String 없음 유효한 값은 Dynamics 365 및 Salesforce입니다. 이 입력은 인사이트가 요청되는 CRM 레코드가 있는 CRM 유형을 나타냅니다.
crmOrgUrl String 없음 CRM 조직의 호스트 이름(예: contoso.crm.dynamics.com)입니다. 이 입력은 인사이트가 요청되는 CRM 레코드가 있는 CRM 환경의 URL을 나타냅니다.

출력 매개 변수

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

매개 변수 데이터 형식 필수 세부 사항
value 배열 네 인사이트에 대한 스키마 섹션에 설명된 대로 정의된 인사이트(개체) 목록입니다.
hasMoreResults 부울 없음 더 많은 결과를 사용할 수 있는지 여부를 나타내는 값입니다.

인사이트에 대한 스키마

입력 데이터 유형/형식 필수 세부 사항 작업에 추가할 설명
제목 String 네 인용 카드에 있는 인사이트의 제목입니다. Accept-Language 요청 헤더를 통해 지정된 언어로 된 인사이트의 자연어 제목입니다. 예를 들면 Contract signed입니다. 이 출력은 인용 카드의 활동 제목을 나타냅니다.
description String 네 인사이트에 대한 설명입니다. 이는 레코드 요약에 글머리 기호로 표시되며 Accept-Language 헤더를 통해 지정된 언어로 된 인사이트의 자연어 설명입니다. 예를 들면 Kenny, Logan 및 다른 두 명은 2023년 9월 7일에 Contoso 2023 갱신 계약에 서명했습니다입니다. 이 출력은 인사이트에 대한 설명을 나타냅니다.
날짜/시간 '날짜-시간' 형식의 문자열 네 UTC 형식의 활동 날짜 및 시간입니다. 활동에 시작 시간과 종료 시간이 모두 있는 경우 애플리케이션은 표시할 시간을 결정해야 합니다. 형식은 OpenAPI 사양을 따릅니다. 예를 들어 2017-07-21T17:32:28Z와 같습니다. 이 출력은 인사이트와 관련된 시간을 나타냅니다.
URL String 없음 파트너 애플리케이션에서 활동을 여는 유효한 URL입니다. 이 출력은 인사이트를 여는 URL을 나타냅니다.
additionalProperties 문자열 유형의 속성 이름 및 속성 값 값을 갖는 개체 없음

상세 보기에 표시되는 추가 속성입니다. 속성 이름과 값은 Accept-Language 헤더를 통해 지정된 언어의 자연어로 표시됩니다. 예를 들어 다음과 같습니다.

{
 "상태 설명": "로그오프됨",
 “담당자”: “Kenny Smith”
}
 이 출력은 인사이트의 세부 정보 보기에 표시되는 추가 속성을 나타냅니다.

참고

이메일 요약 기능과 레코드 요약 기능을 확장하기 위한 API 요구 사항은 비슷해 보일 수 있지만 커넥터에서 별도의 작업으로 추가해야 합니다.

예

{
    "value": [
        {
            "title": "Contract signed",
            "description": "You have 5 connections in Fourth Coffee Inc",
            "dateTime": "2024-05-07T03:28:38.0667701Z",
            "url": null,
            "additionalProperties": {
                "Contract name": "50 Cafe-A-100 Automatic Renewal Contract",
                "Signed by": "Alberto Burgos, Tony",
                "Signed": "9/7/23"
            }
        },
        {
            "title": "Contract signed",
            "description": "Multiple stakeholders from Fourth Coffee have visited the Contoso website four times in the last four months",
            "dateTime": "2024-05-07T03:28:38.0669445Z",
            "url": null,
            "additionalProperties": {
                "Contract name": "50 Cafe-A-100 Automatic Renewal Contract",
                "Signed by": "Alberto Burgos, Tony",
                "Signed": "9/7/23"
            }
        }
    ],
    "hasMoreResults": false
}

다음 이미지의 예에서는 API의 출력이 레코드 요약에 매핑되는 방법을 보여줍니다.

파트너 애플리케이션의 최신 활동 분석을 보여주는 스크린샷.

범례:

  1. 파트너 애플리케이션의 인사이트를 보여 주는 섹션입니다. 섹션 제목은 Microsoft Power Platform 커넥터 이름에서 파생됩니다.
  2. API 응답의 인사이트에 대한 설명입니다.
  3. 인사이트에 대한 세부 정보를 보기 위해 선택할 수 있는 인용 번호입니다.
  4. 인사이트에 대한 세부 정보를 보여주는 인용 카드입니다.
  5. 인사이트의 아이콘 및 제목입니다. 아이콘은 Microsoft Power Platform 커넥터 메타데이터에서 검색됩니다. 제목 텍스트는 API 응답의 인사이트 제목입니다.
  6. API 응답의 인사이트에 대한 추가 속성입니다.
  7. 파트너 애플리케이션의 이름. 표시되는 이름은 Microsoft Power Platform 커넥터의 이름입니다.
  8. 파트너 애플리케이션에서 인사이트 세부 정보를 보기 위해 선택할 수 있는 링크입니다. API 응답의 인사이트 URL을 기반으로 합니다.

레코드 요약 보기
애플리케이션의 인사이트로 이메일 요약 보강
애플리케이션의 파일 링크를 사용하여 이메일 초안 보강
애플리케이션에서 얻은 인사이트로 주요 영업 정보 보강
애플리케이션에서 얻은 인사이트로 CRM 레코드 세부 정보 보강
파트너 애플리케이션으로 Microsoft 365 영업용 Copilot 확장
영업용 Copilot 확장 빌드