丢失或被盗的卡预构建组件

丢失/被盗卡预构建组件可对用户进行身份验证、检索已注册给用户的卡,并允许用户锁定卡。在确认银行卡锁定后,该组件 用户注册升级服务或重新签发新卡。该组件使用 自定义版本的 身份验证 用于对持卡人进行身份验证的预构建组件。

限制

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

  • 此组件不会加密任何数据。

示例对话框

以下示例对话框展示了由此函数处理的常见场景 预构建组件。示例对话框演示了组件 通过电话调用,这将触发“默认欢迎 intent”和第一个 在对话开始时让客服人员回应你。

未经身份验证的用户使用一张卡

代理会发现用户之前未进行身份验证,并收集信息以验证用户是否为注册卡持有人。一次 用户经过身份验证后,代理会检索有关单张卡的信息 注册到该用户的用户名。用户确认要锁定卡,客服人员锁定卡。最后,客服人员确认用户的首选卡和送货地址,并为用户重新签发新卡。

用户输入 客服人员回复
代理使用身份验证预构建组件对用户进行身份验证
谢谢,您已成功通过身份验证。
我们正在获取您的银行卡详细信息,请稍候。

我们发现您尾号为 4444 的 MasterCard 卡。您是否要永久锁定您的卡?
请告诉我们您锁定银行卡的原因。您可以从损坏、被盗、丢失或他人等问题中选择。
我的卡片丢失了
感谢您提供的信息。我们将帮助您永久锁定您的卡。能否请您确认一下银行卡是否以 4444 结尾?
好的,在继续之前,我们会向您注册的手机号码发送一个验证码。请告诉我们用于验证请求的代码。
123457
好的,尾号为 4444 的卡将被永久锁定。锁定后,您将无法再使用该卡在线或在 POS 机上进行任何交易。您是否确认此操作?
已成功锁定您的银行卡。您的请求编号为 9761431,已成功分享到您的注册手机号码。您想要重新签发新卡吗?
您符合申请白金卡的条件。年费为 97 美元,您可以获得价值 494 美元的年度奖金和特别福利。请点击发送到您注册的手机号码的链接,了解详情。

您是否要注册此卡?
我们会将卡片寄送到您注册的地址。能否请您确认一下您的配送地址的邮政编码是 12345?
好的,请等待几秒钟,我们正在提出重新发卡的申请。

重新发卡申请已成功提交。您的请求编号是 4643943,已成功将其分享至您的注册手机号码。

该卡将在 3 个工作日内寄送至您的注册地址。要使用该卡,请按照与它提供的说明操作。

已通过身份验证且拥有多张卡的用户

代理会识别用户是否已通过身份验证,并检索已注册给用户的卡片的相关信息。用户选择的卡 之前已锁定,因此该代理允许用户申请新卡。

用户输入 客服人员回复
我们正在提取您的卡片详细信息,请耐心等待。

我们发现有多个卡片使用您的电话号码注册。我们有尾号为 1456 的 Visa 卡、尾号为 1457 的 MasterCard 卡、尾号为 1345 的 MasterCard 卡和尾号为 3456 的 Visa 卡

请告诉我们您要锁定的卡的后 4 位数字。
1457
我们所获卡号的后 4 位数字是 1457,对吗?
您请求的银行卡已处于永久锁定状态。您要重新签发新卡吗?
我们会将卡片寄送到您注册的地址。能否请您确认一下您的配送地址的邮政编码是 12345?
好的,请等待几秒钟,我们正在提出重新发卡的申请。

重新发卡申请已成功提交。您的请求编号是 5423270,我们已成功将其分享至您的注册手机号码。

该卡将在 3 个工作日内寄送至您的注册地址。如需使用该卡,请按照随卡附上的说明操作。

您想屏蔽其他卡吗?
不用了,我没问题了
好的,感谢您来电。

命名规则

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

特征 格式 示例
流程 [组件名称] 丢失与被盗银行卡
实体类型 prebuilt_components_[component_name]_[entity_type] prebuilt_components_lost_and_stolen_lock_reason
网络钩子 prebuilt_components_[component_name]:[webhook_action] prebuilt_components_lost_and_stolen_card:lock_card_ticket_number

输入参数

输入参数是用于配置 组件。流程中的一个或多个条件将使用这些参数来确定组件的行为方式。必须在组件的开始页面上设置流程级范围的参数,如下所述。会话级范围的 可以通过调用数据流或在启动时 页面。

此预构建组件接受以下输入参数:

参数名称 说明 输入格式
$session.params.auth_level (可选)指示调用者的身份验证级别 整数
$session.params.auth_level_req 表示用户需要达到的身份验证级别才能访问其交易记录。此值通过 check auth level 页面中页面条目执行方式参数预设配置。默认情况下,此值为 1 整数
$session.params.account_auth_enabled 指明是否应按身份验证类型中所述以账号持有人的身份对用户进行身份验证。此值在 check auth level 页面中的网页条目执行方式参数预设中进行配置。默认情况下,此值为 false 布尔值
$session.params.card_auth_enabled 指明是否应如身份验证类型中所述,对用户作为持卡人进行身份验证。此值在 check auth level 页面中的网页条目执行方式参数预设中进行配置。默认情况下,此值为 true 布尔值
$session.params.phone_number (可选)用于验证身份的客户注册手机号码。 字符串
$session.params.card_count (可选)与经过身份验证的用户关联的信用卡数量。 整数
$flow.card_status_active 指定验证卡 webhook 返回的参数值,以表明所选卡当前处于有效状态。默认情况下,值为 "active" 字符串
$flow.card_status_lock_temp 指定 Validate card webhook 返回的参数值,以指示所选卡片已暂时锁定。默认值为 "inactive" 字符串
$flow.card_status_lock_permanent 指定 Validate card webhook 返回的参数值,以指明所选卡已永久锁定。默认值为 "blocked" 字符串
$flow.max_retry_card_number 指定在收集信用卡的最后四位数时允许的重试次数。默认值为 3 整数
$flow.max_otp_retry_count 指定在用户收集动态密码 (OTP) 时允许的重试次数。默认值为 3 整数

若要配置此组件的输入参数,请展开即可查看相关说明。

  1. 打开 Dialogflow CX 控制台
  2. 选择您的 Google Cloud 项目。
  3. 选择您的代理。
  4. 选择 Build 标签页。
  5. 点击部分中导入的组件。
  6. 点击页面部分中的“首页”。
  7. 点击初始页中的 true 路由。
  8. 在“路线”窗口中,根据需要修改参数预设的值。
  9. 点击保存

输出参数

输出参数是指退出后仍然有效的会话参数 组件。这些参数包含由 组件。此预构建组件会为以下输出参数提供值:

参数名称 说明 输出格式
auth_level 指示调用方的身份验证级别 整数
phone_number 用户的本地电话号码(不含国家/地区代码),用于识别用户。 字符串
card_count 与注册电话号码相关联的卡号。 整数
last_four_digit_of_card_number 如果用户只有一张卡,则返回卡号的最后 4 位数字。如果用户有多个卡,则此参数的值为用户选择锁定或重新签发新卡的卡的最后四位数字。 字符串
transfer_reason 此参数会指明流退出的原因(如果流程未成功)。返回值为以下值之一:

agent:最终用户在对话过程中的某个时间点请求人工客服。

denial_of_information:最终用户拒绝分享组件请求的信息。

max_no_input:对话已达到无输入事件的重试次数上限。请参阅无输入内置事件

max_no_match:对话达到了无匹配事件的最大重试次数。请参阅无匹配内置事件

webhook_error:发生了网络钩子错误。请参阅 webhook.error 内置事件

webhook_not_found:无法访问网络钩子网址。请参阅 webhook.error.not-found 内置事件
字符串

基本设置

如需设置此预构建组件,请执行以下操作:

  1. 导入预构建组件
  2. 使用描述外部服务的配置配置提供的灵活的 Webhook,请参阅下文中的 Webhook 设置。

网络钩子设置

要使用此组件,您需要配置包含的 灵活的网络钩子 从外部服务获取所需的信息

身份验证

如果您之前没有为 您需要对其进行配置,以启用对 用户。如需了解详细说明,请参阅身份验证 Webhook 设置

获取卡的详细信息

该组件使用 prebuilt_components_account_services:get_card_details Webhook 来获取已向用户注册的卡片的相关信息。

API 请求参数

该组件会将以下参数作为 API 请求的输入提供给 API 请求。

参数名称 说明 输入格式
$session.params.phone_number 用户的本地电话号码(不含国家/地区代码),用于识别用户。 字符串

API 响应参数

以下参数是从 API 响应中提取的,供组件使用。

参数名称 说明 输出格式
last_four_digit_of_all_cards 包含用户所注册卡的后四位数字的列表,例如 ["0000", "1111", "2222"]。此列表中的每个元素都与 card_vendor_all 中具有相同索引的元素表示同一张卡片。 列表(字符串)
card_vendor_all 包含与用户注册的每张卡对应的信用卡供应商的列表,例如 ["Visa", "Mastercard", "Discover"]。此列表中的每个元素都与 last_four_digit_of_all_cards 中具有相同索引的元素表示同一张卡片。 列表(字符串)
card_count 与经过身份验证的用户相关联的卡数。 整数

如需为此组件配置“获取卡片详情”Webhook,请展开相应部分查看说明。

  1. 打开 Dialogflow CX 控制台
  2. 选择您的 Google Cloud 项目。
  3. 选择您的代理。
  4. 选择管理标签页。
  5. 点击网络钩子
  6. 选择 prebuilt_components_account_services:get_card_details webhook。
  7. 将 Conversational Agents (Dialogflow CX) Webhook 网址 字段中的网址替换为服务的端点 哪些组件需要集成从下拉菜单中选择适当的方法
  8. 查看并更新请求正文,为 webhook 构建正确的请求格式。
  9. 查看并更新响应配置,以从您的 webhook 响应中提取特定字段。请勿修改参数名称,因为组件要访问这些参数名称 所返回的字段值。
  10. 查看并根据需要更新身份验证设置。
  11. 点击保存

验证卡

该组件使用 prebuilt_components_lost_and_stolen_card:validate_card Webhook 来获取注册到用户账号的特定卡片的相关信息。

API 请求参数

该组件会将以下参数作为 API 请求的输入提供给 API 请求。

参数名称 说明 输入格式
$session.params.phone_number 用户的本地电话号码(不含国家/地区代码),用于识别用户。 字符串
$session.params.last_four_digit_of_card_number 用户请求锁定的卡号的后四位数。 字符串

API 响应参数

以下参数是从 API 响应中提取的,供组件使用。

参数名称 说明 输出格式
zip_code 在用户账号中注册的邮政编码。 字符串
card_vendor 所选卡的信用卡供应商。 字符串
card_status 表示卡的当前状态。默认情况下,有效值为有效、暂时屏蔽或永久屏蔽。这些状态由参数 $flow.card_status_active$flow.card_status_lock_temp$flow.card_status_lock_permanent 指定。请参阅输入参数 字符串
card_upgrade 指明所选卡是否可以升级。 布尔值
card_upgrade_type 指定可用的卡升级类型,例如 "gold""platinum"。如果 card_upgrade 为 false,则此参数不是必需的。 字符串
card_upgrade_annual_fee 指定升级卡所需的年费金额(美元),例如 150。如果 card_upgrade 为 false,则无需使用此参数。 数字
card_upgrade_benefit 指定卡升级的福利金额(以美元为单位),例如 450。如果 card_upgrade 为 false,则无需使用此参数。 数字
reissue_status 指示是否已为此卡重新签发新卡。 布尔值
dispatch_status 指示重新签发的卡片是否已寄送至注册地址。如果 reissue_status 为 false,则 dispatch_status 必须为 false 布尔值
card_estimated_duration 新卡的预计送货时间,例如 "2 days""24 hours"。如果 reissue_status 为 false,则此参数不是必需的。 字符串

如需为此组件配置验证卡片网络钩子,请展开即可查看相关说明。

  1. 打开 Dialogflow CX 控制台
  2. 选择您的 Google Cloud 项目。
  3. 选择您的代理。
  4. 选择管理标签页。
  5. 点击 Webhook
  6. 选择预构建_components_lost_and_stolen_card:validate_card 网络钩子。
  7. 将 Conversational Agents (Dialogflow CX) Webhook 网址 字段中的网址替换为服务的端点 哪些组件需要集成在下拉菜单中选择适当的方法
  8. 查看并更新请求正文,为 webhook 构建正确的请求格式。
  9. 查看并更新响应配置,以从您的 webhook 响应中提取特定字段。请勿修改参数名称,因为组件要访问这些参数名称 所返回的字段值。
  10. 查看并根据需要更新身份验证设置。
  11. 点击保存

锁定卡

prebuilt_components_lost_and_stolen_card:lock_card_ticket_number 网络钩子 被组件用来创建锁定所选支付卡的请求。

API 请求参数

该组件会将以下参数作为 API 请求的输入提供给 API 请求。

参数名称 说明 输入格式
$session.params.phone_number 用户的本地电话号码(不含国家/地区代码),用于识别用户。 字符串
$session.params.last_four_digit_of_card_number 用户请求锁定的卡号的后四位数。 字符串
$flow.lock_type 表示要应用于用户卡的锁定类型。默认情况下,此组件支持为丢失和被盗的银行卡设置永久锁定。有效的锁定类型由参数 $flow.card_status_active$flow.card_status_lock_temp$flow.card_status_lock_permanent 指定。请参阅输入参数 字符串
$flow.lock_reason 指明用户请求锁定卡的原因。有效值由 prebuilt_components_lost_and_stolen_lock_reason 自定义实体定义。默认情况下,支持 "damaged""stolen""lost""others" 字符串

API 响应参数

以下参数是从 API 响应中提取的,供组件使用。

参数名称 说明 输出格式
ticket_number 所创建锁定卡请求的票券编号。 整数

如需为此组件配置锁定卡片网络钩子,请展开即可查看相关说明。

  1. 打开 Dialogflow CX 控制台
  2. 选择您的 Google Cloud 项目。
  3. 选择您的代理。
  4. 选择管理标签页。
  5. 点击网络钩子
  6. 选择 prebuilt_components_lost_and_stolen_card:lock_card_ticket_number Webhook。
  7. 将 Conversational Agents (Dialogflow CX) Webhook 网址 字段中的网址替换为服务的端点 哪些组件需要集成从下拉菜单中选择适当的方法
  8. 查看并更新请求正文,为 webhook 构建正确的请求格式。
  9. 查看并更新响应配置,以从您的 webhook 响应中提取特定字段。请勿修改参数名称,因为组件要访问这些参数名称 所返回的字段值。
  10. 查看并根据需要更新身份验证设置。
  11. 点击保存

重发卡

该组件使用 prebuilt_components_lost_and_stolen_card:reissue_card_number webhook 创建重新签发新卡或升级后的卡的请求。

API 请求参数

该组件会将以下参数作为 API 请求的输入提供给 API 请求。

参数名称 说明 输入格式
$session.params.phone_number 用户的本地电话号码(不含国家/地区代码),用于识别用户。 字符串
$session.params.last_four_digit_of_card_number 用户请求锁定的卡号的后四位数。 字符串
zip_code 在用户账号中注册的邮政编码。 字符串
card_upgrade 指明用户是否选择了升级其卡。 布尔值
card_upgrade_type 指定用户选择的卡升级类型,例如 "gold""platinum"。如果 card_upgrade 为 false,则此参数不是必需的。 字符串

API 响应参数

以下参数是从 API 响应中提取的,供组件使用。

参数名称 说明 输出格式
acknowledgement_number 已创建的重发卡申请的票号。 整数

如需为此组件配置重新签发卡网络钩子,请展开即可查看说明。

  1. 打开 Dialogflow CX 控制台
  2. 选择您的 Google Cloud 项目。
  3. 选择您的代理。
  4. 选择管理标签页。
  5. 点击网络钩子
  6. 选择预构建_components_lost_and_stolen_card:reissue_card_number 网络钩子。
  7. 将“对话式客服 (Dialogflow CX)”Webhook 网址字段中的网址替换为您要集成的服务的端点。从下拉菜单中选择适当的方法
  8. 查看并更新请求正文,为 webhook 构建正确的请求格式。
  9. 查看并更新响应配置,以从您的 webhook 响应中提取特定字段。请勿修改参数名称,因为组件要访问这些参数名称 所返回的字段值。
  10. 查看并根据需要更新身份验证设置。
  11. 点击保存

完成

您的客服人员及其网络钩子现在应该已设置完毕,可以进行测试了。