信用卡註冊預先建構元件

信用卡申辦預建元件可讓新客戶和現有客戶申請新信用卡。

這個元件會先收集使用者的電話號碼,判斷對方是新客戶還是現有客戶。如果是新使用者,元件會收集必要詳細資料,包括月收入、支出類別或想要的信用卡福利。收集完所有必要資訊後,元件會安排回呼,並向使用者提供要求編號。

如果是現有客戶,元件會擷取已註冊的使用者資訊,並根據使用者的偏好設定和擷取的資訊 (包括信用評分),向使用者顯示可用的信用卡選項。客戶選取信用卡選項後,元件會傳送連結,讓客戶使用已註冊的管道 (包括 WhatsApp 或簡訊) 完成註冊程序。

這個元件會使用電話號碼收集和郵遞區號收集元件,收集並驗證使用者詳細資料。

限制

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

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

對話範例

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

新使用者

  1. 這個元件會檢查使用者是否使用已註冊的電話號碼撥打電話,藉此判斷對方是否為新使用者。
  2. 這個元件會收集使用者想申請的信用卡類別,以及用於識別使用者的資訊,包括郵遞區號和電話號碼。
  3. 元件會安排回電,並提供要求編號。
使用者輸入內容 代理回覆
請問您是本銀行的現有客戶嗎?
我不是
很高興您想向我們申辦信用卡。我們有許多適合你的信用卡。

為了提供最合適的信用卡,可以請你提供月收入 (以美元為單位) 嗎?
5,000 美元
您對哪些費用或福利感興趣?我們提供多種選項,例如旅遊、燃料和購物。
我喜歡購物
你選取的回覆屬於購物類別。如要繼續,請說「是」。
是
代理使用預先建構的郵遞區號收集元件,收集使用者的郵遞區號。
你剛才說郵遞區號是 10011,對嗎?
沒錯
很好,我們已完成收集郵遞區號。
代理使用電話號碼收集預建元件收集使用者的電話號碼。
好的,你剛才說的號碼是 +16502530000,對嗎?
是
太好了,我們已收集完電話號碼。

我們的代表會根據你的條件,回電給你提供相關卡片。您的要求編號為 993835。

現有客戶

  1. 該元件會使用電話號碼識別已註冊的客戶,然後要求提供使用者要註冊的卡片類別和類型等資訊。
  2. 使用者確認這項資訊後,元件會提示使用者選取管道來完成註冊程序,並將連結傳送至註冊的管道。
使用者輸入內容 代理回覆
很高興您持續選用我們的產品和服務。我們有許多適合你的信用卡。

你對哪些費用或福利感興趣?我們提供多種選項,例如旅遊、燃料和購物。
我想要一張下次度假時可以使用的卡片
您選取的回覆屬於旅遊類別。如要繼續,請說「是」。
是
我們提供 3 種卡片,可滿足你的需求:白金旅遊卡、黃金旅遊卡、經典旅遊卡。你想瞭解所有卡片還是特定卡片的資訊?舉例來說,如果你想找經典卡,請說「經典卡」。
可以說明一下白金卡嗎?
好的,白金旅遊卡年費為 95 美元。福利包括:每年可獲得 10,000 點獎勵里程、所有其他消費可賺取無限 2 倍里程,里程輕鬆賺、輕鬆用。如要進一步瞭解福利或獎勵,請前往我們的網站。

請確認是否要申辦白金旅遊卡。
好,開始吧
我們會提供連結,說明註冊程序步驟。是否要透過簡訊或 WhatsApp 將這些卡片詳細資料傳送至你的手機號碼?
請傳送簡訊
好的,我們正在將連結傳送至你註冊的手機號碼。這項操作可能需要幾秒鐘才能完成。請確認是否收到連結,回答「是」或「否」即可。
我知道了
太好了,現在你可以開啟連結,查看卡片註冊詳細資料。資料填寫完畢後,系統就會開始核發新卡,並寄到你目前的地址。

否認資訊

如果使用者拒絕提供申請信用卡所需的資訊,元件會退出並顯示失敗訊息。

使用者輸入內容 代理回覆
請問您是本銀行的現有客戶嗎?
不,我不是
很高興您想向我們申辦信用卡。我們有許多適合你的信用卡。

為了提供最合適的信用卡,可以請你提供月收入 (以美元為單位) 嗎?
我不想提供這項資訊
感謝你的來電。很抱歉,如果沒有收到上述資訊,我們目前無法進一步處理。

命名慣例

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

功能 格式 範例
Flow [Component Name] 信用卡登錄
元件專屬意圖 prebuilt_components_[component_name]_[intent_name] prebuilt_components_cc_enroll_collect_cardtype
實體類型 prebuilt_components_[component_name]_[entity_type] prebuilt_components_cc_enroll_expense_category
Webhook prebuilt_components_[component_name]:[webhook_action] prebuilt_components_credit_card_enrollment:get_available_card

輸入參數

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

這個預建元件會採用下列輸入參數:

參數名稱 說明 輸入格式
$session.params.auth_level (選用) 表示使用者目前的驗證層級。 整數
$session.params.phone_number (選用) 使用者的電話號碼。如未提供這項參數,元件會向使用者收集電話號碼。 字串
$flow.max_retry_count 指定使用者可重試的次數。預設值為 3。 整數
$flow.currency_name 指定收集月收入詳細資料時預期的貨幣。預設值為 "USD"。 字串

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

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

輸出參數

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

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

參數名稱 說明 輸出格式
phone_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,從外部服務擷取必要資訊。

取得帳戶詳細資料

如果帳戶存在,元件會使用 prebuilt_components_credit_card_enrollment:get_account_details Webhook 擷取使用者的帳戶詳細資料。

API 要求參數

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

參數名稱 說明 輸入格式
$session.params.phone_number 使用者的當地電話號碼 (不含國家/地區代碼),用於識別使用者。 字串

API 回應參數

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

參數名稱 說明 輸出格式
account_count 與註冊電話號碼相關聯的帳戶數量。 整數
credit_score 使用者登記的信用評分。 整數

如要為這個元件設定「取得帳戶詳細資料」Webhook,請展開查看操作說明。

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

取得卡片數量

元件會使用 prebuilt_components_credit_card_enrollment:get_card_count Webhook,擷取與已註冊使用者帳戶相關聯的信用卡數量。

API 要求參數

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

參數名稱 說明 輸入格式
$session.params.phone_number 使用者的當地電話號碼 (不含國家/地區代碼),用於識別使用者。 字串

API 回應參數

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

參數名稱 說明 輸出格式
card_count 已註冊的使用者帳戶中的信用卡總數。 整數

如要為這個元件設定「取得信用卡數量」Webhook,請展開查看操作說明。

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

取得可用的信用卡

這個元件會使用 prebuilt_components_credit_card_enrollment:get_available_card Webhook,根據使用者的信用評分,擷取特定支出類別可用的信用卡清單。

API 要求參數

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

參數名稱 說明 輸入格式
$flow.expense_category 使用者選擇註冊的費用類別。有效值由 prebuilt_components_cc_enroll_expense_category 自訂實體定義。根據預設,系統支援 fuel、shopping 和 travel。 字串
$flow.credit_score 使用者的信用評分,由元件使用「取得帳戶詳細資料」Webhook 擷取。 整數

API 回應參數

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

參數名稱 說明 輸出格式
available_card_names 使用者可用的信用卡清單,例如 ["gold shopping card","classic shopping card"]。 清單 (字串)
cards_count 使用者可用的信用卡數量。 整數

如要為這個元件設定「取得可用卡片」Webhook,請展開查看操作說明。

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

取得所選信用卡詳細資料

該元件會使用 prebuilt_components_credit_card_enrollment:get_selected_card Webhook 擷取所選信用卡的年費和福利。

API 要求參數

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

參數名稱 說明 輸入格式
$flow.card_type 使用者選擇註冊的信用卡類型。有效值由 prebuilt_components_cc_enroll_card_type 自訂實體定義。根據預設,系統支援 classic、gold 和 platinum。 字串
$flow.expense_category 使用者選擇註冊的費用類別。有效值由 prebuilt_components_cc_enroll_expense_category 自訂實體定義。根據預設,系統支援 fuel、shopping 和 travel。 字串
$flow.credit_score 使用者的信用評分,由元件使用「取得帳戶詳細資料」Webhook 擷取。 整數

API 回應參數

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

參數名稱 說明 輸出格式
selected_card_benefits 所選信用卡的福利資訊。 字串
selected_card_annual_fee 所選信用卡的年費。 整數
selected_card_name 所選信用卡的名稱。 字串

如要為這個元件設定「取得所選信用卡詳細資料」Webhook,請展開查看操作說明。

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

提交註冊要求

該元件會使用 prebuilt_components_credit_card_enrollment:submit_enroll Webhook,根據新使用者提供的偏好設定和使用者詳細資料,建立信用卡註冊要求。

API 要求參數

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

參數名稱 說明 輸入格式
$session.params.phone_number 使用者的當地電話號碼 (不含國家/地區代碼),用於識別使用者。 字串
$flow.zipcode 使用者提供的郵遞區號。 字串
$flow.monthly_salary 使用者提供的月薪。 整數
$flow.currency_name 月薪幣別,在元件的輸入參數中設定。請參閱輸入參數。 字串

API 回應參數

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

參數名稱 說明 輸出格式
request_number 信用卡註冊要求成功註冊的要求編號。 整數

如要為這個元件設定「提交註冊要求」Webhook,請展開查看操作說明。

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

傳送訊息

該元件會使用 prebuilt_components_credit_card_enrollment:send_message Webhook 傳送訊息,其中包含現有客戶完成信用卡註冊的連結。

API 要求參數

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

參數名稱 說明 輸入格式
$session.params.phone_number 使用者的當地電話號碼 (不含國家/地區代碼),用於識別使用者。 字串
$flow.channel 使用者選擇接收訊息的管道。有效值由 prebuilt_components_cc_enroll_channel 自訂實體定義。根據預設,系統支援 SMS 和 WhatsApp。 字串
$flow.selected_card_name 使用者選取的信用卡清單,例如 ["gold shopping card","classic shopping card"]。 清單 (字串)

API 回應參數

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

參數名稱 說明 輸出格式
message_sent 指出訊息是否成功傳送至使用者指定的管道。 布林值

如要為這個元件設定「傳送訊息」Webhook,請展開查看操作說明。

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

完成

信用卡註冊預建元件和 Webhook 現已設定完畢,可以開始測試。