這個預先建構的元件會擷取使用者的信用卡到期日。
限制
除了常見的預先建構元件限制外,這個預先建構元件還有下列限制:
- 這個元件不包含付款閘道整合。
建議的代理程式設定
啟用 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 | 這個參數會傳回在對話流程工作階段期間擷取的到期元素類型物件 | { |
基本設定
如要設定這個預先建構的元件,請按照下列步驟操作:
完成
代理程式現在應已設定完成,可以開始測試。