信用卡申辦預建元件可讓新客戶和現有客戶申請新信用卡。
這個元件會先收集使用者的電話號碼,判斷對方是新客戶還是現有客戶。如果是新使用者,元件會收集必要詳細資料,包括月收入、支出類別或想要的信用卡福利。收集完所有必要資訊後,元件會安排回呼,並向使用者提供要求編號。
如果是現有客戶,元件會擷取已註冊的使用者資訊,並根據使用者的偏好設定和擷取的資訊 (包括信用評分),向使用者顯示可用的信用卡選項。客戶選取信用卡選項後,元件會傳送連結,讓客戶使用已註冊的管道 (包括 WhatsApp 或簡訊) 完成註冊程序。
這個元件會使用電話號碼收集和郵遞區號收集元件,收集並驗證使用者詳細資料。
限制
除了常見的預建元件限制外,這項預建元件還有下列限制:
- 這個元件不會加密任何資料。
對話範例
對話範例顯示這項預建元件處理的常見情境。當使用者透過電話呼叫元件時,系統會觸發預設歡迎意圖,並在對話開始時顯示第一個代理回覆。
新使用者
- 這個元件會檢查使用者是否使用已註冊的電話號碼撥打電話,藉此判斷對方是否為新使用者。
- 這個元件會收集使用者想申請的信用卡類別,以及用於識別使用者的資訊,包括郵遞區號和電話號碼。
- 元件會安排回電,並提供要求編號。
| 使用者輸入內容 | 代理回覆 |
|---|---|
| 請問您是本銀行的現有客戶嗎? | |
| 我不是 | |
| 很高興您想向我們申辦信用卡。我們有許多適合你的信用卡。 為了提供最合適的信用卡,可以請你提供月收入 (以美元為單位) 嗎? |
|
| 5,000 美元 | |
| 您對哪些費用或福利感興趣?我們提供多種選項,例如旅遊、燃料和購物。 | |
| 我喜歡購物 | |
| 你選取的回覆屬於購物類別。如要繼續,請說「是」。 | |
| 是 | |
| 代理使用預先建構的郵遞區號收集元件,收集使用者的郵遞區號。 | |
| 你剛才說郵遞區號是 10011,對嗎? | |
| 沒錯 | |
| 很好,我們已完成收集郵遞區號。 | |
| 代理使用電話號碼收集預建元件收集使用者的電話號碼。 | |
| 好的,你剛才說的號碼是 +16502530000,對嗎? | |
| 是 | |
| 太好了,我們已收集完電話號碼。 我們的代表會根據你的條件,回電給你提供相關卡片。您的要求編號為 993835。 |
現有客戶
- 該元件會使用電話號碼識別已註冊的客戶,然後要求提供使用者要註冊的卡片類別和類型等資訊。
- 使用者確認這項資訊後,元件會提示使用者選取管道來完成註冊程序,並將連結傳送至註冊的管道。
| 使用者輸入內容 | 代理回覆 |
|---|---|
| 很高興您持續選用我們的產品和服務。我們有許多適合你的信用卡。 你對哪些費用或福利感興趣?我們提供多種選項,例如旅遊、燃料和購物。 |
|
| 我想要一張下次度假時可以使用的卡片 | |
| 您選取的回覆屬於旅遊類別。如要繼續,請說「是」。 | |
| 是 | |
| 我們提供 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"。 |
字串 |
如要設定這項元件的輸入參數,請展開查看操作說明。
- 開啟 Dialogflow CX 控制台。
- 選擇 Google Cloud 雲端專案。
- 選取代理。
- 選取「Build」(建構) 分頁標籤。
- 在「Flows」(流程) 部分,點選匯入的元件。
- 按一下「Pages」部分中的「Start Page」。
- 在「Start Page」中,點選「true」路徑。
- 在「Route」視窗中,視需要編輯「Parameter Presets」值。
- 按一下「儲存」。
輸出參數
輸出參數是工作階段參數,在退出元件後仍會保持有效。這些參數包含元件收集的重要資訊。
這個預建元件會提供下列輸出參數的值:
| 參數名稱 | 說明 | 輸出格式 |
|---|---|---|
| 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 內建事件」。 |
字串 |
基本設定
如要設定這項預建元件,請按照下列步驟操作:
- 匯入預先建構的元件 (請參閱「匯入預先建構的元件」)。
- 設定提供的彈性 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,請展開查看操作說明。
- 開啟 Dialogflow CX 控制台。
- 選擇 Google Cloud 雲端專案。
- 選取代理。
- 選取「管理」分頁標籤。
- 按一下「Webhooks」。
- 選取 prebuilt_components_credit_card_enrollment:get_account_details Webhook。
- 將 Dialogflow CX「Webhook URL」欄位中的 Webhook 網址,替換成要整合的服務端點。在下拉式選單中選取適當的「Method」。
- 查看並更新要求主體,為 Webhook 建立適當的要求格式。
- 查看並更新回應設定,從 Webhook 的回應中擷取特定欄位。請勿修改參數名稱,因為元件需要這些名稱才能存取傳回的欄位值。
- 視需要查看及更新「驗證」設定。
- 按一下「儲存」。
取得卡片數量
元件會使用 prebuilt_components_credit_card_enrollment:get_card_count Webhook,擷取與已註冊使用者帳戶相關聯的信用卡數量。
API 要求參數
元件會提供下列參數,做為 API 要求的輸入內容:
| 參數名稱 | 說明 | 輸入格式 |
|---|---|---|
| $session.params.phone_number | 使用者的當地電話號碼 (不含國家/地區代碼),用於識別使用者。 | 字串 |
API 回應參數
元件會從 API 回應擷取下列參數:
| 參數名稱 | 說明 | 輸出格式 |
|---|---|---|
| card_count | 已註冊的使用者帳戶中的信用卡總數。 | 整數 |
如要為這個元件設定「取得信用卡數量」Webhook,請展開查看操作說明。
- 開啟 Dialogflow CX 控制台。
- 選擇 Google Cloud 雲端專案。
- 選取代理。
- 選取「管理」分頁標籤。
- 按一下「Webhooks」。
- 選取 prebuilt_components_credit_card_enrollment:get_card_count Webhook。
- 將 Dialogflow CX「Webhook URL」欄位中的 Webhook 網址,替換成要整合的服務端點。在下拉式選單中選取適當的「Method」。
- 查看並更新要求主體,為 Webhook 建立適當的要求格式。
- 查看並更新回應設定,從 Webhook 的回應中擷取特定欄位。請勿修改參數名稱,因為元件需要這些名稱才能存取傳回的欄位值。
- 視需要查看及更新「驗證」設定。
- 按一下「儲存」。
取得可用的信用卡
這個元件會使用 prebuilt_components_credit_card_enrollment:get_available_card Webhook,根據使用者的信用評分,擷取特定支出類別可用的信用卡清單。
API 要求參數
元件會提供下列參數,做為 API 要求的輸入內容:
API 回應參數
元件會從 API 回應擷取下列參數:
| 參數名稱 | 說明 | 輸出格式 |
|---|---|---|
| available_card_names | 使用者可用的信用卡清單,例如 ["gold shopping card","classic shopping card"]。 |
清單 (字串) |
| cards_count | 使用者可用的信用卡數量。 | 整數 |
如要為這個元件設定「取得可用卡片」Webhook,請展開查看操作說明。
- 開啟 Dialogflow CX 控制台。
- 選擇 Google Cloud 雲端專案。
- 選取代理。
- 選取「管理」分頁標籤。
- 按一下「Webhooks」。
- 選取 prebuilt_components_credit_card_enrollment:get_available_card Webhook。
- 將 Dialogflow CX「Webhook URL」欄位中的 Webhook 網址,替換成要整合的服務端點。在下拉式選單中選取適當的「Method」。
- 查看並更新要求主體,為 Webhook 建立適當的要求格式。
- 查看並更新回應設定,從 Webhook 的回應中擷取特定欄位。請勿修改參數名稱,因為元件需要這些名稱才能存取傳回的欄位值。
- 視需要查看及更新「驗證」設定。
- 按一下「儲存」。
取得所選信用卡詳細資料
該元件會使用 prebuilt_components_credit_card_enrollment:get_selected_card Webhook 擷取所選信用卡的年費和福利。
API 要求參數
元件會提供下列參數,做為 API 要求的輸入內容:
API 回應參數
元件會從 API 回應擷取下列參數:
| 參數名稱 | 說明 | 輸出格式 |
|---|---|---|
| selected_card_benefits | 所選信用卡的福利資訊。 | 字串 |
| selected_card_annual_fee | 所選信用卡的年費。 | 整數 |
| selected_card_name | 所選信用卡的名稱。 | 字串 |
如要為這個元件設定「取得所選信用卡詳細資料」Webhook,請展開查看操作說明。
- 開啟 Dialogflow CX 控制台。
- 選擇 Google Cloud 雲端專案。
- 選取代理。
- 選取「管理」分頁標籤。
- 按一下「Webhooks」。
- 選取 prebuilt_components_credit_card_enrollment:get_selected_card Webhook。
- 將 Dialogflow CX「Webhook URL」欄位中的 Webhook 網址,替換成要整合的服務端點。在下拉式選單中選取適當的「Method」。
- 查看並更新要求主體,為 Webhook 建立適當的要求格式。
- 查看並更新回應設定,從 Webhook 的回應中擷取特定欄位。請勿修改參數名稱,因為元件需要這些名稱才能存取傳回的欄位值。
- 視需要查看及更新「驗證」設定。
- 按一下「儲存」。
提交註冊要求
該元件會使用 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,請展開查看操作說明。
- 開啟 Dialogflow CX 控制台。
- 選擇 Google Cloud 雲端專案。
- 選取代理。
- 選取「管理」分頁標籤。
- 按一下「Webhooks」。
- 選取 prebuilt_components_credit_card_enrollment:submit_enroll webhook。
- 將 Dialogflow CX「Webhook URL」欄位中的 Webhook 網址,替換成要整合的服務端點。在下拉式選單中選取適當的「Method」。
- 查看並更新要求主體,為 Webhook 建立適當的要求格式。
- 查看並更新回應設定,從 Webhook 的回應中擷取特定欄位。請勿修改參數名稱,因為元件需要這些名稱才能存取傳回的欄位值。
- 視需要查看及更新「驗證」設定。
- 按一下「儲存」。
傳送訊息
該元件會使用 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,請展開查看操作說明。
- 開啟 Dialogflow CX 控制台。
- 選擇 Google Cloud 雲端專案。
- 選取代理。
- 選取「管理」分頁標籤。
- 按一下「Webhooks」。
- 選取 prebuilt_components_credit_card_enrollment:send_message webhook。
- 將 Dialogflow CX「Webhook URL」欄位中的 Webhook 網址,替換成要整合的服務端點。在下拉式選單中選取適當的「Method」。
- 查看並更新要求主體,為 Webhook 建立適當的要求格式。
- 查看並更新回應設定,從 Webhook 的回應中擷取特定欄位。請勿修改參數名稱,因為元件需要這些名稱才能存取傳回的欄位值。
- 視需要查看及更新「驗證」設定。
- 按一下「儲存」。
完成
信用卡註冊預建元件和 Webhook 現已設定完畢,可以開始測試。