這個預建元件會擷取 8 到 19 位數的信用卡號。系統會使用盧恩演算法驗證擷取的信用卡號碼。
限制
除了常見的預建元件限制外，這項預建元件還有下列限制：
- 元件不含 Payment Gateway 整合。
- 不支援長度少於 8 位數或超過 19 位數的信用卡卡號。
建議的代理設定
啟用 DTMF，允許使用者透過電話撥號鍵盤輸入數值。
其他功能
這項預建元件提供下列額外功能：
對話範例
下列對話範例說明這項預建元件處理的常見情境。範例對話會示範透過電話呼叫元件時的行為，這會觸發預設歡迎意圖，並在對話開始時觸發第一個代理回覆。
單一區塊
使用者在第一輪提供完整的卡號，服務專員成功驗證並接受。
| 使用者輸入內容 | 代理回覆 |
|---|---|
| 請說出或輸入信用卡號碼的前半部分。你隨時可以說「播放」，聽取目前收集到的數字。 | |
| 4242 4242 4242 4242 | |
| 我聽到的號碼是 4242424242424242，對嗎？ | |
| 是 | |
| 請說出或輸入信用卡號碼的下一部分，如果已完成，請說「就這樣」。 | |
| 就這樣 | |
| 最後向您確認，我取得的信用卡號碼是 4242424242424242，對嗎？ | |
| 是 | |
| 謝謝，您的信用卡號碼已成功驗證。 |
多個區塊
使用者分三次提供信用卡號，服務專員驗證並接受。
| 使用者輸入內容 | 代理回覆 |
|---|---|
| 請說出或輸入信用卡號碼的前半部分。你隨時可以說「播放」，聽取目前收集到的數字。 | |
| 4242 | |
| 我聽到的是 4242，對嗎？ | |
| 是 | |
| 請說出或輸入信用卡號碼的下一部分，如果已完成，請說「就這樣」。 | |
| 424242 | |
| 我聽到的號碼是 424242，對嗎？ | |
| 是 | |
| 請說出或輸入信用卡號碼的下一部分，如果已完成，請說「就這樣」。 | |
| 424242 | |
| 我聽到的號碼是 424242，對嗎？ | |
| 是 | |
| 請說出或輸入信用卡號碼的下一部分，如果已完成，請說「就這樣」。 | |
| 完成 | |
| 最後向您確認，我取得的信用卡號碼是 4242424242424242，對嗎？ | |
| 是 | |
| 謝謝，您的信用卡號碼已成功驗證。 |
重試成功
使用者在第一輪提供完整的信用卡號，服務專員再次確認，但使用者說「不」。代理要求使用者再次提供輸入內容。使用者提供並確認號碼，服務專員成功驗證並接受。
| 使用者輸入內容 | 代理回覆 |
|---|---|
| 請說出或輸入信用卡號碼的前半部分。你隨時可以說「播放」，聽取目前收集到的數字。 | |
| 5105105105105100 | |
| 我聽到的號碼是 5105105105105101，對嗎？ | |
| 否 | |
| 沒問題，請重複信用卡號，或試著一次說四個數字 | |
| 5105105105105100 | |
| 我取得的號碼是 5105105105105100，請問是否正確？ | |
| 是 | |
| 請說出或輸入信用卡號碼的下一部分，如果已完成，請說「就這樣」。 | |
| 就這樣 | |
| 最後向您確認，我取得的信用卡號碼是 5105105105105100，對嗎？ | |
| 是 | |
| 謝謝，您的信用卡號碼已成功驗證。 |
無法辨識的輸入內容
使用者提供無法辨識的輸入內容三次後，元件就會退出流程。
| 使用者輸入內容 | 代理回覆 |
|---|---|
| 請說出或輸入信用卡號碼的前半部分。你隨時可以說「播放」，聽取目前收集到的數字。 | |
| 沒關係 | |
| 抱歉，我聽不懂，可以請你再說一次或輸入信用卡號嗎？ | |
| 沒關係 | |
| 嗯，我還是聽不清楚。請確認你說的是信用卡號。你也可以使用撥號鍵盤輸入卡號。 | |
| 沒關係 | |
| 抱歉，我不懂你的意思。 |
信用卡卡號驗證
有效的信用卡卡號長度必須介於 8 到 19 位數之間。這個元件也會使用 IS_CREDIT_CARD_NUMBER 系統函式，透過 Luhn 演算法驗證信用卡號碼。
命名慣例
這個預建元件採用下列命名慣例：
| 功能 | 格式 | 範例 |
|---|---|---|
| Flow | [Component Name] | 收集信用卡卡號 |
| 元件專屬意圖 | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_credit_card_number_collection_credit_card_sequence |
| 參數 | [param_name] | user_provided_new_seq |
輸出參數
輸出參數是工作階段參數，在退出元件後仍會保持有效。這些參數包含元件收集的重要資訊。這個預建元件會提供下列輸出參數的值：
| 參數名稱 | 說明 | 輸出格式 |
|---|---|---|
| credit_card_status | 這個參數會使用盧恩演算法，指出收集到的信用卡號是否有效： 「valid」表示收集到的信用卡號已成功驗證，且長度介於 8 到 19 位數之間 「invalid」表示收集到的信用卡號無效，或長度不在 8 到 19 位數之間 |
字串 |
| credit_card_number_collection_credit_card_number | 這個參數會傳回元件擷取的卡號 | 字串 |
基本設定
如要設定這項預建元件，請按照下列步驟操作：
完成
代理應已設定完成，可以開始測試。