使用應用程式提供的見解擴充電子郵件摘要 (預覽版)
重要
- 這是生產就緒型預覽功能。
- 生產就緒型預覽版應受補充使用條款所拘束。
[本文章是發行前版本文件，隨時可能變更。]
將 Outlook 中的 Copilot 與銷售用 Copilot 一起使用時，Outlook 中顯示的電子郵件摘要會包含源自客戶關係管理 (CRM) 系統 (例如 Dynamics 365 或 Salesforce CRM) 的銷售資訊。 您可以使用自己應用程式中的見解來擴充銷售用 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 類型。 |
| 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 延伸模組