信用卡到期日收集預先建構的元件

這個預先建構的元件會擷取使用者的信用卡到期日。

限制

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

  • 這個元件不包含付款閘道整合。

啟用 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 [元件名稱] 收集信用卡到期日
元件專屬意圖 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 這個參數會傳回在對話流程工作階段期間擷取的到期元素類型物件
{
"year": integer,
"month": integer
}

基本設定

如要設定這個預先建構的元件,請按照下列步驟操作:

  1. 匯入預先建構的元件

完成

代理程式現在應已設定完成,可以開始測試。