重要
- 這是生產就緒型預覽功能。
- 生產就緒型預覽版應受補充使用條款所拘束。
[本文章是發行前版本文件，且隨時可能變更。]
當你使用 Salesforce 應用程式草擬電子郵件時，它會考慮郵件的意圖，並使用 Salesforce 或 Dynamics 365 的 CRM 資訊來建立草稿。 你可以用自己應用程式推薦的檔案，擴展銷售應用程式提供的電子郵件草擬功能。
注意
此功能僅支援使用 Outlook 銷售應用程式製作的電子郵件草稿。
API 描述
您必須將下列 API 描述新增至動作。 如此一來，銷售應用程式就能辨識出必須調用的正確 API，以豐富該能力。
此動作取得與電子郵件交談相關的檔案，這些檔案會顯示在 Outlook 的 C4S 電子郵件草稿中。 該動作增強銷售用 Copilot 的現有技能。
API 作業
此 API 使用作業類型：POST
輸入承載
此承載作為 API 請求的請求正文。
| 姓名 | 資料類型 | 必要 | 描述 | 要在動作中新增的描述 |
|---|---|---|---|---|
| 資源數據 | 物體 | .是 | 要用於擷取建議內容的資源資料。 如需資料結構，請前往擴充性電子郵件資料模型。 | 此輸入識別電子郵件內容，而此內容是電子郵件對話、主題及其他詳細資料的集合。 |
| 資源類型 | 字串 | .是 | 要擷取內容建議的資源類型。 例如，'email-thread' 或 'teams-chat'。 | 此輸入識別為擷取建議檔案連結而共用的資源類型，在本例中為 'email-thread'。 |
| recordType | 字串 | 否 | CRM 記錄的類型，例如客戶或商機。 | 此輸入識別 CRM 中與電子郵件對話相關的記錄類型。 |
| recordId | 字串 | 否 | 要用於建議內容之 CRM 記錄的唯一識別碼。 | 此輸入提供與電子郵件對話相關之 CRM 記錄的唯一識別碼。 |
| crmType | 字串 | 否 | CRM 系統的類型 (如果已連接)。 有效值為 Salesforce 和 Dynamics 365。 | 此輸入指示存在與電子郵件對話相關之記錄的 CRM 類型。 |
| crmOrgUrl | 字串 | 否 | CRM 組織 URL。 | 此輸入指示存在與電子郵件對話相關之記錄的 CRM 環境的 URL。 |
| inputPrompt | 字串 | 否 | 使用者為了產生電子郵件草稿所指定目前使用的建議提示。 例如，“回覆疑慮” 或 “提出提案”。 | 此輸入指示使用者在草擬電子郵件時提供的提示。 |
| 熱門 | 整數 | 否 | 要擷取的項目數。 | 此輸入指示要擷取的檔案連結數目。 |
| 略過 | 整數 | 否 | 要略過的項目數。 | 此輸入指示要在擷取建議檔案連結時略過的項目數目。 |
擴充性電子郵件資料模型
| 屬性 | 類型 | 描述 | 要在動作中新增的描述 |
|---|---|---|---|
| plaintextBody | 字串 | 完整的電子郵件本文會將電子郵件對話所有的先前訊息包含在其中。 | 此輸入以文字格式提供電子郵件對話中所有的內容。 |
| fullHtmlBody | 字串 | 電子郵件本文的完整 HTML 版本，其中包含電子郵件對話所有的先前訊息。 | 此輸入以 HTML 格式提供電子郵件對話中所有的內容。 |
| 主旨 | 字串 | 電子郵件的主旨。 | 此輸入提供電子郵件的主旨。 |
| 寄件者 | 字串 | 寄件者電子郵件地址。 | 此輸入提供寄件者的電子郵件地址。 |
| 收件者 | String[] | 收件者電子郵件地址。 | 此輸入提供收件者的電子郵件地址。 |
| 副本 | String[] | 在電子郵件副本欄位中新增的收件者電子郵件地址。 | 此輸入提供電子郵件副本欄位中包含的所有收件者電子郵件地址。 |
| 密件副本 | String[] | 在電子郵件密件副本欄位中新增的收件者電子郵件地址。 | 此輸入提供電子郵件密件副本欄位中新增的所有收件者電子郵件地址。 |
| 發送日期時間 | DateTimeOffset | 電子郵件的 UTC 格式日期和時間，以及時差屬性。 如需詳細資訊，請前往 DateTimeOffset 建構 (系統) | 此輸入提供電子郵件的時間戳記。 |
| 訊息ID | 字串 | 電子郵件的 Graph 訊息識別碼。 | 此輸入提供電子郵件的訊息識別碼。 |
| 對話ID | 字串 | 電子郵件對話的 Graph 交談識別碼。 | 此輸入提供電子郵件對話的交談識別碼。 |
輸出參數
| 屬性 | 資料類型 | 必要 | 描述 |
|---|---|---|---|
| 數值 | 陣列 | .是 | 檔案連結 (物件) 的清單，如檔案或連結內容建議回應的結構描述中所述。 |
| hasMoreResults | 布林值 | 否 | 指示是否有更多可用結果的值。 |
檔案或連結內容建議回應的結構描述
| 姓名 | 資料類型格式 | 必要 | 描述 | 要在動作中新增的描述 |
|---|---|---|---|---|
| 內容類型 | 字串 | .是 | 要顯示的內容類型。 如需詳細資訊，請前往 contentType 的預先定義值 | 此輸出指示電子郵件草稿包含的內容類型。 |
| 內容 | 字串 | .是 | 包括實際內容。 這可以是檔案的網頁或 URL。 | 此輸出指示電子郵件草稿包含的實際內容。 這可以是網頁或 URL。 |
| contentTitle （內容標題） | 字串 | .是 | 顯示給使用者的建議內容標題。 | 此輸出指示內容的標題。 |
| contentDescription | 字串 | .是 | 顯示給使用者的建議內容描述。 | 此輸出指示描述檔案時要包含的文字。 |
| contentIconUrl | 字串 | 否 | 顯示給使用者的建議內容圖示。 如果未提供，則使用一般圖示。 | 此輸出指示內容要包含的圖示。 |
| additionalProperties | 物體 | 否 | 一組名稱/值組，指示動作所傳回相關檔案連結的其他屬性。 | 此輸出以動作所傳回個別相關連結的名稱/值組形式顯示其他屬性。 |
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 的銷售
在 Microsoft 365 Copilot 中為銷售建立擴充套件