共用方式為

使用自動化字典傳遞參數索引鍵

  • 發行項

重要

對全通路管理應用程式的支援已於 2022 年 4 月 30 日結束，而且此應用程式也在 2023 年 7 月移除。 建議您使用 Customer Service 系統管理中心應用程式來設定最新功能，例如整合路由和語音管道。 其他資訊：全通路管理應用程式已被取代

自動化字典會維護工作階段的內容資料。 您可以使用自動化字典中的索引鍵，傳遞動作中的參數。

在管理應用程式中建立範本和巨集時，您可以傳遞參數索引鍵，例如工作階段標題、通知標題、應用程式索引標籤範本標題，以及應用程式索引標籤類型的自訂參數值。 這些索引鍵會根據執行時可用的內容資訊來取代。

在範本中傳送資料參數

現在我們來看看有通知的範本案例。

通知會顯示特定欄位和值，分別稱為欄位標題和值。

客戶 Kenny Smith 展開了一段交談，當專員查看通知時，系統將客戶名稱顯示為 Kenny Smith。

此例中，欄位標題為客戶名稱，而值為 Kenny Smith。

若要讓範本將客戶的名稱識別為 Kenny Smith，您 (系統管理員) 必須將參數當做索引鍵來傳遞。

同樣地，對於工作階段和通知標題，您可以傳遞資料參數。 其他資訊：資料參數索引鍵的自動化字典格式

系統會根據工作階段、管道提供者、Microsoft Dataverse 和使用者動作的內容，取代參數索引鍵為實際值。 其他資訊：內容資料參數類型

在巨集和專員指令碼中傳遞資料參數

巨集是一組依使用者指定執行的已設定的循序動作。 身為系統管理員，您需要設定巨集必須執行的動作。 若要設定動作，您需要傳送資料參數。 其他資訊：用於傳遞資料參數索引鍵的自動化字典格式

當專員執行巨集時，系統會根據工作階段、管道提供者、Dataverse 和使用者動作的內容，取代參數索引鍵為實際值。

內容來自工作階段時，巨集動作是根據目前工作階段的資訊來執行，其中的資訊是從 [錨點] 索引標籤或目前焦點所在的索引標籤取得。 例如，若要建立案例，您必須定義包含事件實體表單及表單 GUID (選用) 的動作。 其他資訊：內容資料參數的類型

內容資料參數類型

自動化字典使用下列來源所提供的內容資料參數：

自動化字典。

來自管道提供者的內容資料

此內容資料來自第一方管道提供者 (例如 Customer Service 全通路) 或第三方管道提供者 (使用 Dynamics 365 管道整合架構所公開的 widget)。 Customer Service 全通路中的內容資料是聊天前問卷、訪客入口網站導覽等資料。

使用者動作中的內容資料

當專員在工作階段中執行某些活動時，系統會填入此資料。 例如，開啟新客戶記錄和案例等等。

來自 Dataverse 的內容資料

組織資料會儲存在 Dataverse 中，您可以使用 OData 查詢來擷取資料。 其他資訊：OData 查詢

來自其他巨集動作的內容資料

巨集中的動作會產生由該巨集中其他動作使用的內容資料。

例如，下列順序有兩個動作步驟：

  1. 開啟新的表單以建立記錄。
  2. 開啟包含預先定義範本的電子郵件表單。

當建立開啟包含預先定義範本的電子郵件表單時，您可以從開啟新的表單以建立記錄巨集動作步驟中，得到內容資料參數索引鍵。

第一個巨集動作中的內容資料參數如下：

  • 實體邏輯名稱
  • 頁面類型
  • 索引標籤識別碼

Note

其他巨集動作的內容資料參數是巨集所專用，並不適用於範本。

自動化字典格式以傳遞資料參數鍵

自動化字典會維護工作階段的內容資料。 自動化字典中的索引鍵可做為參數，傳送給巨集中的動作。 系統會根據工作階段、管道提供者、Dataverse 和使用者動作的內容，取代參數索引鍵為實際值。

自動化字典支援下列格式：

動態資料欄位

動態資料欄位是系統根據取內容填入資料的取代參數。 下列動態資料欄位清單只能用於巨集和專員指令碼，以及藉由使用專員指令碼運算式產生器用來將專員指令碼設定為預設值。 其他資訊：生產力工具

動態資料欄位適用於生產力工具 (巨集和專員指令碼)

巨集和專員指令碼支援下列動態資料欄位：

動態資料欄位 描述
${customerName} 起始交談的客戶的名稱。
${caseId} 案例的唯一識別碼。 只有在案例已連結至交談時，系統才會顯示案例識別碼。
${caseTitle} 案例的標題。 只有在案例已連結至交談時，系統才會顯示案例標題。
${LiveWorkItemId} 交談的唯一識別碼。
${queueId} 佇列的唯一識別碼。 此英數字元字串會顯示在佇列頁面 URL 中。
${visitorLanguage} 發起交談客戶的語言。
${visitorDevice} 發起交談客戶的裝置。
${entityRoutingLogicalName} 實體的名稱 (如果是實體記錄的通知)。
${customerEntityName} 實體 (連絡人或客戶) 的名稱 (如果客戶已驗證)。
${customerRecordId} 實體 (連絡人或客戶) 的唯一識別碼 (如果客戶已驗證)。
${<name of the pre-conversation survey questions>} 所有針對工作流設定的交談前問卷問題，都會將動態資料欄位名稱做為問題名稱。

Note

Customer Service workspace 的巨集和指令碼僅支援 ${anchor.<attribute_name>} 動態資料欄位。

下列動態資料欄位會用來產生可與客戶分享的重新連接連結，以連接回到相同的專員和交談。 其他資訊：設定上一個聊天的重新連接

動態資料欄位 描述
{ReconnectUrl{ReconnectID}} 用於快速回覆以產生重新連接連結。

生產力工具的動態資料欄位格式

從管道提供者、目前使用者工作階段、其他巨集動作輸出或 Dataverse 擷取內容的 ${Slug} 參數格式。

生產力自動化內容

當您想要在生產力自動化內容中執行動態資料欄位 (這會用來執行與 Dynamics 365 中模型導向應用程式相關的作業) 時，請使用 ${</slug/>} 例如：${customerName}

工作階段連接器內容

當您想要在工作階段內容中執行動態資料欄位時，您必須使用 ${$session.<slug>} 格式。 例如：${$session.customerName}

適用於工作階段內容的動態資料欄位包括：

  • ${$session.visitorDevice}
  • ${$session.visitorDevice}
  • ${$session.entityRoutingLogicalName}
  • ${$session.entityRoutingRecordId}
  • ${$session.<name of the pre-chat survey questions>

全通路連接器內容

當您想要在 Customer Service 全通路內容中執行動態資料欄位時，您必須使用 ${$oc.<slug>} 格式。 例如：${$oc.customerName}

Session.CurrentTab.<Attribute> 和 Session.AnchorTab.<Attribute> 參數會根據目前工作階段以及錨點索引標籤或目前焦點所在的索引標籤來提供內容資料。 以下是支援的屬性類型：

  • EntityName
  • EntityId

範例：

  • Session.CurrentTab.<EntityName>
  • Session.CurrentTab.<EntityId>
  • Session.AnchorTab.<EntityName>
  • Session.AnchorTab.<EntityId>

Note

Session.CurrentTab.<Attribute> 和 Session.AnchorTab.<Attribute> 參數僅適用於巨集，而不適用於範本。

範本的動態資料欄位

支援的動態資料欄位清單如下：

動態資料欄位 描述
{anchor.<attribute_name>} 可用來存取錨點索引標籤中所載入記錄的屬性。
{customerName} 起始交談的客戶的名稱。
{caseId} 案例的唯一識別碼。 只有在案例已連結至交談時，系統才會顯示案例識別碼。
{caseTitle} 案例的標題。 只有在案例已連結至交談時，系統才會顯示案例標題。
{queueId} 佇列的唯一識別碼。 此英數字元字串會顯示在佇列頁面 URL 中。
{visitorLanguage} 發起交談客戶的語言。
{visitorDevice} 發起交談客戶的裝置。
{entityRoutingLogicalName} 實體的名稱 (如果是實體記錄的通知)。
{entityRoutingRecordId} 記錄的唯一識別碼 (如果是實體記錄的通知)。
{customerRecordId} 實體 (連絡人或客戶) 的唯一識別碼 (如果客戶已驗證)。
{<name of the pre-chat survey questions>} 針對工作資料流設定的所有聊天前問卷問題，都將有動態資料欄位名稱做為問題名稱。

範本的動態資料欄位格式

從管道提供者、目前使用者工作階段或 Dataverse 擷取範本內容的 {Slug} 參數格式。 例如：{caseId}

OData 查詢

您可以使用 OData 查詢來取得 Dataverse 提供的內容。

OData 查詢格式為：

{$odata.<entityName>.<entityAttributeName>.<?options>}

範例：

  • {$odata.account.name.?$filter=accountid eq '{customerRecordId}'}
  • {$odata.incident.prioritycode.?$filter=incidentid eq '{caseId}'&$select=prioritycode}
  • {$odata.incident.title.?$filter=incidentid eq '{caseId}'&$select=title}

靜態值

這些是您根據業務需求所更新的硬式編碼值。 對於每個您選擇的硬式編碼屬性，請遵循特定屬性的格式類型。

範例 (巨集)：

您希望一律都將 Contoso- 附加於案例標題。 您對下列欄位使用開啟新的表單以建立記錄動作。

參數 值
實體邏輯名稱 事件
屬性名稱 案例標題
屬性值 Contoso - {caseTitle}

這裡的 Contoso - 即是硬式編碼靜態值。

範例 (範本)：

對於接收聊天要求，您想要提供專員在執行階段看到的工作階段與通知範本的靜態標題。

通知標題 = New chat request

工作階段標題 = Chat conversation

請參閱

管理工作階段範本
管理應用程式索引標籤範本
管理通知範本
將範本與工作資料流建立關聯