借助信用卡注册预构建组件，新客户和现有客户都可以申请新信用卡。
该组件首先会收集最终用户的电话号码，以确定他们是新客户还是现有客户。对于新用户，该组件会收集所需的详细信息，包括用户的月收入和支出类别或用户申请的卡福利。收集所有必要信息后，该组件会安排回电，并向用户提供请求编号。
对于现有客户，该组件会检索已注册的用户信息，并根据最终用户的偏好设置和检索到的信息（包括其信用评分）向其显示可用的卡片选项。客户选择卡片选项后，该组件会通过注册渠道（包括 WhatsApp 或短信）发送用于完成注册流程的链接。
此组件使用电话号码收集和邮政编码收集预构建组件来收集和验证用户详细信息。
限制
除了常见的预构建组件限制之外，此预构建组件还存在以下限制：
- 此组件不会加密任何数据。
对话框示例
以下示例对话框演示了此预构建组件处理的常见场景。示例对话框演示了通过电话调用组件时的行为，这会触发默认欢迎 intent 并在对话开始时发出第一个客服人员回复。
新用户
组件会检查用户是否使用已注册的手机号码进行通话，并确定用户是否为新用户。该组件会收集用户想要注册的卡类别，并收集用于识别用户的信息，包括邮政编码和电话号码。然后，该组件会安排回电，并向用户提供请求编号。
| 用户输入 | 客服人员回复 |
|---|---|
| 请问您是否为我们银行的现有客户？ | |
| 我不是 | |
| 很高兴您想向我们申请信用卡。我们有各种适合您的信用卡。 为了为您提供最合适的卡，能否请您以美元为单位提供您的月收入？ |
|
| 5,000 美元 | |
| 您对哪些费用或福利感兴趣？我们提供多种选项，例如旅行、加油和购物。 | |
| 我喜欢购物 | |
| 您选择的回复属于购物类别。如果您想继续操作，请说“是”。 | |
| 是 | |
| 代理使用邮政编码收集预构建组件收集用户的邮政编码 | |
| 您提到邮政编码是 10011，对吗？ | |
| 是的，没错 | |
| 太棒了，我们已收集完邮政编码。 | |
| 客服人员使用电话号码收集预构建组件收集用户的电话号码 | |
| Got it.您提到的号码是 1 6502530000，对吗？ | |
| 是 | |
| 太棒了，我们已收集电话号码。 我们的代表会根据您的条件给您回电，提供相关卡券。您的请求编号为 993835。 |
现有客户
组件使用电话号码识别注册客户。然后，该组件会请求用户想要注册的卡片类别和类型等信息。确认这些信息后，该组件会要求客户选择一个渠道来完成注册流程，并将链接发送到客户的已注册渠道。
| 用户输入 | 客服人员回复 |
|---|---|
| 很高兴您继续选择我们的产品和服务。我们有各种适合您的信用卡。 您对哪些消费或福利感兴趣？我们提供多种选项，例如旅行、加油和购物。 |
|
| 我想获得一张可以在下次度假时使用的卡 | |
| 您选择的回复属于“旅游”类别。如果您想继续操作，请说“是”。 | |
| 是 | |
| 我们提供 3 种类型的卡片，可满足您的申请类型：白金旅行卡、金色旅行卡、传统旅行卡。您想了解所有卡片还是特定卡片的相关信息？例如，如果您要专门查找传统卡片，请说“传统卡片”。 | |
| 您能告诉我一下白金卡吗？ | |
| 没问题，白金旅行卡的年费为 95 美元。福利包括：每年可获得 10,000 英里奖励里程，在所有其他购买交易中可无限次获得 2 倍里程，里程既好赚又好用。您可以访问我们的网站，详细了解福利或奖励。 请确认您是否要注册白金旅行卡。 |
|
| 好的，我们这样做 | |
| 我们会分享一个包含注册流程步骤的链接。您是否希望我们通过短信或 WhatsApp 向您的手机号码发送这些银行卡详细信息？ | |
| 请发送短信 | |
| 好的，我们会将链接发送到您注册的手机号码。此操作可能需要几秒钟的时间。您能否通过说“是”或“否”来确认您是否已收到链接？ | |
| 我知道了 | |
| 太棒了，现在您可以打开链接，查看卡券注册详情。数据填写完毕后，系统会开始发放新卡，并将其寄送到您当前的地址。 |
拒绝提供信息
用户拒绝提供注册信用卡所需的信息。组件会退出并显示失败消息。
| 用户输入 | 客服人员回复 |
|---|---|
| 请问您是否为我们银行的现有客户？ | |
| 不，我没有 | |
| 很高兴您想向我们申请信用卡。我们有各种适合您的信用卡。 为了为您提供最合适的卡，能否请您以美元为单位提供您的月收入？ |
|
| 我不想告诉您这些信息 | |
| 感谢您的来电。很抱歉，如果没有所需的信息，我们目前无法继续处理。 |
命名规则
此预构建组件使用以下命名惯例：
| 功能 | 格式 | 示例 |
|---|---|---|
| 流程 | [Component Name] | 注册信用卡 |
| 特定于组件的 intent | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_cc_enroll_collect_cardtype |
| 实体类型 | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_cc_enroll_expense_category |
| 网络钩子 | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_credit_card_enrollment:get_available_card |
输入参数
输入参数是用于配置组件特定行为的参数。流程中一个或多个条件将使用这些参数来确定组件的行为方式。必须在组件的开始页面上设置流程级范围的参数，如下所述。会话级范围的参数可以通过调用流程或在此组件的首页上设置。
此预构建组件接受以下输入参数：
| 参数名称 | 说明 | 输入格式 |
|---|---|---|
| $session.params.auth_level | （可选）表示最终用户的当前身份验证级别。 | 整数 |
| $session.params.phone_number | （可选）最终用户的手机号码。如果未提供此参数，该组件将从最终用户收集手机号码。 | 字符串 |
| $flow.max_retry_count | 指定向最终用户提供的重试次数。默认值为 3。 |
整数 |
| $flow.currency_name | 指定收集每月收入详情时预期的币种。默认值为 "USD"。 |
字符串 |
如需为此组件配置输入参数，请展开相应部分查看说明。
- 打开 Dialogflow CX 控制台。
- 选择您的 Google Cloud 项目。
- 选择您的代理。
- 选择构建标签页。
- 点击流部分中的导入的组件。
- 点击页面部分中的“首页”。
- 点击“开始”页面中的 true 路线。
- 在“路线”窗口中，根据需要修改参数预设值。
- 点击保存。
输出参数
输出参数是会话参数，会在退出组件后保持有效状态。这些参数包含组件收集的重要信息。此预构建组件会为以下输出参数提供值：
| 参数名称 | 说明 | 输出格式 |
|---|---|---|
| phone_number | 用户的本地手机号码（不含国家/地区代码），用于识别用户。 | 字符串 |
| transfer_reason | 如果流程未成功，此参数会指明流程退出的原因。返回的值如下：agent：最终用户在对话过程中的某个时间点请求了人工客服。denial_of_information：最终用户拒绝分享组件请求的信息。max_no_input：对话达到了无输入事件的最大重试次数。请参阅无输入内置事件。max_no_match：对话达到了无匹配事件的最大重试次数。请参阅无匹配内置事件。webhook_error：发生了网络钩子错误。请参阅 webhook.error 内置事件。webhook_not_found：无法访问某个网络钩子网址。请参阅 webhook.error.not-found 内置事件。 |
字符串 |
基本设置
如需设置此预构建组件，请执行以下操作：
- 导入预构建组件。
- 使用描述外部服务的配置配置提供的灵活的 Webhook，请参阅下文中的 Webhook 设置。
网络钩子设置
如需使用此组件，您需要配置随附的灵活的 Webhook，以从外部服务检索所需信息。
获取账号详情
该组件使用 prebuilt_components_credit_card_enrollment:get_account_details Webhook 检索用户的账号详细信息（如果存在）。
API 请求参数
该组件会将以下参数作为 API 请求的输入提供给 API 请求。
| 参数名称 | 说明 | 输入格式 |
|---|---|---|
| $session.params.phone_number | 用户的本地手机号码（不含国家/地区代码），用于识别用户。 | 字符串 |
API 响应参数
系统会从 API 响应中提取以下参数，以供组件使用。
| 参数名称 | 说明 | 输出格式 |
|---|---|---|
| account_count | 与已注册的手机号码关联的账号数量。 | 整数 |
| credit_score | 用户的注册信用评分。 | 整数 |
如需为此组件配置“获取账号详情”Webhook，请展开相应部分查看说明。
- 打开 Dialogflow CX 控制台。
- 选择您的 Google Cloud 项目。
- 选择您的代理。
- 选择管理标签页。
- 点击网络钩子。
- 选择 prebuilt_components_credit_card_enrollment:get_account_details webhook。
- 将“对话式 AI 助理 (Dialogflow CX)”的 Webhook 网址字段中的网址替换为您要集成的服务的端点。在下拉菜单中选择适当的方法。
- 查看并更新请求正文，为您的网络钩子构成正确的请求格式。
- 查看并更新响应配置，以从您的 webhook 响应中提取特定字段。请勿修改参数名称，因为组件需要这些名称才能访问返回的字段值。
- 根据需要查看并更新身份验证设置。
- 点击保存。
获取卡片数量
该组件使用 prebuilt_components_credit_card_enrollment:get_card_count Webhook 检索与已注册用户的账号关联的信用卡数量。
API 请求参数
该组件会将以下参数作为 API 请求的输入提供给 API 请求。
| 参数名称 | 说明 | 输入格式 |
|---|---|---|
| $session.params.phone_number | 用户的本地手机号码（不含国家/地区代码），用于识别用户。 | 字符串 |
API 响应参数
系统会从 API 响应中提取以下参数，以供组件使用。
| 参数名称 | 说明 | 输出格式 |
|---|---|---|
| card_count | 注册用户账号中的信用卡总数。 | 整数 |
如需为此组件配置“获取卡片数量”Webhook，请展开相应部分查看相关说明。
- 打开 Dialogflow CX 控制台。
- 选择您的 Google Cloud 项目。
- 选择您的代理。
- 选择管理标签页。
- 点击网络钩子。
- 选择 prebuilt_components_credit_card_enrollment:get_card_count Webhook。
- 将“对话式 AI 助理 (Dialogflow CX)”的 Webhook 网址字段中的网址替换为您要集成的服务的端点。在下拉菜单中选择适当的方法。
- 查看并更新请求正文，为您的网络钩子构成正确的请求格式。
- 查看并更新响应配置，以从您的 webhook 响应中提取特定字段。请勿修改参数名称，因为组件需要这些名称才能访问返回的字段值。
- 根据需要查看并更新身份验证设置。
- 点击保存。
获取可用的卡片
该组件使用 prebuilt_components_credit_card_enrollment:get_available_card webhook 来根据用户的信用分数检索用户可用于特定类别的卡片列表。
API 请求参数
该组件会将以下参数作为 API 请求的输入提供给 API 请求。
| 参数名称 | 说明 | 输入格式 |
|---|---|---|
| $flow.expense_category | 用户选择注册的支出类别。有效值由 prebuilt_components_cc_enroll_expense_category 自定义实体定义。默认情况下，支持 fuel、shopping 和 travel。 |
字符串 |
| $flow.credit_score | 用户的信用评分，由组件使用获取账号详细信息 webhook 检索。 | 整数 |
API 响应参数
系统会从 API 响应中提取以下参数，以供组件使用。
| 参数名称 | 说明 | 输出格式 |
|---|---|---|
| available_card_names | 可供用户使用的卡片列表，例如 ["gold shopping card","classic shopping card"]。 |
列表（字符串） |
| cards_count | 可供用户使用的卡片数量。 | 整数 |
如需为此组件配置“获取可用卡片”Webhook，请展开相应部分查看说明。
- 打开 Dialogflow CX 控制台。
- 选择您的 Google Cloud 项目。
- 选择您的代理。
- 选择管理标签页。
- 点击网络钩子。
- 选择 prebuilt_components_credit_card_enrollment:get_available_card webhook。
- 将“对话式 AI 助理 (Dialogflow CX)”的 Webhook 网址字段中的网址替换为您要集成的服务的端点。在下拉菜单中选择适当的方法。
- 查看并更新请求正文，为您的网络钩子构成正确的请求格式。
- 查看并更新响应配置，以从您的 webhook 响应中提取特定字段。请勿修改参数名称，因为组件需要这些名称才能访问返回的字段值。
- 根据需要查看并更新身份验证设置。
- 点击保存。
获取所选卡片的详细信息
该组件使用 prebuilt_components_credit_card_enrollment:get_selected_card Webhook 检索所选卡的年费和福利。
API 请求参数
该组件会将以下参数作为 API 请求的输入提供给 API 请求。
| 参数名称 | 说明 | 输入格式 |
|---|---|---|
| $flow.card_type | 用户选择注册的卡片类型。有效值由 prebuilt_components_cc_enroll_card_type 自定义实体定义。默认情况下，支持 classic、gold 和 platinum。 |
字符串 |
| $flow.expense_category | 用户选择注册的支出类别。有效值由 prebuilt_components_cc_enroll_expense_category 自定义实体定义。默认情况下，支持 fuel、shopping 和 travel。 |
字符串 |
| $flow.credit_score | 用户的信用评分，由组件使用获取账号详细信息 webhook 检索。 | 整数 |
API 响应参数
系统会从 API 响应中提取以下参数，以供组件使用。
| 参数名称 | 说明 | 输出格式 |
|---|---|---|
| selected_card_benefits | 所选卡的福利信息。 | 字符串 |
| selected_card_annual_fee | 所选卡的年费。 | 整数 |
| selected_card_name | 所选卡片的名称。 | 字符串 |
如需为此组件配置“获取所选卡的详细信息”Webhook，请展开相应部分查看说明。
- 打开 Dialogflow CX 控制台。
- 选择您的 Google Cloud 项目。
- 选择您的代理。
- 选择管理标签页。
- 点击网络钩子。
- 选择 prebuilt_components_credit_card_enrollment:get_selected_card webhook。
- 将“对话式 AI 助理 (Dialogflow CX)”的 Webhook 网址字段中的网址替换为您要集成的服务的端点。在下拉菜单中选择适当的方法。
- 查看并更新请求正文，为您的网络钩子构成正确的请求格式。
- 查看并更新响应配置，以从您的 webhook 响应中提取特定字段。请勿修改参数名称，因为组件需要这些名称才能访问返回的字段值。
- 根据需要查看并更新身份验证设置。
- 点击保存。
提交注册请求
该组件使用 prebuilt_components_credit_card_enrollment:submit_enroll webhook 根据新用户提供的偏好设置和用户详细信息创建卡片注册请求。
API 请求参数
该组件会将以下参数作为 API 请求的输入提供给 API 请求。
| 参数名称 | 说明 | 输入格式 |
|---|---|---|
| $session.params.phone_number | 用户的本地手机号码（不含国家/地区代码），用于识别用户。 | 字符串 |
| $flow.zipcode | 用户提供的邮政编码。 | 字符串 |
| $flow.monthly_salary | 用户提供的月薪。 | 整数 |
| $flow.currency_name | 月薪的币种，在组件的输入参数中进行配置。请参阅输入参数。 | 字符串 |
API 响应参数
系统会从 API 响应中提取以下参数，以供组件使用。
| 参数名称 | 说明 | 输出格式 |
|---|---|---|
| request_number | 成功注册卡片注册请求的请求编号。 | 整数 |
如需为此组件配置“提交注册请求”Webhook，请展开相应部分查看说明。
- 打开 Dialogflow CX 控制台。
- 选择您的 Google Cloud 项目。
- 选择您的代理。
- 选择管理标签页。
- 点击网络钩子。
- 选择 prebuilt_components_credit_card_enrollment:submit_enroll webhook。
- 将“对话式 AI 助理 (Dialogflow CX)”的 Webhook 网址字段中的网址替换为您要集成的服务的端点。在下拉菜单中选择适当的方法。
- 查看并更新请求正文，为您的网络钩子构成正确的请求格式。
- 查看并更新响应配置，以从您的 webhook 响应中提取特定字段。请勿修改参数名称，因为组件需要这些名称才能访问返回的字段值。
- 根据需要查看并更新身份验证设置。
- 点击保存。
发送消息
该组件使用 prebuilt_components_credit_card_enrollment:send_message Webhook 发送消息，其中包含用于为现有客户完成信用卡注册的链接。
API 请求参数
该组件会将以下参数作为 API 请求的输入提供给 API 请求。
| 参数名称 | 说明 | 输入格式 |
|---|---|---|
| $session.params.phone_number | 用户的本地手机号码（不含国家/地区代码），用于识别用户。 | 字符串 |
| $flow.channel | 用户选择接收消息的渠道。有效值由 prebuilt_components_cc_enroll_channel 自定义实体定义。默认情况下，支持 SMS 和 WhatsApp。 |
字符串 |
| $flow.selected_card_name | 用户选择的卡片列表，例如 ["gold shopping card","classic shopping card"]。 |
列表（字符串） |
API 响应参数
系统会从 API 响应中提取以下参数，以供组件使用。
| 参数名称 | 说明 | 输出格式 |
|---|---|---|
| message_sent | 指示消息是否已成功发送到用户指定的渠道。 | 布尔值 |
如需为此组件配置“发送消息”Webhook，请展开相应部分查看相关说明。
- 打开 Dialogflow CX 控制台。
- 选择您的 Google Cloud 项目。
- 选择您的代理。
- 选择管理标签页。
- 点击网络钩子。
- 选择 prebuilt_components_credit_card_enrollment:send_message webhook。
- 将“对话式 AI 助理 (Dialogflow CX)”的 Webhook 网址字段中的网址替换为您要集成的服务的端点。在下拉菜单中选择适当的方法。
- 查看并更新请求正文，为您的网络钩子构成正确的请求格式。
- 查看并更新响应配置，以从您的 webhook 响应中提取特定字段。请勿修改参数名称，因为组件需要这些名称才能访问返回的字段值。
- 根据需要查看并更新身份验证设置。
- 点击保存。
完成
您的客服人员及其网络钩子现在应该已设置完毕，可以进行测试了。