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

重要

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

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

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

API 描述

您必須將下列 API 描述新增至動作。如此一來，銷售應用程式就能辨識出必須調用的正確 API，以豐富該能力。

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

API 作業

此 API 使用作業類型：GET

輸入參數

銷售應用程式設計用來為你的 API 提供以下輸入參數。

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

輸出參數

銷售應用程式預期會從你的 API 收到一份洞察（物件）清單，並且預期每個洞察都有特定的參數。為確保銷售應用程式能正確解析輸出，回應結構必須遵循下表的指引。

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

見解的結構描述

姓名	資料類型/格式	必要	詳細資訊	要在動作中新增的描述
標題	字串	.是	引文卡片中見解的標題。這是使用透過 `Accept-Language` 要求標頭所指定之語言的見解的自然語言標題。以下是範例：簽署的合約。	此輸出指示引文卡片中活動的標題。
說明	字串	.是	見解的描述。這在記錄摘要中顯示為項目符號列舉的重點，並且是見解的自然語言描述，採用透過 `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。

檢視記錄摘要
 使用應用程式提供的見解擴充電子郵件摘要
 使用應用程式中的檔案連結來擴充電子郵件草稿
 使用您應用程式中的資料來豐富機會洞察
 使用應用程式提供的見解擴充 CRM 記錄詳細資料
 透過合作夥伴應用程式延長 Microsoft 365 Copilot 的銷售
 在 Microsoft 365 Copilot 中為銷售建立擴充套件

意見反應

此頁面對您有幫助嗎？

Last updated on 2025-11-20