共用方式為

使用您應用程式所提供的內容建議來擴充電子郵件摘要 (預覽版)

重要

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

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

當 Outlook 中的 Copilot 與銷售應用程式一起使用時，Outlook 中顯示的電子郵件摘要包含來自您的客戶關係管理系統（CRM）如 Dynamics 365 或 Salesforce CRM 的銷售資訊。 你可以利用銷售應用程式提供的電子郵件摘要功能，透過從你自己的應用程式中獲得的洞察來加以擴充。

注意

此 API 將現有電子郵件摘要技能 API 取代為新版本 (作業識別碼：scp-get-email-insights)。

API 描述

您必須將下列 API 描述新增至動作。 這有助於銷售應用程式識別正確的 API 來強化能力。

此動作會取得其他銷售見解，這些見解將顯示在 Outlook 摘要中的 C4S 電子郵件摘要體驗中。 該動作增強銷售用 Copilot 的現有技能。

API 詳細資料

  • API 名稱：電子郵件摘要技能版本 2
  • Swagger 作業識別碼：scp-get-email-insights-v2
  • Swagger 作業方法：張貼
  • 路徑: <PowerAppsConnectorHostName>/api/enhanceskills/email-insights-v2

輸入承載

此承載作為 API 請求的請求正文。

姓名 資料類型 必要 描述 要在動作中新增的描述
資源數據 物體 .是 要用於擷取建議內容的資源資料。 如需資料結構，請前往擴充性電子郵件資料模型。 此輸入識別電子郵件內容，而此內容是電子郵件對話、主題及其他詳細資料的集合。
relatedEntities 陣列 否 相關實體的陣列。 如需資料結構，請前往相關實體資料模型。 此輸入可識別與電子郵件對話相關的 CRM 記錄陣列。
crmType 字串 否 CRM 系統的類型 (如果已連接)。 有效值為 Salesforce 和 Dynamics 365。 此輸入指示存在與電子郵件對話相關之記錄的 CRM 類型。
crmOrgUrl 字串 否 CRM 組織 URL。 此輸入指示存在與電子郵件對話相關之記錄的 CRM 環境的 URL。
熱門 整數 否 要擷取的項目數。 此輸入指示要擷取的檔案連結數目。
略過 整數 否 要略過的項目數。 此輸入指示要在擷取建議檔案連結時略過的項目數目。

擴充性電子郵件資料模型

屬性 類型 描述 要在動作中新增的描述
plaintextBody 字串 完整的電子郵件本文會將電子郵件對話所有的先前訊息包含在其中。 此輸入以文字格式提供電子郵件對話中所有的內容。
fullHtmlBody 字串 電子郵件本文的完整 HTML 版本，其中包含電子郵件對話所有的先前訊息。 此輸入以 HTML 格式提供電子郵件對話中所有的內容。
主旨 字串 電子郵件的主旨。 此輸入提供電子郵件的主旨。
寄件者 字串 寄件者電子郵件地址。 此輸入提供寄件者的電子郵件地址。
收件者 String[] 收件者電子郵件地址。 此輸入提供收件者的電子郵件地址。
副本 String[] 電子郵件副本欄位中新增的收件者電子郵件地址。 此輸入提供電子郵件副本欄位中包含的所有收件者電子郵件地址。
密件副本 String[] 電子郵件密件副本欄位中新增的收件者電子郵件地址。 此輸入提供電子郵件密件副本欄位中新增的所有收件者電子郵件地址。
發送日期時間 DateTimeOffset 電子郵件的 UTC 格式日期和時間，以及時差屬性。 如需詳細資訊，請前往 DateTimeOffset 建構 (系統) 此輸入提供電子郵件的時間戳記。
訊息ID 字串 電子郵件的 Graph 訊息識別碼。 此輸入提供電子郵件的訊息識別碼。
對話ID 字串 電子郵件對話的 Graph 交談識別碼。 此輸入提供電子郵件對話的交談識別碼。
屬性 類型 必要 描述 要在動作中新增的描述
entityId 字串 .是 CRM 記錄的類型，例如客戶或商機。 此輸入提供與電子郵件對話相關之 CRM 記錄的唯一識別碼。
entityType 字串 .是 要用於建議內容之 CRM 記錄的唯一識別碼。 此輸入識別 CRM 中與電子郵件對話相關的記錄類型。
entitySource 字串 否 此輸入指示實體來源，目前包含 "已連接" 或空值。 此輸入指示實體來源類型。

輸出參數

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

參數 資料類型 必要 描述
數值 陣列 .是

依照見解的結構描述一節中所述定義的見解 (物件) 清單。

注意：儘管此參數包含見解清單，但 Outlook 畫布體驗的電子郵件擴充摘要中只會使用第一項見解。
hasMoreResults 布林值 否 指示是否有更多可用結果的值。

見解的結構描述

姓名 資料類型/格式 必要 描述 要在動作中新增的描述
深入解析 字串 .是 提供給使用者的見解，例如 您的同事 Mona Kane、Ray Tanaka 和 Daniela Smith 以前與他們合作過。 此輸出指出您想要包含在電子郵件摘要中的文字。

範例

{
    "value": [
        {
            "insight": "Your colleagues Mona Kane, Ray Tanaka and Daniela Smith have worked with them before."
        },
        {
            "insight": "The email was opened three times in the last month."
        }
    ],
    "hasMoreResults": false
}

下圖中的範例顯示如何將 API 的輸出對應至側窗格中的電子郵件摘要。

螢幕擷取畫面顯示電子郵件摘要中來自合作夥伴應用程式的見解。

圖例：

  1. 見解的標題。 標題相同的見解會一起組成群組。
  2. 見解的描述。 每個見解都有一項描述。

下圖中的範例顯示如何將 API 的輸出對應至電子郵件本文中的電子郵件摘要。

螢幕擷取畫面顯示電子郵件本文中合作夥伴應用程式的見解。

圖例：

  1. 見解的標題。 標題相同的見解會一起組成群組。
  2. 見解的描述。 每個見解都有一項描述。

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

  • Last updated on