信用卡到期日期收集预构建组件

预构建组件可从最终用户捕获信用卡失效日期。

限制

除了常见的预构建组件限制之外,此预构建组件还存在以下限制:

  • 此组件不包含付款网关集成。

启用 DTMF,以允许用户使用电话拨号键盘输入数字值。

其他功能

此预构建组件还提供以下其他功能:

对话框示例

以下示例对话框演示了此预构建组件处理的常见场景。示例对话框演示了通过电话调用组件时的行为,这会触发默认欢迎 intent 并在对话开始时发出第一个客服人员回复。

输入成功

最终用户在首次尝试时提供到期日期;客服人员成功接受。

用户输入 客服人员回复
请说出或输入信用卡的到期日期,从月份开始,然后是年份。
01/27
我收到的信用卡失效日期是 2027 年 1 月。对吗?
太棒了,我已收集到信用卡的失效日期。

重试

最终用户在首次尝试时提供到期日期;在客服人员重新确认收集到的到期日期时,最终用户说“它是错误的”。客服人员要求最终用户确认到期日期的哪个部分不正确(整个日期、月份或年份),并再次提示用户重新提供这些详细信息。

用户输入 客服人员回复
请说出或输入信用卡的到期日期,从月份开始,然后是年份。
01/27
我收到的信用卡失效日期是 2027 年 1 月。对吗?
不对
抱歉,我没听清楚。请告诉我,您是想更改整个日期,还是想更改月份或年份?
抱歉。请说出或输入您的信用卡到期月份。
2 月
我收到的信用卡到期月份是 2 月。对吗?
我收到的信用卡失效日期是 2027 年 2 月。对吗?
太棒了,我已收集到信用卡的失效日期。

部分输入

场景 - 最终用户在第一次尝试时无法提供到期日期;客服人员将到期日期拆分,并要求提供月份和年份。这次,最终用户正确提供了输入,并且客服人员成功接受了该输入。

用户输入 客服人员回复
请说出或输入信用卡的到期日期,从月份开始,然后是年份。
13
抱歉,失效日期似乎不正确。我们再试一次说出月份。

请说出或输入您的信用卡到期月份。
1
我收到的信用卡到期月份是 1 月。对吗?
是的,没错
请说出或输入您的信用卡到期年份。
26
我收到的信用卡到期年份是 2026 年。对吗?
我收到的信用卡失效日期是 2026 年 1 月。对吗?
太棒了,我已收集到信用卡的失效日期。

无法识别所输入的内容

最终用户提供无法识别的输入三次后,组件会退出流程。

用户输入 客服人员回复
请说出或输入信用卡的到期日期,从月份开始,然后是年份。
没关系
抱歉,我没听明白。您能否再说一遍或输入信用卡的失效日期?
nice
呃,我还是没听明白。请确保您说的是信用卡的到期日期。您也可以使用数字键盘输入信用卡的到期日期。
good
抱歉,我没听懂您的回答。

验证信用卡失效日期

信用卡到期日期的月份应输入为介于“01”和“12”之间的整数,或表示月份的字符串(介于“1 月”和“12 月”之间)。

信用卡到期日期的年份应为 4 位数。如果输入内容为两位数,则会转换为四位数年份,例如“25”会变为“2025”。此外,年份应不超过当前年份的 10 年后。

信用卡到期日期(包括月份和年份)必须是未来的日期(以当前月份和年份为依据)。

命名规则

此预构建组件使用以下命名惯例:

功能 格式 示例
流程 [组件名称] 收集信用卡失效日期
特定于组件的 intent 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. 导入预构建组件

完成

您的代理现在应该已设置完毕,可以进行测试了。