애플리케이션에서 얻은 인사이트로 주요 영업 정보 보강(프리뷰)
중요
- 프로덕션 준비 미리 보기 기능입니다.
- 프로덕션 준비 미리 보기에는 추가 사용 약관이 적용됩니다.
[이 문서는 시험판 문서이며 변경될 수 있습니다.]
판매자는 Outlook에서 이메일을 읽고 작성하는 동안 영업용 Copilot을 사용하여 이메일과 관련된 연락처, 거래처 및 영업 기회에 대한 주요 영업 정보를 볼 수 있습니다. 주요 영업 정보는 다음 소스 중 하나를 기반으로 합니다.
- 이메일에 연결된 영업 기회
- 이메일의 연락처 및 거래처를 기반으로 하는 가장 관련성이 높은 영업 기회
영업용 Copilot에서 제공하는 주요 영업 정보 기능을 자체 애플리케이션의 인사이트로 확장할 수 있습니다.
API 설명
작업에 다음 API 설명을 추가해야 합니다. 이러한 방식으로 영업용 Copilot은 기능을 보강하기 위해 호출해야 하는 올바른 API를 식별할 수 있습니다.
이 작업은 Outlook 사이드카의 C4S 주요 영업 정보 카드에 표시되는 추가 영업 인사이트를 가져옵니다. 이 작업은 영업용 Copilot의 기존 기술을 향상시킵니다.
입력 매개 변수
Copilot for Sales는 API에 다음 입력 매개 변수를 제공하도록 설계되었습니다.
| 입력 | 데이터 유형/형식 | 필수 | 세부 사항 | 작업에 추가할 설명 |
|---|---|---|---|---|
| recordType | String | 네 | CRM(고객 관계 관리)의 레코드 종류입니다. 레코드는 이메일과 관련된 거래처, 영업 기회, 잠재 고객 또는 연락처를 지정할 수 있습니다. | 이 입력은 주요 영업 정보가 요청된 CRM의 레코드 종류를 식별합니다. |
| recordId | String | 네 | CRM의 레코드 ID입니다. | 이 입력은 주요 영업 정보가 요청되는 CRM 레코드의 고유 식별자를 제공합니다. |
| crmType | String | 없음 | CRM 시스템의 유형입니다. 유효한 값은 Salesforce 및 Dynamics 365입니다. | 이 입력은 주요 영업 정보가 요청되는 CRM 레코드가 존재하는 CRM 유형을 나타냅니다. |
| crmOrgUrl | String | 없음 | CRM 조직 URL입니다. | 이 입력은 주요 영업 정보가 요청되는 CRM 레코드가 있는 CRM 환경의 URL을 나타냅니다. |
| 최고 | Integer | 없음 | 가져올 인사이트 수입니다. | 이 입력은 가져올 영업 하이라이트 수를 나타냅니다. |
| skip | Integer | 없음 | 건너뛸 인사이트 수입니다. | 이 입력은 영업 하이라이트를 가져올 때 건너뛸 항목 수를 나타냅니다. |
출력 매개 변수
영업용 Copilot은 API에서 인사이트(개체) 목록을 수신할 것으로 예상하며 각 인사이트에 특정 매개 변수가 있을 것으로 예상합니다. 영업용 Copilot이 출력을 올바르게 구문 분석할 수 있도록 하려면 응답 구조가 다음 표의 지침을 준수해야 합니다.
| 매개 변수 | 데이터 형식 | 필수 | 세부 사항 |
|---|---|---|---|
| value | 배열 | 네 | 인사이트에 대한 스키마 섹션에 설명된 대로 정의된 인사이트(개체) 목록입니다. |
| hasMoreResults | 부울 | 없음 | 더 많은 결과를 사용할 수 있는지 여부를 나타내는 값입니다. |
인사이트에 대한 스키마
| 입력 | 데이터 유형/형식 | 필수 | 세부 사항 | 작업에 추가할 설명 |
|---|---|---|---|---|
| 제목 | String | 네 | 영업 인사이트 인용 카드의 제목입니다. 파트너의 이름만 포함해야 하며 최대 20자까지 입력할 수 있습니다. | 이 출력은 인사이트에 대한 인용 카드의 제목을 나타냅니다. |
| description | String | 네 | 영업 인사이트에 대한 설명입니다. 이는 주요 영업 정보 창에 글머리 기호로 표시되며 최대 130자까지 입력할 수 있습니다. 예를 들면 다음과 같습니다. 유효성 검사: 다음 단계: 타임라인 및 성공 기준에 맞추기. | 이 출력은 주요 영업 정보에 포함될 인사이트의 텍스트를 나타냅니다. |
| URL | String | 없음 | 파트너 애플리케이션에서 인사이트를 여는 유효한 URL입니다. | 이 출력은 인사이트에 대해 자세히 알아볼 수 있는 URL을 나타냅니다. |
| 날짜/시간 | 날짜/시간 | 없음 | UTC 형식의 활동 날짜 및 시간입니다. 활동에 시작 시간과 종료 시간이 모두 있는 경우 애플리케이션은 표시할 시간을 결정해야 합니다. 형식은 OpenAPI 사양을 따릅니다. 예를 들어 2017-07-21T17:32:28Z와 같습니다. | 이 출력은 인사이트와 관련된 시간을 나타냅니다. |
| additionalProperties | 문자열 유형의 속성 이름 및 속성 값 값을 갖는 개체 | 없음 | 작업이 반환하는 관련 인사이트의 추가 속성을 나타내는 이름-값 쌍 집합입니다. 이 정보는 사용자가 주요 영업 정보 창에서 인사이트를 선택하면 팝업 카드에 표시됩니다. | 이 출력은 작업에서 반환된 각 관련 인사이트의 이름-값 쌍으로 추가 속성을 나타냅니다. |
예
{
"value": [
{
"title": "Contract signed",
"description": "Kenny Smith sent Renewal Contract on 04/23/2023 related to 50 Cafe A-100 Automatic",
"dateTime": "2023-09-07T03:42:35.4662309Z",
"url": https://contosohub.com,
"additionalProperties": {
"Contract name": "Renewal contract for Fourth Coffee",
"Signed by": "Alberto Burgos, Tony Benis",
"Signed": "9/7/23",
"Related Opportunity": "50 CafeA-100 Automatic"
}
}
],
"hasMoreResults": false
}
다음 이미지의 예는 API의 출력이 주요 영업 정보에 매핑되는 방법을 보여줍니다.
범례:
- 파트너 애플리케이션의 인사이트를 보여 주는 섹션입니다. 섹션 제목은 Microsoft Power Platform 커넥터 이름에서 파생됩니다.
- API 응답의 인사이트에 대한 설명입니다.
- 인사이트에 대한 세부 정보를 보기 위해 선택할 수 있는 인용 번호입니다.
- 인사이트에 대한 세부 정보를 보여주는 인용 카드입니다.
- 인사이트의 아이콘 및 제목입니다. 아이콘은 Microsoft Power Platform 커넥터 메타데이터에서 검색됩니다. 제목은 API 응답의 인사이트 제목입니다.
- API 응답의 인사이트에 대한 추가 속성입니다.
- 파트너 애플리케이션의 이름. 표시되는 이름은 Microsoft Power Platform 커넥터의 이름입니다.
- 파트너 애플리케이션에서 인사이트 세부 정보를 보기 위해 선택할 수 있는 링크입니다. API 응답의 인사이트 URL을 기반으로 합니다.
관련 정보
Copilot for Sales에서 주요 영업 정보 보기
영업 채팅에 새로운 질문 및 답변(Q&A) 기능 추가
애플리케이션의 인사이트로 이메일 요약 보강
애플리케이션에서 얻은 인사이트로 CRM 레코드 세부 정보 보강
애플리케이션에서 얻은 인사이트로 CRM 레코드 요약 보강
파트너 애플리케이션으로 Microsoft 365 영업용 Copilot 확장
영업용 Copilot 확장 빌드