使用應用程式中的見解擴充關鍵銷售資訊 (預覽版)

發行項
12/03/2024

重要

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

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

賣家在 Outlook 中閱讀和撰寫電子郵件時，可以使用銷售用 Copilot 來檢視與電子郵件相關之連絡人、客戶和商機的關鍵銷售資訊。關鍵銷售資訊根據的是下列其中一個來源：

已連接至電子郵件的商機
最具相關性的商機，根據電子郵件中的連絡人和客戶而定

您可以使用自己應用程式中的見解來擴充銷售用 Copilot 提供的關鍵銷售資訊功能。

API 描述

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

此動作會取得其他銷售見解，這些見解將顯示在 Outlook 側車的 C4S 關鍵銷售資訊卡中。該動作增強銷售用 Copilot 的現有技能。

輸入參數

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

姓名	資料類型/格式	必要	Details	要在動作中新增的描述
recordType	字串	是	客戶關係管理 (CRM) 中的記錄類型。此記錄可以指定電子郵件相關的客戶、商機、潛在客戶或連絡人。	此輸入識別 CRM 中要求提供關鍵銷售資訊的記錄類型。
recordId	字串	是	CRM 中的記錄識別碼。	此輸入提供要求其關鍵銷售資訊之 CRM 記錄的唯一識別碼。
crmType	字串	否	CRM 系統的類型。有效值為 Salesforce 和 Dynamics 365。	此輸入指示存在 CRM 記錄且已要求關鍵銷售資訊的 CRM 類型。
crmOrgUrl	字串	否	CRM 組織 URL。	此輸入指示存在 CRM 記錄且已要求關鍵銷售資訊之 CRM 環境的 URL。
熱門	Integer	否	要擷取的見解數目。	此輸入指示要擷取的銷售重點提示數目。
skip	Integer	否	要略過的見解數。	此輸入指示要在擷取銷售重點提示時略過的項目數目。

輸出參數

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

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

見解的結構描述

姓名	資料類型/格式	必要	Details	要在動作中新增的描述
標題	字串	是	引文卡片中銷售見解的標題。其中只能包含合作夥伴的名稱，最多可以有 20 個字元。	此輸出指示見解引文卡片的標題。
description	字串	是	銷售見解的描述。這在關鍵銷售資訊窗格中顯示為顯示為項目符號列舉的重點，最多可包含 130 個字元。以下是範例：驗證：後續步驟：遵循時間表及成功準則。	此輸出指示要包含在關鍵銷售資訊中的見解文字。
url	字串	否	用於在合作夥伴應用程式中環境見解的有效 URL。	此輸出指示用於深入了解見解的 URL。
dateTime	日期時間	否	活動的 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 中檢視關鍵銷售資訊
 使用應用程式提供的見解擴充電子郵件摘要
 使用應用程式中的檔案連結來擴充電子郵件草稿
 使用應用程式提供的見解擴充 CRM 記錄詳細資料
 使用應用程式提供的見解擴充 CRM 記錄摘要
 使用合作夥伴應用程式擴充 Microsoft 365 銷售用 Copilot
建置銷售用 Copilot 延伸模組

共用方式為

使用應用程式中的見解擴充關鍵銷售資訊 (預覽版)

API 描述

輸入參數

輸出參數

見解的結構描述

範例

意見反應

其他資源

共用方式為

使用應用程式中的見解擴充關鍵銷售資訊 (預覽版)

API 描述

輸入參數

輸出參數

見解的結構描述

範例

相關資訊

意見反應

其他資源