借助信用卡注册预构建组件，新客户和现有客户可以申请新信用卡。
该组件首先会收集最终用户的电话号码，以确定他们是新客户还是现有客户。对于新用户，该组件将收集所需详细信息，包括用户的月收入和支出类别，或用户申请的卡福利。收集所有必需信息后，该组件会安排回电，并向用户提供支持请求编号。
对于现有客户，该组件会检索已注册的用户信息，并根据用户的偏好设置和检索到的信息（包括信用评分）向最终用户显示可用的卡选项。客户选择卡片选项后，该组件将通过注册渠道（包括 WhatsApp 或短信）发送链接，以完成注册流程。
此组件使用电话号码收集和邮政编码收集预构建组件来收集和验证用户详细信息。
限制
除了常见的预构建组件限制之外，此预构建组件还存在以下限制：
- 此组件不会加密任何数据。
对话示例
以下示例对话展示了此预构建组件处理的常见场景。示例对话展示了通过电话调用组件时的行为，这会在对话开始时触发默认欢迎意图和第一个代理响应。
新建用户
组件检查用户是否使用已注册的手机号码进行通话，并识别出用户是新用户。该组件会收集用户想要注册的卡类别，并收集用于识别用户的信息，包括邮政编码和电话号码。然后，该组件会安排回电，并向用户提供请求编号。
| 用户输入 | 智能体回答 |
|---|---|
| 请问您是我们银行的现有客户吗？ | |
| 我不是 | |
| 很高兴您有意向向我们申请信用卡。我们有各种适合您的信用卡。 为了向您提供最合适的信用卡，您能否告知我们您的月收入（以美元为单位）？ |
|
| 5000 美元 | |
| 您对哪些费用或福利感兴趣？我们提供多种选项，例如旅行、燃油和购物。 | |
| 我喜欢购物 | |
| 您选择的回答属于“购物”类别。如果您想继续，请说“是”。 | |
| 是 | |
| 代理使用邮政编码收集预构建组件收集用户的邮政编码 | |
| 您提到邮政编码是 10011，对吗？ | |
| 是的，没错 | |
| 很好，我们已完成邮政编码的收集。 | |
| 代理使用电话号码收集预构建组件收集用户的电话号码 | |
| 知道了。您提及的号码是 +1 6502530000，对吗？ | |
| 是 | |
| 太棒了，我们已完成电话号码收集。 我们的代表会根据您的条件回电给您，为您提供相关卡片信息。您的请求编号是 993835。 |
现有客户
组件使用客户的电话号码来识别已注册的客户。然后，该组件会请求用户提供信息，例如用户想要注册的卡片的类别和类型。确认此信息后，该组件会要求客户选择一个渠道来完成注册流程，并将链接发送到客户的注册渠道。
| 用户输入 | 智能体回答 |
|---|---|
| 很高兴您继续选择我们的产品和服务。我们有各种适合您的信用卡。 您对哪些费用或福利感兴趣？我们提供多种选项，例如旅行、燃油和购物。 |
|
| 我想要一张可以在下次休假时使用的卡 | |
| 您选择的回答属于“旅游”类别。如果您想继续，请说“是”。 | |
| 是 | |
| 我们提供 3 种卡片，可满足您的各种需求：白金旅行卡、黄金旅行卡、经典旅行卡。您想了解所有卡片还是特定卡片的相关信息？例如，如果您专门想找经典卡，请说“经典卡”。 | |
| 你能告诉我白金卡的相关信息吗？ | |
| 当然，白金旅行卡的年费为 95 美元。福利包括：每年获得 10,000 英里奖励里程，所有其他购买交易均可获得双倍里程，里程易于赚取和使用。您可以在我们的网站上找到有关福利或奖金的更多信息。 请确认您是否要申请白金旅行卡。 |
|
| 好的，我们来做一下 | |
| 我们会分享一个链接，其中包含注册程序步骤。您是否希望我们通过短信或 WhatsApp 将这些卡详细信息分享到您的手机号码？ | |
| 请通过短信联系我 | |
| 好的，我们会将链接发送到您注册的手机号码。此操作可能需要几秒钟的时间。请确认您是否已收到链接，方法是说“是”或“否”。 | |
| 我明白了 | |
| 太棒了！现在，您可以打开该链接并查看卡注册详情。数据填写完毕后，系统将开始发放新卡，并将其寄送到您的当前地址。 |
拒绝提供信息
用户拒绝提供注册信用卡所需的信息。组件退出并显示失败消息。
| 用户输入 | 智能体回答 |
|---|---|
| 请问您是我们银行的现有客户吗？ | |
| 没有 | |
| 很高兴您有意向向我们申请信用卡。我们有各种适合您的信用卡。 为了向您提供最合适的信用卡，您能否告知我们您的月收入（以美元为单位）？ |
|
| 我不想告诉你相关信息 | |
| 感谢您的来电。很抱歉，在获得所需信息之前，我们目前无法继续处理您的要求。 |
命名规则
此预构建组件使用以下命名惯例：
| 功能 | 格式 | 示例 |
|---|---|---|
| Flow | [组件名称] | 信用卡注册 |
| 特定于组件的 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 请求的输入。
| 参数名称 | 说明 | 输入格式 |
|---|---|---|
| $session.params.phone_number | 用户的本地手机号码（不含国家/地区代码），用于标识用户。 | 字符串 |
API 响应参数
以下参数会从 API 响应中提取，供组件使用。
| 参数名称 | 说明 | 输出格式 |
|---|---|---|
| account_count | 与注册手机号码关联的账号数量。 | 整数 |
| credit_score | 用户的注册信用评分。 | 整数 |
如需为此组件配置“获取账号详细信息”Webhook，请展开即可查看相关说明。
- 打开 Dialogflow CX 控制台。
- 选择您的 Google Cloud 项目。
- 选择您的代理。
- 选择管理标签页。
- 点击网络钩子。
- 选择 prebuilt_components_credit_card_enrollment:get_account_details webhook。
- 将 Dialogflow CX 网络钩子网址字段中的网址替换为您要集成的服务的端点。在下拉菜单中选择适当的方法。
- 检查并更新请求正文，以形成适合您网络钩子的正确请求格式。
- 查看并更新响应配置，以从 Webhook 的响应中提取特定字段。请勿修改参数名称，因为组件需要这些名称才能访问返回的字段值。
- 根据需要查看并更新身份验证设置。
- 点击保存。
获取卡数
组件使用 prebuilt_components_credit_card_enrollment:get_card_count webhook 来检索与注册用户的账号关联的信用卡数量。
API 请求参数
以下参数由组件提供，作为 API 请求的输入。
| 参数名称 | 说明 | 输入格式 |
|---|---|---|
| $session.params.phone_number | 用户的本地手机号码（不含国家/地区代码），用于标识用户。 | 字符串 |
API 响应参数
以下参数会从 API 响应中提取，供组件使用。
| 参数名称 | 说明 | 输出格式 |
|---|---|---|
| card_count | 注册用户账号中的信用卡总数。 | 整数 |
如需为此组件配置“获取卡数”Webhook，请展开即可查看相关说明。
- 打开 Dialogflow CX 控制台。
- 选择您的 Google Cloud 项目。
- 选择您的代理。
- 选择管理标签页。
- 点击网络钩子。
- 选择 prebuilt_components_credit_card_enrollment:get_card_count webhook。
- 将 Dialogflow CX 网络钩子网址字段中的网址替换为您要集成的服务的端点。在下拉菜单中选择适当的方法。
- 检查并更新请求正文，以形成适合您网络钩子的正确请求格式。
- 查看并更新响应配置，以从 Webhook 的响应中提取特定字段。请勿修改参数名称，因为组件需要这些名称才能访问返回的字段值。
- 根据需要查看并更新身份验证设置。
- 点击保存。
获取可用卡片
该组件使用 prebuilt_components_credit_card_enrollment:get_available_card Webhook 根据用户的信用评分检索用户可用的特定类别卡片列表。
API 请求参数
以下参数由组件提供，作为 API 请求的输入。
| 参数名称 | 说明 | 输入格式 |
|---|---|---|
| $flow.expense_category | 用户选择加入的费用类别。有效值由 prebuilt_components_cc_enroll_expense_category 自定义实体定义。默认情况下，支持 fuel、shopping 和 travel。 |
字符串 |
| $flow.credit_score | 用户信用评分，由组件使用 Get account details 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。
- 将 Dialogflow CX 网络钩子网址字段中的网址替换为您要集成的服务的端点。在下拉菜单中选择适当的方法。
- 检查并更新请求正文，以形成适合您网络钩子的正确请求格式。
- 查看并更新响应配置，以从 Webhook 的响应中提取特定字段。请勿修改参数名称，因为组件需要这些名称才能访问返回的字段值。
- 根据需要查看并更新身份验证设置。
- 点击保存。
获取所选卡的详细信息
组件使用 prebuilt_components_credit_card_enrollment:get_selected_card Webhook 来检索所选卡的年费和福利。
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 | 用户信用评分，由组件使用 Get account details 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。
- 将 Dialogflow CX 网络钩子网址字段中的网址替换为您要集成的服务的端点。在下拉菜单中选择适当的方法。
- 检查并更新请求正文，以形成适合您网络钩子的正确请求格式。
- 查看并更新响应配置，以从 Webhook 的响应中提取特定字段。请勿修改参数名称，因为组件需要这些名称才能访问返回的字段值。
- 根据需要查看并更新身份验证设置。
- 点击保存。
提交注册申请
该组件使用 prebuilt_components_credit_card_enrollment:submit_enroll webhook 根据新用户提供的偏好设置和用户详细信息创建卡注册请求。
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。
- 将 Dialogflow CX 网络钩子网址字段中的网址替换为您要集成的服务的端点。在下拉菜单中选择适当的方法。
- 检查并更新请求正文，以形成适合您网络钩子的正确请求格式。
- 查看并更新响应配置，以从 Webhook 的响应中提取特定字段。请勿修改参数名称，因为组件需要这些名称才能访问返回的字段值。
- 根据需要查看并更新身份验证设置。
- 点击保存。
发送消息
该组件使用 prebuilt_components_credit_card_enrollment:send_message Webhook 发送一条包含链接的消息，以便现有客户完成信用卡注册。
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 | 指明消息是否已成功发送到用户指定的渠道。 | 布尔值 |
如需为此组件配置“发送消息”网络钩子，请展开即可查看相关说明。
- 打开 Dialogflow CX 控制台。
- 选择您的 Google Cloud 项目。
- 选择您的代理。
- 选择管理标签页。
- 点击网络钩子。
- 选择 prebuilt_components_credit_card_enrollment:send_message webhook。
- 将 Dialogflow CX 网络钩子网址字段中的网址替换为您要集成的服务的端点。在下拉菜单中选择适当的方法。
- 检查并更新请求正文，以形成适合您网络钩子的正确请求格式。
- 查看并更新响应配置，以从 Webhook 的响应中提取特定字段。请勿修改参数名称，因为组件需要这些名称才能访问返回的字段值。
- 根据需要查看并更新身份验证设置。
- 点击保存。
完成
您的代理及其 webhook 现在应已设置完毕，可以进行测试了。