使用應用程式提供的見解擴充 CRM 記錄摘要 (預覽版)

發行項
12/03/2024

重要

這是生產就緒型預覽功能。
生產就緒型預覽版應受補充使用條款所拘束。

[本文章是發行前版本文件，隨時可能變更。]

為了更充分了解他們準備中會議或閱讀中電子郵件的來龍去脈，賣家需要相關的客戶關係管理 (CRM) 資訊，例如客戶查詢、疑慮和附註。銷售用 Copilot 使用 AI 產生每個 CRM 記錄的摘要。此摘要會特別指出銷售階段、預算和預計結案日期等重要詳細資料。您可以使用自己應用程式中的見解來擴充銷售用 Copilot 提供的 CRM 記錄摘要功能。

API 描述

您必須將下列 API 描述新增至動作。這樣，銷售用 Copilot 就可以識別必須叫用的正確 API 來擴充功能。

此動作會取得與 CRM 記錄相關的其他銷售見解，這些見解將顯示在 C4S 記錄摘要卡中。該動作增強銷售用 Copilot 的現有技能。

輸入參數

Copilot for Sales 旨在向 API 提供下列輸入參數。

名稱	資料類型/格式	必要	Details	要在動作中新增的描述
recordType	字串	是	CRM 中要求相關見解 (例如活動) 的實體或物件類型。該值包含與語言無關的實體或物件類型唯一名稱，而不是可當地語系化的顯示名稱。範例包括客戶和商機。	此輸入指示 CRM 中要求見解的實體或物件類型。
recordId	字串	是	CRM 記錄的唯一識別碼	此輸入指示要求見解之 CRM 記錄的唯一識別碼。
startDateTime	「日期時間」格式的字串	否	要查詢見解的開始日期和時間。格式遵循 OpenAPI 規格。以下是範例：2017-07-21T17:32:28Z。	此輸入指示要求見解的開始日期和時間。
endDateTime	「日期時間」格式的字串	否	要查詢見解的結束日期和時間。格式遵循 OpenAPI 規格。以下是範例：2017-07-21T17:32:28Z。	此輸入指示要求見解的結束日期和時間。
熱門	Integer	否	要擷取的見解數目。	此輸入指示要擷取的見解數目。
skip	Integer	否	要略過的見解數。	此輸入指示要略過的見解數目。
crmType	字串	否	有效值為 Dynamics 365 和 Salesforce。	此輸入指示存在 CRM 記錄且已要求見解的 CRM 類型。
crmOrgUrl	字串	否	CRM 組織的主機名稱，例如 contoso.crm.dynamics.com。	此輸入指示存在 CRM 記錄且已要求見解之 CRM 環境的 URL。

輸出參數

銷售用 Copilot 需要從 API 收到見解 (物件) 清單，並要求每個見解都必須有特定參數。為了確保銷售用 Copilot 可以正確剖析輸出，回應結構必須遵循下表中的指導方針。

參數	資料類型	必要	Details
數值	陣列	是	依照見解的結構描述一節中所述定義的見解 (物件) 清單。
hasMoreResults	布林值	否	指示是否有更多可用結果的值。

見解的結構描述

名稱	資料類型/格式	必要	Details	要在動作中新增的描述
標題	字串	是	引文卡片中見解的標題。這是使用透過 `Accept-Language` 要求標頭所指定之語言的見解的自然語言標題。以下是範例：簽署的合約。	此輸出指示引文卡片中活動的標題。
description	字串	是	見解的描述。這在記錄摘要中顯示為項目符號列舉的重點，並且是見解的自然語言描述，採用透過 `Accept-Language` 標頭所指定的語言。以下是範例：Kenny、Logan 和另外兩人已於 2023 年 9 月 7 日簽署 Contoso 2023 續約合約。	此輸出指示見解的描述。
dateTime	「日期時間」格式的字串	是	活動的 UTC 格式日期和時間。如果活動同時有開始時間和結束時間，則應用程式必須決定要顯示哪個時間。格式遵循 OpenAPI 規格。以下是範例：2017-07-21T17:32:28Z。	此輸出指示與見解相關聯的時間。
url	字串	否	用於在合作夥伴應用程式中開啟活動的有效 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 輸出對應至記錄摘要。

螢幕擷取畫面顯示合作夥伴應用程式中最新活動的剖析。

圖例：

區段顯示來自合作夥伴應用程式的見解。區段標題衍生自 Microsoft Power Platform 連接器的名稱。
API 回應中見解的描述。
可選取來檢視見解相關詳細資料的引文編號。
引文卡片顯示有關見解的詳細資訊。
見解的圖示和標題。圖示是從 Microsoft Power Platform 連接器中繼資料中擷取。標題文字是 API 回應中見解的標題。
API 回應中見解的其他屬性。
合作夥伴應用程式的名稱。顯示的名稱是 Microsoft Power Platform 連接器的名稱。
可選取來檢視合作夥伴應用程式中見解詳細資料的連結。這基於 API 回應中見解的 URL。

檢視記錄摘要
 將新的問與答 (Q&A) 功能新增至銷售聊天
 使用應用程式提供的見解擴充電子郵件摘要
 使用應用程式中的見解擴充關鍵銷售資訊
 使用應用程式提供的見解擴充 CRM 記錄詳細資料
 使用合作夥伴應用程式擴充 Microsoft 365 銷售用 Copilot
建置銷售用 Copilot 延伸模組

共用方式為

使用應用程式提供的見解擴充 CRM 記錄摘要 (預覽版)

API 描述

輸入參數

輸出參數

見解的結構描述

範例

意見反應

其他資源

共用方式為

使用應用程式提供的見解擴充 CRM 記錄摘要 (預覽版)

API 描述

輸入參數

輸出參數

見解的結構描述

範例

相關資訊

意見反應

其他資源