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

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

限制

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

  • 這個元件不包含付款網關整合。

啟用 DTMF,讓使用者可透過電話鍵盤輸入數值。

其他功能

這個預先建構的元件會提供下列額外功能:

對話方塊範例

以下對話方塊範例說明這個預先建構元件處理的常見情境。以下對話方塊範例說明透過電話呼叫元件時的行為,這會在對話開始時觸發預設歡迎意圖和第一個服務專員回應。

輸入成功

使用者在第一次嘗試時提供到期日,服務專員成功接受。

使用者輸入內容 服務專員回應
請說出或輸入信用卡到期日,先說出月份,再說年份。
01/27
我收到的信用卡到期日為 2027 年 1 月。對嗎?
太好了,我已收集到信用卡的到期日。

重試

使用者在首次嘗試時提供到期日;當服務專員再次確認所收集到期日時,使用者表示「錯誤」。代理程式會請使用者確認到期日的哪個部分不正確 (整個日期、月份或年份),並再次提示使用者提供詳細資料。

使用者輸入內容 服務專員回應
請說出或輸入信用卡到期日,先說出月份,再說年份。
01/27
我收到的信用卡到期日為 2027 年 1 月。對嗎?
錯誤
抱歉,我沒聽清楚。請問你想變更整個日期,還是只想變更月份或年份?
個月
不便之處請見諒,請說出或輸入信用卡到期月份。
2 月
我收到的信用卡到期月為 2 月。對嗎?
我收到的信用卡到期日為 2027 年 2 月。對嗎?
太好了,我已收集到信用卡的到期日。

部分輸入內容

情境:使用者無法在首次嘗試時提供到期日;代理人將到期日分開,並詢問月份和年份。這次使用者輸入內容正確無誤,代理程式也成功接受輸入內容。

使用者輸入內容 服務專員回應
請說出或輸入信用卡到期日,先說出月份,再說年份。
13
很抱歉,到期日似乎不正確。我們來試著再次擷取月份。

請說出或輸入信用卡到期月份。
1
我收到的信用卡到期月分是 1 月。對嗎?
沒錯
請說出或輸入信用卡到期年份。
26
我收到的信用卡到期年份是 2026 年。對嗎?
我收到的信用卡到期日為 2026 年 1 月。對嗎?
太好了,我已收集到信用卡的到期日。

無法辨識的輸入內容

當使用者三次提供未識別的輸入內容,元件就會退出流程。

使用者輸入內容 服務專員回應
請說出或輸入信用卡到期日,先說出月份,再說年份。
沒關係
抱歉,我沒聽清楚。請再說一次或輸入信用卡到期日。
不錯
嗯,我還是沒聽清楚。請確認你說的是信用卡到期日。你也可以使用數字鍵盤輸入信用卡到期日。
good
抱歉,我不懂你的意思。

驗證信用卡到期日

信用卡到期日月份應輸入介於 '01' 和 '12' 之間的整數,或代表月份的字串,月份介於 'January' 和 'December' 之間。

信用卡到期日的年份應為四位數字,如果輸入值為兩位數,系統會將其轉換為四位數年份,例如「25」會變成「2025」。此外,年份應為目前年份的 10 年後。

信用卡到期日 (包括月份和年份) 必須是未來的日期,且必須考量目前的月份和年份。

命名慣例

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

功能 格式 範例
心流狀態 [元件名稱] 收集信用卡到期日
元件專屬意圖 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. 匯入預先建構的元件

完成

您的服務專員現在應已設定完成,可以開始測試。