帳戶餘額預先建構元件

帳戶餘額預建元件會檢查顧客的驗證層級,並向通過驗證的顧客提供帳戶餘額資訊。如果顧客有多個帳戶,元件會確認顧客要查詢哪個帳戶的餘額。

這個元件會使用驗證預建元件來驗證使用者。

限制

除了常見的預建元件限制外,這項預建元件還有下列限制:

  • 這個元件不會加密任何資料。

對話範例

對話範例顯示這項預建元件處理的常見情境。當使用者透過電話呼叫元件時,系統會觸發預設歡迎意圖,並在對話開始時顯示第一個代理回覆。

單一帳戶

使用者只有一個帳戶,且已取得帳戶餘額。

使用者輸入內容 代理回覆
代理使用驗證預建元件驗證使用者。
謝謝,您已成功通過驗證。
正在擷取帳戶詳細資料,請稍候。

與結尾為 4567 的帳戶相關聯的餘額為 $50.00 美元。

多個帳戶

如果使用者有多個帳戶,服務專員會要求並確認帳號末四碼,並提供該帳戶的帳戶餘額。

使用者輸入內容 代理回覆
代理使用驗證預建元件驗證使用者。
謝謝,您已成功通過驗證。
我們正在擷取你的帳戶詳細資料,請稍候。

我們發現有 2 個帳戶與你的號碼相關聯。

請提供你所指帳戶的末 4 碼。
2002
我們取得的帳號末四碼是 2002,請問是否正確?
是
帳號末碼為 2002 的帳戶餘額為 $5,000 美元。

多個帳戶 (含背景資訊)

如果使用者有多個帳戶,系統會保留先前意圖中參照的帳號,並提供帳戶餘額。

使用者輸入內容 代理回覆
正在擷取你的帳戶詳細資料,請稍候。

我們發現有 3 個帳戶與你的號碼相關聯。

你要找的是結尾為 4567 的帳號嗎?
是
帳號末 4 碼為 4567 的帳戶餘額為 $50 美元。

命名慣例

這個預建元件採用下列命名慣例:

功能 格式 範例
Flow 元件名稱 帳戶餘額
元件專屬意圖 prebuilt_components_[component_name]_[intent_name] prebuilt_components_account_number_collection_four_digit_account_number
Webhook prebuilt_components_[component_name]:[webhook_action] prebuilt_components_account_balance:get_account_balance

輸入參數

輸入參數會設定元件的特定行為。流程中的一或多個條件會使用這些參數,決定元件的行為。您必須在元件的起始頁面上設定流程範圍參數。您可以使用呼叫流程,或在這個元件的開始頁面設定以工作階段為範圍的參數。

這個預建元件接受下列輸入參數:

參數名稱 說明 輸入格式
$session.params.auth_level (選用) 表示來電者的驗證層級。 整數
$session.params.auth_level_req 指出使用者存取帳戶餘額前,需要完成的驗證層級。這個值是在 check auth level 頁面的頁面項目執行參數預設中設定。根據預設,這個值為 1。 整數
$session.params.account_auth_enabled 指出是否應按照「驗證類型」一節所述,將使用者驗證為帳戶持有人。這個值是在 check auth level 頁面的頁面項目執行參數預設中設定。根據預設,這個值為 true。 布林值
$session.params.card_auth_enabled 指出是否應按照「驗證類型」一節所述,驗證使用者是否為持卡人。這個值是在 check auth level 頁面的頁面項目執行參數預設中設定。根據預設,這個值為 false。 布林值
$session.params.phone_number (選用) 用於驗證的顧客註冊電話號碼。 字串
$session.params.account_count (選用) 與已驗證使用者相關聯的帳戶數量。 整數
$session.params.last_four_digit_of_account_number (選用) 需提供餘額的客戶帳號末四碼。如果客戶只有一個帳戶,系統會在驗證後自動擷取這項資訊。如果客戶有多個帳戶,則會向客戶收集特定帳號。 字串
$flow.max_retry_acc_number 指定收集使用者帳號末四碼時,允許的重試次數。預設值為 3。 整數

如要設定這項元件的輸入參數,請展開查看操作說明。

  1. 開啟 Dialogflow CX 控制台。
  2. 選擇 Google Cloud 雲端專案。
  3. 選取代理。
  4. 選取「Build」(建構) 分頁標籤。
  5. 在「Flows」(流程) 部分,點選匯入的元件。
  6. 按一下「Pages」部分中的「Start Page」。
  7. 在「Start Page」中,點選「true」路徑。
  8. 在「Route」視窗中,視需要編輯「Parameter Presets」值。
  9. 按一下「儲存」。

輸出參數

輸出參數是工作階段參數,在退出元件後仍會保持有效。這些參數包含元件收集的重要資訊。

這個預建元件會提供下列輸出參數的值:

參數名稱 說明 輸出格式
auth_level 指出來電者的驗證層級。 整數
phone_number 來電者的當地電話號碼 (不含國家/地區代碼),用於識別使用者。 字串
account_count 與已註冊電話號碼相關聯的帳戶數量。這類帳戶包括個人帳戶,以及使用者擁有委託書的帳戶。 整數
last_four_digit_of_account_number 如果使用者只有一個帳戶,系統會傳回帳號末四碼。如果使用者有多個帳戶,這個參數的值會是使用者選取要接收帳戶餘額資訊的帳號末四碼。 字串
transfer_reason 指出流程未成功結束的原因。傳回的值為下列其中一項:

agent:使用者在對話期間要求與真人服務專員交談。

denial_of_information:使用者拒絕提供元件要求的資訊。

max_no_input:對話達到無輸入事件的重試次數上限。請參閱「無輸入內建事件」。

max_no_match:對話達到不相符事件的重試次數上限。請參閱不相符內建事件。

webhook_error:發生 Webhook 錯誤。請參閱「webhook.error 內建事件」。

webhook_not_found:無法連上 Webhook 網址。請參閱「webhook.error.not-found 內建事件」。
字串

基本設定

如要設定預先建構的元件,請完成下列步驟:

  1. 匯入預先建構的元件。
  2. 使用描述外部服務的設定,設定提供的彈性 Webhook。詳情請參閱「Webhook 設定」一節。

Webhook 設定

如要使用這個元件,您必須設定內含的彈性 Webhook,從外部服務擷取必要資訊,並執行元件要求的動作。

驗證

如果您先前未設定驗證所需的外部服務,請設定這些服務,為這個元件啟用使用者驗證功能。如要進一步瞭解 Webhook 設定,請參閱「驗證 Webhook 設定」。

驗證帳戶

元件會使用 prebuilt_components_account_services:validate_account Webhook,根據使用者註冊的電話號碼和提供的帳號末四碼,驗證帳戶是否存在。如果帳戶存在,Webhook 也會傳回帳戶餘額。

API 要求參數

元件會提供下列參數,做為 API 要求的輸入內容:

參數名稱 說明 輸入格式
$session.params.phone_number 來電者的當地電話號碼 (不含國家/地區代碼),用於識別使用者。 字串
$session.params.last_four_digit_of_account_number 使用者選取並確認要接收帳戶餘額資訊的帳號末四碼。 字串

API 回應參數

元件會從 API 回應中提取下列參數:

參數名稱 說明 輸出格式
account_found 指出使用者的註冊帳戶是否存在後四碼相符的帳戶。 布林值
餘額 帳戶目前的餘額 (如有)。 數字

如要為這個元件設定「驗證帳戶」Webhook,請展開查看操作說明。

  1. 開啟 Dialogflow CX 控制台。
  2. 選擇 Google Cloud 雲端專案。
  3. 選取代理。
  4. 選取「管理」分頁標籤。
  5. 按一下「Webhooks」。
  6. 選取 prebuilt_components_account_services:validate_account Webhook。
  7. 將 Dialogflow CX「Webhook URL」欄位中的 Webhook 網址,替換成要整合的服務端點。在下拉式選單中選取適當的「Method」。
  8. 查看並更新要求主體,為 Webhook 建立適當的要求格式。
  9. 查看並更新回應設定,從 Webhook 的回應中擷取特定欄位。請勿修改參數名稱,因為元件需要這些名稱才能存取傳回的欄位值。
  10. 視需要查看及更新「驗證」設定。
  11. 按一下「儲存」。

完成

預建元件和 Webhook 已設定完成,可以開始測試。