使用應用程式中的檔案連結來擴充電子郵件草稿 (預覽版)

發行項
12/27/2024

重要

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

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

使用銷售用 Copilot 草擬電子郵件時，此應用程式會考量電子郵件的意圖，並使用 Salesforce 或 Dynamics 365 中的 CRM 資訊來建立草稿。您可以使用自己應用程式中建議的檔案來擴充銷售用 Copilot 提供的電子郵件草稿功能。

注意

只有使用 Outlook 中銷售用 Copilot 側窗格建立的電子郵件草稿才會支援此功能。

API 描述

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

此動作取得與電子郵件交談相關的檔案，這些檔案會顯示在 Outlook 的 C4S 電子郵件草稿中。該動作增強銷售用 Copilot 的現有技能。

輸入承載

名稱	資料類型	必要	描述	要在動作中新增的描述
resourceData	Object	是	要用於擷取建議內容的資源資料。如需資料結構，請前往擴充性電子郵件資料模型。	此輸入識別電子郵件內容，而此內容是電子郵件對話、主題及其他詳細資料的集合。
resourceType	字串	是	要擷取內容建議的資源類型。例如，'email-thread' 或 'teams-chat'。	此輸入識別為擷取建議檔案連結而共用的資源類型，在本例中為 'email-thread'。
recordType	字串	否	CRM 記錄的類型，例如客戶或商機。	此輸入識別 CRM 中與電子郵件對話相關的記錄類型。
recordId	字串	否	要用於建議內容之 CRM 記錄的唯一識別碼。	此輸入提供與電子郵件對話相關之 CRM 記錄的唯一識別碼。
crmType	字串	否	CRM 系統的類型 (如果已連接)。有效值為 Salesforce 和 Dynamics 365。	此輸入指示存在與電子郵件對話相關之記錄的 CRM 類型。
crmOrgUrl	字串	否	CRM 組織 URL。	此輸入指示存在與電子郵件對話相關之記錄的 CRM 環境的 URL。
inputPrompt	字串	否	使用者為了產生電子郵件草稿所指定目前使用的建議提示。例如，“回覆疑慮” 或 “提出提案”。	此輸入指示使用者在草擬電子郵件時提供的提示。
熱門	Integer	否	要擷取的項目數。	此輸入指示要擷取的檔案連結數目。
skip	Integer	否	要略過的項目數。	此輸入指示要在擷取建議檔案連結時略過的項目數目。

擴充性電子郵件資料模型

屬性	類型	描述	要在動作中新增的描述
plaintextBody	字串	完整的電子郵件本文會將電子郵件對話所有的先前訊息包含在其中。	此輸入以文字格式提供電子郵件對話中所有的內容。
fullHtmlBody	字串	電子郵件本文的完整 HTML 版本，其中包含電子郵件對話所有的先前訊息。	此輸入以 HTML 格式提供電子郵件對話中所有的內容。
主旨	字串	電子郵件的主旨。	此輸入提供電子郵件的主旨。
寄件者	字串	寄件者電子郵件地址。	此輸入提供寄件者的電子郵件地址。
收件者	String[]	收件者電子郵件地址。	此輸入提供收件者的電子郵件地址。
副本	String[]	在電子郵件副本欄位中新增的收件者電子郵件地址。	此輸入提供電子郵件副本欄位中包含的所有收件者電子郵件地址。
密件副本	String[]	在電子郵件密件副本欄位中新增的收件者電子郵件地址。	此輸入提供電子郵件密件副本欄位中新增的所有收件者電子郵件地址。
sentDateTime	DateTimeOffset	電子郵件的 UTC 格式日期和時間，以及時差屬性。如需詳細資訊，請前往 DateTimeOffset 結構 (系統)	此輸入提供電子郵件的時間戳記。
messageId	字串	電子郵件的 Graph 訊息識別碼。	此輸入提供電子郵件的訊息識別碼。
conversationId	字串	電子郵件對話的 Graph 交談識別碼。	此輸入提供電子郵件對話的交談識別碼。

輸出參數

屬性	資料類型	必要	描述
數值	陣列	是	檔案連結 (物件) 的清單，如檔案或連結內容建議回應的結構描述中所述。
hasMoreResults	布林值	否	指示是否有更多可用結果的值。

檔案或連結內容建議回應的結構描述

名稱	資料類型格式	必要	描述	要在動作中新增的描述
contentType	string	是	要顯示的內容類型。如需詳細資訊，請前往 contentType 的預先定義值	此輸出指示電子郵件草稿包含的內容類型。
內容	string	是	包括實際內容。這可以是檔案的網頁或 URL。	此輸出指示電子郵件草稿包含的實際內容。這可以是網頁或 URL。
contentTitle	string	是	顯示給使用者的建議內容標題。	此輸出指示內容的標題。
contentDescription	string	是	顯示給使用者的建議內容描述。	此輸出指示描述檔案時要包含的文字。
contentIconUrl	string	否	顯示給使用者的建議內容圖示。如果未提供，則使用一般圖示。	此輸出指示內容要包含的圖示。
additionalProperties	Object	否	一組名稱/值組，指示動作所傳回相關檔案連結的其他屬性。	此輸出以動作所傳回個別相關連結的名稱/值組形式顯示其他屬性。

contentType 的預先定義值

字串值	內容的類型
content-file	外部檔案 (一般)
content-web	外部網頁
content-doc	Microsoft Word 文件
content-pdf	Microsoft PDF 文件
content-pptx	Microsoft PowerPoint 簡報
content-xlsx	Microsoft Excel 試算表

範例

{
  "value": [
    {
      "contentType": 0,
      "content": "https://www.bing.com",
      "contentTitle": "Purchase Contract",
      "contentDescription": "Purchase Contract Description",
      "contentIconUrl": null,
      "additionalProperties": {
        "Recipients": "Logan Edwards",
        "Sender Name": "Kenny Smith"
      }
    },
    {
      "contentType": 3,
      "content": "https://www.microsoft.com",
      "contentTitle": "Strategy Planning",
      "contentDescription": "Strategy Planning Description",
      "contentIconUrl": null,
      "additionalProperties": {
        "Recipients": "Gabriela Edwards",
        "Sender Name": "Maria Smith"
      }
    },
    {
      "contentType": 1,
      "content": "https://www.bing.com",
      "contentTitle": "Contoso Website",
      "contentDescription": "Contoso Website Description",
      "contentIconUrl": null,
      "additionalProperties": {
        "Total Views": "100",
        "Domain": "Contoso.com"
      }
    }
  ],
  "hasMoreResults": false
}

下圖中的範例顯示如何將 API 輸出對應至電子郵件草稿。

螢幕擷取畫面顯示電子郵件草稿中來自合作夥伴應用程式的檔案連結。

圖例：

來自合作夥伴應用程式的檔案連結。

另請參閱

透過 Outlook 中的 Copilot，使用銷售資訊來建立電子郵件對話的摘要
 使用應用程式提供的見解擴充電子郵件摘要
 使用應用程式中的見解擴充關鍵銷售資訊
 使用應用程式提供的見解擴充 CRM 記錄詳細資料
 使用應用程式提供的見解擴充 CRM 記錄摘要
 使用合作夥伴應用程式擴充 Microsoft 365 銷售用 Copilot
建置銷售用 Copilot 延伸模組

共用方式為