信用卡注册预构建组件

信用卡注册预构建组件允许新客户和现有客户申请新信用卡。

该组件首先会收集最终用户的电话号码，以确定他们是新客户还是现有客户。对于新用户，该组件将收集所需的详细信息，包括其月收入以及用户申请的支出或卡福利类别。收集完所有必需信息后，该组件会安排回电，并向用户提供请求编号。

对于现有客户，该组件将检索注册用户信息，并根据其偏好设置和检索到的信息（包括其信用评分）向最终用户显示可用的卡选项。客户选择卡片选项后，该组件将通过 WhatsApp 或短信等注册渠道发送链接，以完成注册流程。

此组件使用电话号码收集和邮政编码收集预构建组件来收集和验证用户详细信息。

限制

除了常见的预构建组件限制之外，此预构建组件还具有以下限制：

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

对话示例

以下示例对话展示了此预构建组件处理的常见场景。示例对话演示了通过电话呼叫组件时的行为，这会在对话开始时触发默认欢迎 intent 和第一个代理响应。

新建用户

组件会检查用户是否使用已注册的手机号码拨打电话，并识别出他们是新用户。该组件会收集用户想要注册的卡类别，并收集用于识别用户身份的信息，包括邮政编码和电话号码。然后，该组件会安排回电，并向用户提供请求编号。

用户输入	智能体回答
	请问您是否为我们银行的现有客户？
我不是
	很高兴您想向我们申请信用卡。我们有多种适合您的信用卡。 为了向您提供最合适的信用卡，请问您的月收入是多少美元？
5000 美元
	您对哪些费用或福利感兴趣？我们提供多种选项，例如旅行、加油和购物。
我喜欢购物
	您选择的回答属于购物类别。如果您想继续，请说“是”。
是
	代理使用邮政编码收集预构建组件收集用户的邮政编码
	您提到的邮政编码是 10011，对吗？
是的，没错
	太棒了，我们已完成邮政编码的收集。
	代理使用电话号码收集预构建组件收集用户的电话号码
	知道了。您提到的号码是 +1 6502530000，对吗？
是
	太好了，我们已收集完电话号码。 我们的代表会根据您的条件，就相关卡片给您回电。您的请求编号为 993835。

现有客户

组件会使用已注册客户的电话号码来识别客户。然后，该组件会请求用户想要注册的卡类别和类型等信息。确认此信息后，该组件会要求客户选择一个渠道来完成注册流程，并将链接发送到客户注册的渠道。

用户输入	智能体回答
	我们很高兴您继续选择我们的产品和服务。我们有多种信用卡，总有一款适合您。 您对哪些费用或福利感兴趣？我们提供多种选项，例如旅行、加油和购物。
我想要一张下次度假时可以使用的卡
	您选择的回答属于旅行类别。如果您想继续，请说“是”。
是
	我们提供 3 种类型的卡，可满足您的各种需求：白金旅行卡、黄金旅行卡、经典旅行卡。您想了解所有卡的信息还是某张特定卡的信息？例如，如果您专门寻找经典卡，请说“经典卡”。
能跟我说说白金卡吗？
	当然可以，白金旅行卡的年费是 95 美元。福利包括：每年可获赠 10,000 英里里程，所有其他消费均可赚取 2 倍里程，里程易赚易用。您可以在我们的网站上找到有关福利或奖金的更多信息。 请确认您是否希望注册白金旅行卡。
好的，就这样
	我们会分享一个链接，其中包含注册流程步骤。您是否希望我们通过短信或 WhatsApp 将这些卡详细信息发送到您的手机号码？
请发送短信
	好的，我们正在将链接发送到您注册的手机号码。此操作可能需要几秒钟的时间。请问您是否收到了该链接？请回答“是”或“否”。
我知道了
	太好了，现在您可以打开链接并查看卡注册详情。数据填写完毕后，系统会启动新卡发放流程，并将新卡寄送到您的当前地址。

否认信息

用户拒绝提供申请信用卡所需的信息。组件退出并显示失败消息。

用户输入	智能体回答
	请问您是否为我们银行的现有客户？
不，我没空
	很高兴您想向我们申请信用卡。我们有多种适合您的信用卡。 为了向您提供最合适的信用卡，请问您的月收入是多少美元？
我不想告诉你这些信息
	感谢您的来电。很抱歉，如果您目前无法提供所需信息，我们将无法继续处理。

命名规则

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

功能	格式	示例
Flow	[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"。	字符串

输出参数

输出参数是在退出组件后仍保持有效状态的会话参数。这些参数包含组件收集的重要信息。此预构建组件会为以下输出参数提供值：

参数名称	说明	输出格式
phone_number	用户的本地手机号码（不含国家/地区代码），用于识别用户。	字符串
transfer_reason	此参数表示流程退出（如果未成功）的原因。返回的值为以下值之一： agent：最终用户在对话期间的某个时间点请求了人工客服。 denial_of_information：最终用户拒绝分享组件请求的信息。 max_no_input：对话达到了无输入事件的最大重试次数。请参阅无输入内置事件。 max_no_match：对话已达到不匹配事件的重试次数上限。请参阅不匹配内置事件。 webhook_error：发生了 webhook 错误。请参阅 webhook.error 内置事件。 webhook_not_found：网络钩子网址无法访问。请参阅 webhook.error.not-found 内置事件。	字符串

基本设置

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

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

Webhook 设置

如需使用此组件，您需要配置随附的灵活网络钩子，以便从外部服务中检索所需信息。

获取账号详情

如果账号存在，组件会使用 prebuilt_components_credit_card_enrollment:get_account_details webhook 检索用户的账号详细信息。

API 请求参数

以下参数由组件提供，作为 API 请求的输入。

参数名称	说明	输入格式
$session.params.phone_number	用户的本地手机号码（不含国家/地区代码），用于识别用户。	字符串

API 响应参数

系统会从 API 响应中提取以下参数，供组件使用。

参数名称	说明	输出格式
account_count	与已注册手机号码关联的账号数量。	整数
credit_score	用户的注册信用评分。	整数

获取卡片数量

组件使用 prebuilt_components_credit_card_enrollment:get_card_count webhook 来检索与注册用户账号关联的信用卡数量。

API 请求参数

以下参数由组件提供，作为 API 请求的输入。

参数名称	说明	输入格式
$session.params.phone_number	用户的本地手机号码（不含国家/地区代码），用于识别用户。	字符串

API 响应参数

系统会从 API 响应中提取以下参数，供组件使用。

参数名称	说明	输出格式
card_count	注册用户账号中的信用卡总数。	整数

获取可用卡

组件会使用 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	用户的信用评分，由组件使用获取账号详细信息 webhook 检索。	整数

API 响应参数

系统会从 API 响应中提取以下参数，供组件使用。

参数名称	说明	输出格式
available_card_names	用户可用的卡列表，例如 ["gold shopping card","classic shopping card"]。	列表（字符串）
cards_count	用户可用的卡片数量。	整数

获取所选卡片的详细信息

组件使用 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	用户的信用评分，由组件使用获取账号详细信息 webhook 检索。	整数

API 响应参数

系统会从 API 响应中提取以下参数，供组件使用。

参数名称	说明	输出格式
selected_card_benefits	所选卡福利的相关信息。	字符串
selected_card_annual_fee	所选卡的年费。	整数
selected_card_name	所选卡的名称。	字符串

提交注册请求

该组件使用 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	成功注册卡注册请求的请求编号。	整数

发送消息

组件使用 prebuilt_components_credit_card_enrollment:send_message 网络钩子发送一条消息，其中包含一个链接，供现有客户完成信用卡注册。

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 现在应该已设置完毕，可以进行测试了。