描述支援的頻道流程類型組態提示屬性取得設定檔建立設定檔更新設定檔取得設定檔物件取得計算的屬性將聯絡人與設定檔建立關聯如何在整個流程中保留欄位已設定的區塊

Amazon Connect 中的流程區塊：客戶設定檔

本主題定義擷取、建立和更新客戶設定檔的流程區塊。

描述

可讓您擷取、建立和更新客戶設定檔。
- 您可以將區塊配置為使用最多五個您選擇的搜尋識別碼擷取設定檔。
可讓您擷取「客戶設定檔」的物件和已計算的屬性。
- 您可以將區塊配置為使用您選擇的搜尋識別碼擷取物件。
- 您必須在此區塊中提供設定檔 ID。您可以手動提供 profileID，或在使用取得設定檔找到設定檔後，使用儲存在客戶命名空間中的 profileID。
可讓您將聯絡人 (例如語音、聊天和工作) 與現有客戶個人檔案建立關聯。
擷取客戶設定檔資料時，(回應欄位會儲存於該客戶的聯絡屬性中，讓您在後續區塊使用。
您也可以使用下列來參考回應欄位JSONPath：$.Customer.例如 $.Customer.City和 $.Customer.Asset.Status。
下列範例示範如何使用此提示。
- 擷取設定檔後使用播放提示區塊，透過引用支援的設定檔欄位來提供個性化的通話或聊天體驗。
- 擷取設定檔後使用檢查聯絡屬性區塊，根據值來轉接聯絡人。
- 如需詳細資訊，請參閱如何在整個流程中保留欄位。

支援的頻道

下表列出此區塊如何轉接使用指定頻道的聯絡人。

頻道	支援？
語音	是
聊天	是
任務	是

流程類型

您可以在下列流程類型中使用此區塊：

所有流程類型

組態提示

在使用此區塊之前，請確定您的 Amazon Connect 執行個體已啟用客戶設定檔。如需說明，請參閱使用 Amazon Connect 客戶設定檔。
在下列情況下，聯絡案例會沿著錯誤分支轉接：
- 您的 Amazon Connect 執行個體未啟用客戶設定檔。
- 請求資料值無效。請求值不能超過 255 個字元。
- 客戶設定檔API請求已限流。
- Customer Profiles 有可用性問題。
整個流程的客戶設定檔聯絡人屬性總大小限制為 14,000 個字元 (56 個屬性，假設每個屬性的大小上限為 255 個)。這包括在流程中保留為「客戶設定檔」區塊中回應欄位的所有值。

屬性

「客戶設定檔」流程區塊提供下列屬性類型：

取得設定檔
建立設定檔
更新設定檔
取得設定檔物件
取得計算的屬性
將聯絡人與設定檔建立關聯

屬性：獲取設定檔

配置屬性以取得設定檔時，請考慮下列事項：

您必須提供至少一個搜尋識別碼，最多共五個。
如果提供多個搜尋識別符，您必須提供一個邏輯運算子，或 AND或。邏輯運算子將套用於所有搜尋標識碼，如下所示的其中一個運算式
- 即 AND （b AND c）
- 即 (x OR y OR z)
定義屬性以保留在後續區塊中，並將其儲存在回應欄位下的聯絡人屬性中。
聯絡人可以透過以下分支轉接
- 成功：找到一個設定檔。回應欄位儲存在聯絡人屬性中
- 錯誤：嘗試尋找設定檔時發生錯誤。這可能是因為系統錯誤或取得設定檔的設定方式所致。
- 找到多個：找到多個設定檔。
- 找不到：找不到設定檔。

下圖顯示針對取得設定檔動作設定客戶設定檔屬性頁面範例。

顯示的區塊會設定為搜尋符合來電者電話號碼或共用儲存在名為「帳戶」的使用者定義屬性中相同帳戶號碼的設定檔。找到一個設定檔時，回應欄位 - AccountNumber、FirstName、PhoneNumber、 LastName和 屬性。LoyaltyPoints - 會存放在該特定客戶的聯絡屬性中。

屬性：建立設定檔

設定建立設定檔的屬性時，請考慮下列事項：

在請求欄位中指定您要在建立設定檔期間填入的屬性
定義屬性以保留在後續區塊中，並將其儲存在回應欄位下的聯絡人屬性中。

聯絡人可以透過以下分支轉接：

成功：已成功建立設定檔，「回應」欄位會儲存在聯絡人屬性中。
錯誤：設定檔建立流程期間發生錯誤，可能是因為系統錯誤或建立設定檔動作的配置錯誤。

下方顯示的區塊設定為使用名為「語言」的 PhoneNumber和自訂屬性建立設定檔。在建立設定檔之後，Attributes.Language 回應欄位會儲存在聯絡人屬性中，以便在後續區塊中使用。

屬性：更新設定檔

將屬性設定為更新設定檔時，請考慮下列事項：

使用更新設定檔區塊之前，請使用取得設定檔區塊，如下圖所示。使用取得設定檔區塊來尋找您要更新的特定設定檔。
使用請求欄位和請求欄位值，提供您要更新設定檔的屬性與值。
定義屬性以保留在後續區塊中，並將其儲存在回應欄位下的聯絡人屬性中。

聯絡人可以透過以下分支轉接：

成功：設定檔已成功更新，回應欄位會儲存在聯絡人屬性中。
錯誤：嘗試更新設定檔時發生錯誤。這可能是因為系統錯誤或更新設定檔動作配置錯誤所導致。

下方顯示的區塊設定為使用 MailingAddress1 更新設定檔，並將使用者輸入作為值。更新設定檔時，MailingAddress1 個回應欄位會儲存在聯絡屬性中，使其可用於後續區塊。

屬性：取得設定檔物件

配置屬性為取得設定檔物件時，請考慮以下內容：

強制性設定檔 ID： 此區塊需要設定檔 ID 才能運作。取得設定檔物件動作會擷取與提供的 ProfileID 相關的物件。確保您使用前面的取得設定檔區塊來提供設定檔 ID，如下所示。在向前移動之前，使用取得設定檔區塊來精確定位特定設定檔，以在後續區塊中擷取設定檔的物件。
- 您可以選擇手動輸入設定檔 ID，或使用儲存在預先定義或使用者屬性中的預先定義值。
您必須指出要從中擷取資訊的物件類型。
您必須選擇下列其中一個物件擷取選項：
- 使用最新的設定檔物件：此選項會持續擷取最新的物件。
- 使用搜尋識別碼：此選項涉及使用提供的搜尋識別碼來搜尋及擷取物件。
定義屬性以保留在後續區塊中，並將其儲存在回應欄位下的聯絡人屬性中。

聯絡人可以透過以下分支轉接：

成功：設定檔物件已成功找到，回應欄位會儲存在聯絡人屬性中。
錯誤：嘗試擷取設定檔物件時發生錯誤。這可能是由於系統錯誤或取得設定檔錯誤所致。
找不到：找不到物件。

下方顯示的區塊設定為擷取儲存在「客戶」命名空間下與 ProfileId 相關聯的「資產」類型的設定檔物件。在此特定案例中，區塊會使用資產 ID 搜尋資產。找到資產後，Asset.Price 和 Asset.PurchaseDate 會儲存在聯絡屬性中，讓它們可用於後續區塊。

屬性：取得計算的屬性

重要

若要使用此動作，您的 Amazon Connect 執行個體必須具有下列的許可APIs： ListCalculatedAttributeDefinitions以及下列任一政策GetCalculatedAttributeForProfile中的： AmazonConnectServiceLinkedRolePolicy或 AmazonConnectServiceCustomerProfileAccess。

配置屬性以取得計算的屬性時，請考慮下列事項：

強制性設定檔 ID： 此區塊需要設定檔 ID 才能運作。取得計算的屬性動作會擷取與提供的 ProfilelD 相關的物件。確保您使用前面的取得設定檔區塊來提供設定檔 ID，如下所示。在向前移動前，使用取得設定檔區塊精確定位特定設定檔，以擷取後續區塊中設定檔的計算屬性。
- 您可以選擇手動輸入設定檔 ID，或使用儲存在預先定義或使用者屬性中的預先定義值。
定義屬性以保留在後續區塊中，並將其儲存在回應欄位下的聯絡人屬性中。
- 回應欄位下的選項是針對「客戶設定檔」網域定義的已計算屬性定義
- 如果已計算屬性的定義使用臨界值，則已計算屬性值為布林值，並傳回 True/False。否則，他們將返回一個數字或字串值。計算屬性的傳回值可用於 檢查聯絡屬性 區塊中的分支目的，方法是使用等同、大於、小於和包含等條件。

聯絡人可以透過以下分支轉接：

成功：找到已計算的屬性，且「回應」欄位會儲存在聯絡人屬性中。
錯誤：嘗試擷取已計算屬性時發生錯誤。這可能是由於系統錯誤或取得已計算屬性動作的配置錯誤所致。
找不到：找不到計算的屬性。

下方顯示的區塊設定為取得屬於聯絡人屬性ProfileId中提供的計算屬性。以下回應欄位將被截取並儲存在聯絡人屬性中：平均呼叫持續時間和頻繁呼叫者。

Customer Profiles GetCalculatedAttributes 區塊的屬性頁面。

屬性：將聯絡人與設定檔建立關聯

重要

若要使用此動作，您還必須在安全性設定檔中啟用「客戶設定檔檢視」權限。

配置屬性為將聯絡人與設定檔建立關聯時，請考慮下列事項：

將聯絡人與設定檔建立關聯前，新增取得設定檔區塊，如下圖所示。使用取得設定檔區塊先找到設定檔，然後在下一個區塊中建立聯絡人和設定檔關聯。
強制性設定檔 ID： 此區塊需要設定檔 ID 才能運作。確保您使用前面的取得設定檔區塊來提供設定檔 ID，如下所示。使用取得設定檔區塊，在下一個區塊中精確找出您想要與聯絡人建立關聯的特定設定檔。
- 您可以選擇手動輸入設定檔 ID，或使用儲存在預先定義或使用者屬性中的預先定義值。
您必須提供聯絡 ID 的值。