애플리케이션에서 얻은 통찰력으로 CRM 레코드 요약을 풍부하게 만드세요(프리뷰)

아티클
10/02/2024

중요

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

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

판매자는 준비 중인 회의나 읽고 있는 이메일의 맥락을 더 잘 이해하기 위해 고객 문의, 우려 사항, 메모 등 관련 고객 관계 관리(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` 요청 헤더를 통해 지정된 언어로 된 통찰력의 자연어 제목입니다. 다음은 예입니다. 계약 체결.	이 출력은 인용 카드의 활동 제목을 나타냅니다.
description	String	네	통찰력에 대한 설명. 이는 기록 요약에 요점으로 표시되며, `Accept-Language` 헤더를 통해 지정된 언어로 된 통찰력의 자연어 설명입니다. 다음은 그 예입니다. Kenny, Logan, 그리고 다른 두 명이 2023년 7월 9일에 Contoso 2023 갱신 계약에 서명했습니다.	이 출력은 인사이트에 대한 설명을 나타냅니다.
날짜/시간	'날짜-시간' 형식의 문자열	네	UTC 형식의 활동 날짜 및 시간입니다. 활동에 시작 시간과 종료 시간이 모두 있는 경우, 애플리케이션은 어느 시간을 표시할지 결정해야 합니다. 형식은 OpenAPI 사양을 따릅니다. 다음은 예입니다: 2017-07-21T17:32:28Z.	이 출력은 인사이트와 관련된 시간을 나타냅니다.
URL	String	없음	파트너 애플리케이션에서 활동을 여는 유효한 URL입니다.	이 출력은 인사이트를 여는 URL을 나타냅니다.
additionalProperties	속성 이름 과 속성 값 이 문자열 유형인 객체	없음	자세한 보기에 표시되는 추가 속성입니다. 속성 이름과 값은 `Accept-Language` 헤더를 통해 지정된 언어로 된 자연어로 표시됩니다. 예를 들어 다음과 같습니다. { "상태 설명": "로그오프됨", "소유자": "케니 스미스" }	이 출력은 인사이트의 세부 정보 보기에 표시되는 추가 속성을 나타냅니다.

참고

이메일 요약 기능과 레코드 요약 기능을 확장하기 위한 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 출력이 레코드 요약에 매핑되는 방식을 보여줍니다.

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

범례:

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

참조 항목

기록 요약 보기
영업 채팅에 새로운 질문 및 답변(Q&A) 기능 추가
귀하의 신청서에서 얻은 통찰력으로 이메일 요약을 풍부하게 만드십시오.
귀하의 애플리케이션에서 얻은 통찰력으로 주요 판매 정보를 풍부하게 만드십시오.
애플리케이션에서 얻은 인사이트로 CRM 레코드 세부 정보 보강
파트너 애플리케이션을 사용하여 판매 확장 Microsoft 365 Copilot
영업용 Copilot 확장 프로그램 빌드

다음을 통해 공유