這個預建元件會擷取使用者提供的信用卡到期日。
限制
除了常見的預建元件限制外,這項預建元件還有下列限制:
- 這項元件不含 Payment Gateway 整合。
建議的代理設定
啟用 DTMF,允許使用者透過電話撥號鍵盤輸入數值。
其他功能
這項預建元件提供下列額外功能:
對話範例
下列對話範例說明這項預建元件處理的常見情境。範例對話會示範透過電話呼叫元件時的行為,這會觸發預設歡迎意圖,並在對話開始時觸發第一個代理回覆。
成功輸入
使用者在第一次嘗試時提供到期日,服務專員成功接受。
| 使用者輸入內容 | 代理回覆 |
|---|---|
| 請說出或輸入信用卡的到期日,先說/輸入月份,再說/輸入年份。 | |
| 01/27 | |
| 我收到的信用卡到期日為 2027 年 1 月。對嗎? | |
| 是 | |
| 太好了,我已收集到信用卡到期日。 |
重試次數
使用者在第一次嘗試時提供到期日;服務專員重新確認收集到的到期日;使用者說「不對」。服務專員請使用者確認到期日的哪一部分不正確 (完整日期、月份或年份),並再次提示使用者提供詳細資料。
| 使用者輸入內容 | 代理回覆 |
|---|---|
| 請說出或輸入信用卡的到期日,先說/輸入月份,再說/輸入年份。 | |
| 01/27 | |
| 我收到的信用卡到期日為 2027 年 1 月。對嗎? | |
| 內容有誤 | |
| 抱歉,我沒聽清楚。請問您要變更整個日期,還是只變更月份或年份? | |
| 月 | |
| 不便之處請見諒,請說出或輸入信用卡的到期月份。 | |
| 2 月 | |
| 我收到的信用卡到期月份是 2 月。對嗎? | |
| 是 | |
| 我收到的信用卡到期日是 2027 年 2 月。對嗎? | |
| 是 | |
| 太好了,我已收集到信用卡到期日。 |
部分輸入
情境:使用者無法在第一次嘗試時提供到期日;服務專員將到期日拆開,先詢問月份,再詢問年份。使用者這次正確提供輸入內容,代理也成功接受。
| 使用者輸入內容 | 代理回覆 |
|---|---|
| 請說出或輸入信用卡的到期日,先說/輸入月份,再說/輸入年份。 | |
| 13 | |
| 抱歉,到期日似乎不正確。請重新輸入月份。 請說出或輸入信用卡的到期月份。 |
|
| 1 | |
| 我收到的信用卡到期月份是 1 月。對嗎? | |
| 沒錯 | |
| 請說出或輸入信用卡的到期年份。 | |
| 26 | |
| 我收到的信用卡到期年分是 2026 年。對嗎? | |
| 是 | |
| 我收到的信用卡到期日是 2026 年 1 月。對嗎? | |
| 是 | |
| 太好了,我已收集到信用卡到期日。 |
無法辨識的輸入內容
使用者提供無法辨識的輸入內容三次後,元件就會退出流程。
| 使用者輸入內容 | 代理回覆 |
|---|---|
| 請說出或輸入信用卡的到期日,先說/輸入月份,再說/輸入年份。 | |
| 沒關係 | |
| 抱歉,我聽不懂,請再次說出或輸入信用卡的到期日。 | |
| nice | |
| 嗯,我還是聽不清楚。請確認你說的是信用卡的到期日。你也可以使用鍵盤輸入信用卡的到期日。 | |
| good | |
| 抱歉,我不懂你的意思。 |
信用卡到期日驗證
信用卡到期月份應輸入介於「01」和「12」之間的整數,或代表「January」和「December」之間月份的字串。
信用卡到期年分應為四位數。如果輸入值為兩位數,系統會將其轉換為四位數年份,例如「25」會變成「2025」。此外,年份不得超過當前年份 10 年。
信用卡到期日 (包括月份和年份) 必須晚於當前月份和年份。
命名慣例
這個預建元件採用下列命名慣例:
| 功能 | 格式 | 範例 |
|---|---|---|
| Flow | [Component Name] | 信用卡到期日收集 |
| 元件專屬意圖 | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_credit_card_expiration_date_collection_collect_date |
| 實體類型 | prebuilt_components_[component_name]_[entity_type_name] | prebuilt_components_credit_card_expiration_date_collection_month |
| 參數 | [param_name] | expiration_date |
輸出參數
輸出參數是工作階段參數,在退出元件後仍會保持有效。這些參數包含元件收集的重要資訊。這個預建元件會提供下列輸出參數的值:
| 參數名稱 | 說明 | 輸出格式 |
|---|---|---|
| credit_card_expiration_date_collection_credit_card_expiration_date | 這個參數會傳回在對話流程工作階段期間擷取的到期元素類型物件 | { |
基本設定
如要設定這項預建元件,請按照下列步驟操作:
完成
代理應已設定完成,可以開始測試。