애플리케이션에서 얻은 인사이트로 CRM 레코드 세부 정보 보강(프리뷰)
중요
- 프로덕션 준비 미리 보기 기능입니다.
- 프로덕션 준비 미리 보기에는 추가 사용 약관이 적용됩니다.
[이 문서는 시험판 문서이며 변경될 수 있습니다.]
판매자는 거래처, 영업 기회 등 관련 레코드와 함께 저장된 연락처에 대한 세부 정보를 볼 수 있습니다. 영업용 Copilot에서 제공하는 CRM(고객 관계 관리) 레코드 세부 정보 기능을 자체 애플리케이션의 인사이트로 확장할 수 있습니다.
API 설명
작업에 다음 API 설명을 추가해야 합니다. 이러한 방식으로 영업용 Copilot은 기능을 보강하기 위해 호출해야 하는 올바른 API를 식별할 수 있습니다.
이 작업은 CRM 레코드와 관련된 레코드를 가져옵니다. 이 작업은 영업용 Copilot의 기존 기술을 향상시킵니다.
입력 매개 변수
Copilot for Sales는 API에 다음 입력 매개 변수를 제공하도록 설계되었습니다.
| 입력 | 데이터 유형/형식 | 필수 | 세부 사항 | 작업에 추가할 설명 |
|---|---|---|---|---|
| recordType | String | 네 | 관련 레코드가 요청되는 CRM의 엔터티 또는 개체 유형입니다. 이 값에는 지역화할 수 있는 표시 이름이 아니라 엔터티 또는 개체 형식의 언어에 구애받지 않는 고유 이름이 포함됩니다. 예를 들어 거래처 및 영업 기회가 있습니다. | 이 입력은 CRM에서 관련 레코드가 요청되는 레코드 종류를 식별합니다. |
| recordId | String | 네 | CRM 레코드의 고유 식별자입니다. | 이 입력은 관련 레코드가 요청되는 CRM 레코드의 고유 식별자를 제공합니다. |
| 최고 | Integer | 없음 | 가져올 활동 수입니다. | 이 입력은 가져올 관련 레코드의 수를 나타냅니다. |
| skip | Integer | 없음 | 건너뛸 활동 수입니다. | 이 입력은 관련 레코드를 가져올 때 건너뛸 레코드 수를 나타냅니다. |
| crmType | String | 없음 | CRM 시스템의 유형입니다. 유효한 값은 Dynamics 365 및 Salesforce입니다. | 이 입력은 관련 레코드를 가져오는 CRM 유형을 나타냅니다. |
| crmOrgUrl | String | 없음 | CRM 조직의 호스트 이름(예: contoso.crm.dynamics.com)입니다. | 이 입력은 관련 레코드를 가져오는 CRM 환경의 URL을 나타냅니다. |
참고
이 확장 지점은 최대 5개까지 Outlook 사이드카의 커넥터 확장에서 인사이트 렌더링을 지원합니다.
출력 매개 변수
영업용 Copilot은 API에서 인사이트(개체) 목록을 수신할 것으로 예상하며 각 인사이트에 특정 매개 변수가 있을 것으로 예상합니다. 영업용 Copilot이 출력을 올바르게 구문 분석할 수 있도록 하려면 응답 구조가 다음 표의 지침을 준수해야 합니다.
| 매개 변수 | 데이터 형식 | 필수 | 세부 사항 |
|---|---|---|---|
| value | 배열 | 네 | 인사이트에 대한 스키마 섹션에 설명된 대로 정의된 인사이트(개체) 목록입니다. |
| hasMoreResults | 부울 | 없음 | 더 많은 결과를 사용할 수 있는지 여부를 나타내는 값입니다. |
인사이트에 대한 스키마
| 입력 | 데이터 유형/형식 | 필수 | 세부 사항 | 작업에 추가할 설명 |
|---|---|---|---|---|
| recordId | String | 네 | 레코드의 고유 식별자입니다. | 이 출력은 작업에서 반환된 각 관련 레코드를 고유하게 식별합니다. |
| recordTypeDisplayName | String | 네 | Contract와 같은 레코드 종류의 표시 이름입니다. Accept-Language 헤더를 통해 지정된 언어로 지역화해야 합니다. |
이 출력은 작업에서 반환된 각 관련 레코드의 레코드 종류의 표시 이름을 나타냅니다. |
| recordTypePluralDisplayName | String | 네 | Contracts와 같은 레코드 종류의 복수형 표시 이름입니다. Accept-Language 헤더를 통해 지정된 언어로 지역화해야 합니다. |
이 출력은 작업에서 반환된 각 관련 레코드의 레코드 종류에 대한 복수형 표시 이름을 나타냅니다. |
| recordType | String | 네 | contract와 같은 레코드 종류의 시스템 이름입니다. | 이 출력은 작업에서 반환된 각 관련 레코드의 종류를 나타냅니다. |
| recordTitle | String | 네 | Contoso 2023 Renewal Contract와 같은 레코드의 이름입니다. | 이 출력은 작업에서 반환된 각 관련 레코드의 제목을 나타냅니다. |
| URL | String | 없음 | 파트너 애플리케이션에서 레코드를 여는 유효한 URL입니다. | 이 출력은 작업에서 반환된 각 관련 레코드의 URL을 나타냅니다. |
| additionalProperties | 문자열 유형의 속성 이름 및 속성 값 값을 갖는 개체 | 없음 | 상세 보기에 표시되는 추가 속성입니다. 속성 이름과 값은 { |
이 출력은 작업에서 반환된 각 관련 레코드의 이름-값 쌍으로 추가 속성을 나타냅니다. |
예
{
"value": [
{
"recordId": "ID1",
"recordTypeDisplayName": "Contract",
"recordTitle": "50 Cafe A-100 Automatic Renewal Contract",
"recordTypePluralDisplayName": "Documents",
"recordType": "contract",
"url": "https://contosohub.com/contract/id1",
"additionalProperties": {
"Status": "Signed",
"Date": "9/7/23",
"Signed by": "Alberto Burgos, Tony [last name]"
}
},
{
"recordId": "ID2",
"recordTypeDisplayName": "Contract",
"recordTitle": "ABC Company 2023 Renewal Contract",
"recordTypePluralDisplayName": "Documents",
"recordType": "contract",
"url": "https://contosohub.com/contract/id2",
"additionalProperties": {
"Status": "Delivered",
"Date": "9/3/23",
"Signed by": "Alberto Burgos"
}
}
],
"hasMoreResults": false
}
다음 이미지의 예는 API의 출력이 관련 레코드에 매핑되는 방법을 보여줍니다.
범례:
- 파트너 애플리케이션의 관련 레코드를 표시하는 카드입니다.
- 카드의 아이콘과 제목. 아이콘은 Microsoft Power Platform 커넥터 메타데이터에서 검색됩니다. 제목은 Microsoft Power Platform 커넥터의 이름입니다.
- API 응답의 관련 레코드 제목입니다. API 응답의 두 가지 추가 속성은 각 관련 레코드의 키 필드로 렌더링됩니다.
- 레코드에 대한 링크를 복사하거나 파트너 애플리케이션에서 레코드 세부 정보를 보는 데 사용할 수 있는 "추가 작업" 버튼입니다. 링크는 API 응답에 있는 관련 레코드의 URL을 기반으로 합니다.
- API 응답에서 관련 레코드의 추가 속성입니다.
관련 정보
레코드 세부 정보 보기
영업 채팅에 새로운 질문 및 답변(Q&A) 기능 추가
애플리케이션의 인사이트로 이메일 요약 보강
애플리케이션에서 얻은 인사이트로 주요 영업 정보 보강
애플리케이션에서 얻은 인사이트로 CRM 레코드 요약 보강
파트너 애플리케이션으로 Microsoft 365 영업용 Copilot 확장
영업용 Copilot 확장 빌드