使用應用程式提供的見解擴充電子郵件摘要 (預覽版)
重要
- 這是生產就緒型預覽功能。
- 生產就緒型預覽版應受補充使用條款所拘束。
[本文章是發行前版本文件，隨時可能變更。]
將 Outlook 中的 Copilot 與銷售用 Copilot 一起使用時，Outlook 中顯示的電子郵件摘要會包含源自客戶關係管理 (CRM) 系統 (例如 Dynamics 365 或 Salesforce CRM) 的銷售資訊。 您可以使用自己應用程式中的見解來擴充銷售用 Copilot 提供的電子郵件摘要功能。
API 描述
您必須將下列 API 描述新增至動作。 這樣，銷售用 Copilot 就可以識別必須叫用的正確 API 來擴充功能。
此動作會取得其他銷售見解，這些見解將顯示在 Outlook 摘要中的 C4S 電子郵件摘要體驗中。 該動作增強銷售用 Copilot 的現有技能。
API 作業
此 API 使用作業類型：GET
輸入參數
Copilot for Sales 旨在向 API 提供下列輸入參數。
| 姓名 | 資料類型/格式 | 必要 | Details | 要在動作中新增的描述 |
|---|---|---|---|---|
| recordType | 字串 | 否 | CRM 中的記錄類型。 此記錄可以指定電子郵件相關的客戶、商機、潛在客戶或連絡人。 | 此輸入識別 CRM 中與摘要電子郵件相關的記錄類型。 |
| recordId | 字串 | 否 | CRM 中要求相關記錄的記錄識別碼。 | 此輸入提供與摘要電子郵件相關之 CRM 記錄的唯一識別碼。 |
| crmType | 字串 | 否 | CRM 系統的類型。 有效值為 Salesforce 和 Dynamics 365。 | 此輸入指示存在與摘要電子郵件相關之記錄的 CRM 類型。 |
| crmOrgUrl | 字串 | 否 | CRM 組織 URL。 | 此輸入指示存在與摘要電子郵件相關之記錄的 CRM 環境的 URL。 |
| emailContacts | 字串 | 是 | 電子郵件地址的逗號分隔清單，例如 kenny@contoso.com,logan@contoso.com。 |
此輸入指示目前電子郵件對話中所有相關參與者電子郵件的清單。 |
| 上 | Integer | 否 | 要擷取的見解數目。 | 此輸入指示要擷取的見解數目。 |
| 跳過 | Integer | 否 | 要略過的見解數。 | 此輸入指示要在擷取見解時略過的項目數目。 |
輸出參數
銷售用 Copilot 需要從 API 收到見解 (物件) 清單，並要求每個見解都必須有特定參數。 為了確保銷售用 Copilot 可以正確剖析輸出，回應結構必須遵循下表中的指導方針。
| 參數 | 資料類型 | 必要 | Details |
|---|---|---|---|
| 數值 | 陣列 | 是 | 依照見解的結構描述一節中所述定義的見解 (物件) 清單。 注意：雖然此參數包含見解清單，但在電子郵件擴充摘要中僅使用第一個見解。 |
| hasMoreResults | 布林值 | 否 | 指示是否有更多可用結果的值。 |
見解的結構描述
| 姓名 | 資料類型/格式 | 必要 | Details | 要在動作中新增的描述 |
|---|---|---|---|---|
| 名稱 | 最多 20 個字元的字串 | 是 | 銷售見解的標題。 | 此輸出指示合作夥伴區段的標題，必須僅包含合作夥伴的名稱。 |
| Description | 字串 | 是 | 提供給使用者的見解，例如 您的同事 Mona Kane、Ray Tanaka 和 Daniela Smith 以前與他們合作過。 | 此輸出指出您想要包含在電子郵件摘要中的文字。 |
注意
雖然擴充電子郵件摘要功能和記錄摘要功能的 API 需求可能看起來相似，但這些需求必須在連接器中新增為不同的動作。
範例
{
"value": [
{
"title": "From Contoso Customer Insights",
"description": "Your colleagues Mona Kane, Ray Tanaka, and Daniela Smith have worked with them before."
}
],
"hasMoreResults": false
}
下圖中的範例顯示如何將 API 輸出對應至電子郵件摘要。
圖例：
- 見解的標題。 標題相同的見解會一起組成群組。
- 見解的描述。 每個見解都有一項描述。
相關資訊
透過 Outlook 中的 Copilot，使用銷售資訊來建立電子郵件對話的摘要
使用應用程式中的見解擴充關鍵銷售資訊
使用應用程式提供的見解擴充 CRM 記錄詳細資料
使用應用程式提供的見解擴充 CRM 記錄摘要
使用合作夥伴應用程式擴充 Microsoft 365 銷售用 Copilot
使用應用程式中的檔案連結來擴充電子郵件草稿
建置銷售用 Copilot 延伸模組