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

아티클
10/02/2024

중요

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

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

판매자는 저장된 연락처에 대한 세부 정보와 계정 및 기회와 같은 관련 기록을 함께 볼 수 있습니다. 귀하의 애플리케이션에서 얻은 통찰력을 통해 영업용 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을 나타냅니다.

참고

이 확장 프로그램 가리키다는 Outlook 사이드카에서 최대 5개의 커넥터 확장 프로그램으로부터 인사이트를 렌더링하는 것을 지원합니다.

출력 매개 변수

영업용 Copilot는 API로부터 통찰력(객체) 목록을 수신하고 각 통찰력에 특정 매개변수가 있기를 기대합니다. 영업용 Copilot가 출력을 올바르게 구문 분석할 수 있도록 하려면 응답 구조가 다음 표의 지침을 준수해야 합니다.

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

통찰력을 위한 스키마

입력	데이터 유형/형식	필수	세부 사항	동작에 추가할 설명
recordId	String	네	레코드의 고유 식별자입니다.	이 출력은 작업에서 반환된 각 관련 레코드를 고유하게 식별합니다.
recordTypeDisplayName	String	네	레코드 종류의 표시 이름(예: 계약). `Accept-Language` 헤더를 통해 지정된 언어로 현지화되어야 합니다.	이 출력은 작업에서 반환된 각 관련 레코드의 레코드 종류의 표시 이름을 나타냅니다.
recordTypePluralDisplayName	String	네	레코드 종류의 복수형 표시 이름(예: 계약). `Accept-Language` 헤더를 통해 지정된 언어로 현지화되어야 합니다.	이 출력은 작업에서 반환된 각 관련 레코드의 레코드 종류에 대한 복수형 표시 이름을 나타냅니다.
recordType	String	네	레코드 종류의 시스템 이름(예: 계약).	이 출력은 작업에서 반환된 각 관련 레코드의 종류를 나타냅니다.
recordTitle	String	네	Contoso 2023 갱신 계약과 같은 레코드 이름.	이 출력은 작업에서 반환된 각 관련 레코드의 제목을 나타냅니다.
URL	String	없음	파트너 애플리케이션에서 레코드를 여는 유효한 URL입니다.	이 출력은 작업에서 반환된 각 관련 레코드의 URL을 나타냅니다.
additionalProperties	속성 이름 과 속성 값 이 문자열 유형인 객체	없음	자세한 보기에 표시되는 추가 속성입니다. 속성 이름과 값은 `Accept-Language` 헤더를 통해 지정된 언어로 된 자연어로 표시됩니다. 예를 들어 다음과 같습니다. { "상태 설명": "로그오프됨", "소유자": "케니 스미스" }	이 출력은 작업에서 반환된 각 관련 레코드의 이름-값 쌍으로 추가 속성을 나타냅니다.

예

{
    "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 확장 프로그램 빌드

다음을 통해 공유