账号余额预构建组件

帐号余额预构建组件会检查客户的身份验证级别，然后向经过身份验证的客户提供帐号余额信息。如果客户有多个帐号，该组件会确认客户想要检索帐号余额的特定帐号。此组件使用预构建的 Authentication 组件对用户进行身份验证。

限制

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

该组件不加密任何数据。

示例对话框

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

一个账号

最终用户只有一个帐号，并收到帐号余额。

用户输入	代理响应
	代理使用 Authentication 预构建组件对用户进行身份验证
	谢谢，您已成功进行身份验证。
	我们正在获取您的帐号详细信息，请稍候。与尾号为 4567 的帐号相关联的余额为 50.00 美元。

多个账号

最终用户有多个帐号；代理会请求并确认帐号的最后四位数，并提供该帐号的帐号余额。

用户输入	代理响应
	代理使用 Authentication 预构建组件对用户进行身份验证
	谢谢，您已成功进行身份验证。
	我们正在获取您的账号详细信息，请稍候。我们发现有 2 个账号与您的电话号码关联。能否请您提供所指账号的最后 4 位数字？
2002
	我们获得的账号的最后四位数是 2002，对吗？
是
	与尾号为 2002 的帐号相关联的余额为 5000 美元。

多个具有上下文的账号

最终用户拥有多个帐号，引荐的帐号会保留之前的目的，与帐号余额一起提供。

用户输入	代理响应
	我们正在获取您的帐号详细信息，请稍候。我们发现有 3 个帐号与您的电话号码关联。您要查找尾号为 4567 的帐号吗？
是
	与尾号为 4567 的帐号关联的余额为 50 美元。

命名惯例

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

特征	形式	示例
流	[组件名称]	账号余额
组件专用 intent	prebuilt_components_[component_name]_[intent_name]	prebuilt_components_account_number_collection_four_digit_account_number
Webhook	prebuilt_components_[component_name]:[webhook_action]	prebuilt_components_account_balance:get_account_balance

输入参数

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

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

参数名称	说明	输入格式
$session.params.auth_level	（可选）指示调用方的身份验证级别。	整数
$session.params.auth_level_req	指明用户在访问其帐号余额之前所需的身份验证级别。此值在 `check auth level` 页面中页面条目执行方式的参数预设中配置。默认情况下，此值为 `1`。	整数
$session.params.account_auth_enabled	指明用户是否应该作为帐号持有人进行身份验证（如身份验证类型中所述）。此值在 `check auth level` 页面中页面条目执行方式的参数预设中配置。默认情况下，此值为 `true`。	boolean
$session.params.card_auth_enabled	用于指明用户是否应该以持卡人身份接受身份验证（如身份验证类型中所述）。此值在 `check auth level` 页面中页面条目执行方式的参数预设中配置。默认情况下，此值为 `false`。	boolean
$session.params.phone_number	（可选）用于验证身份的客户已注册手机号码。	字符串
$session.params.account_count	（可选）与经过身份验证的用户关联的帐号数量。	整数
$session.params.last_four_digit_of_account_number	（可选）需要提供余额的客户账号的后四位数字。如果客户只有一个帐号，系统会在身份验证后自动检索这些信息。如果客户有多个帐号，系统会从客户那里收集具体帐号。	字符串
$flow.max_retry_acc_number	指定收集最终用户账号的最后四位数时允许的重试次数。默认值为 `3`	整数

如需为此组件配置输入参数，请展开查看相关说明。

打开 Dialogflow CX 控制台。
选择您的 Google Cloud 项目。
选择您的代理。
选择 Build 标签页。
在流部分中点击导入的组件。
点击网页部分中的初始页。
点击初始页中的 true 路由。
在“路由”窗口中，根据需要修改参数预设值。
点击保存。

输出参数

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

参数名称	说明	输出格式
auth_level	指示调用方的身份验证级别。	整数
phone_number	用于识别用户的用户的本地手机号码（不含国家/地区代码）。	字符串
account_count	与注册的电话号码相关联的帐号数量。这些帐号包括自己的帐号和用户拥有委托书的帐号。	整数
last_four_digit_of_account_number	如果用户只有一个帐号，会返回该帐号的最后四位数。如果用户有多个帐号，此参数的值为用户选择用来接收帐号余额信息的帐号的后四位数字。	字符串
transfer_reason	此参数指示数据流退出的原因（如果失败的话）。返回值为以下值之一： `agent`：在对话期间的某个时间点，最终用户请求了人工客服。 `denial_of_information`：最终用户拒绝分享该组件请求的信息。 `max_no_input`：对话已达到无输入事件的重试次数上限。请参阅无输入内置事件。 `max_no_match`：对话已达到无匹配事件的重试次数上限。请参阅无匹配的内置事件。 `webhook_error`：发生了网络钩子错误。请参阅 webhook.error 内置事件。 `webhook_not_found`：无法访问网络钩子网址。请参阅 webhook.error.not-found 内置事件。	字符串

基本设置

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

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

网络钩子设置

为了使用此组件，您需要配置所包含的灵活网络钩子，以从外部服务中检索所需信息。

Authentication

如果您之前未配置过身份验证所需的外部服务，则需要对其进行配置，以便为此组件启用用户身份验证功能。如需查看详细说明，请参阅 Authentication 网络钩子设置。

验证账号

该组件使用 prebuilt_components_account_services:validate_account 网络钩子，根据用户的注册手机号码和所提供帐号的最后四位数来验证帐号是否存在。如果存在帐号，网络钩子还会返回帐号余额。

API 请求参数

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

参数名称	说明	输入格式
$session.params.phone_number	用于识别用户的用户的本地手机号码（不含国家/地区代码）。	字符串
$session.params.last_four_digit_of_account_number	用户选择并确认可接收账号余额信息的账号的后四位数。	字符串

API 响应参数

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

参数名称	说明	输出格式
account_found	指明用户的注册帐号是否存在提供后四位数字的帐号。	boolean
余额	相关账号的当前余额（如有）。	数字

如需为此组件配置“验证帐号”网络钩子，请展开查看相关说明。

打开 Dialogflow CX 控制台。
选择您的 Google Cloud 项目。
选择您的代理。
选择管理标签页。
点击 Webhook。
选择 build_components_account_services:validate_account 网络钩子。
将 Dialogflow 网络钩子网址字段中的网址替换为您要集成的服务的端点。从下拉菜单中选择合适的方法。
查看并更新请求正文，以构成网络钩子的正确请求格式。
查看并更新响应配置，以从 webhook 的响应中提取特定字段。请勿修改参数名称，因为组件必须使用这些参数名称才能访问返回的字段值。
查看并视需要更新 Authentication 设置。
点击保存。

完成

现在，您的代理及其 webhook 应该已设置完毕，可以开始测试了。

概览

账号对账单