Greeting 预构建组件

问候语预构建组件会检索来电者的手机号码 (ANI)（如果有）。如果检索到该手机号码，该组件会使用该手机号码执行软身份验证，根据已注册的手机号码进行验证。然后，代理会根据最终用户的帐号信息向其显示个性化消息问候。

限制

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

• 该组件假定客户手机号码保存在 CRM（客户关系管理）系统或其他服务中。
• 此组件不会对使用备用手机号码的现有客户进行身份验证。

示例对话框

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

经过身份验证的最终用户

根据主叫号码来识别最终用户，并接收个性化的问候消息。

用户输入	代理响应
	[Caller First Name]，您好！感谢您与 [Company Name]联系，我们致力于保护您的财务健康。请问您需要什么帮助？

最终用户无法识别

系统不会识别最终用户的呼叫号码，且会向最终用户显示标准问候消息。

用户输入	代理响应
	感谢您与 [Company Name]联系，我们致力于保护您的财务健康。请问您需要什么帮助？

命名惯例

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

特征	形式	示例
流	[组件名称]	问候语
参数	[param_name]	ani_auth
Webhook	prebuilt_components_[component_name]:[webhook_action]	prebuilt_components_greeting:get_account_details

输入参数

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

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

参数名称	说明	输入格式
$flow.company_name	捕获将在 Greeting 提示中动态使用的公司名称。	字符串

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

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

输出参数

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

参数名称	说明	输出格式
ani_auth	此参数会捕获基于 ANI 的身份验证的结果。默认情况下，值为 false。	boolean
auth_level	指示调用方的身份验证级别。默认情况下，该值为 null。-1 表示用户未通过其 ANI 进行身份验证。0 表示 ANI 身份验证成功。	整数

基本设置

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

1. 导入预构建组件。
2. 使用外部服务配置提供的灵活网络钩子，请参阅下面的网络钩子设置。

网络钩子设置

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

获取账号详情

该组件使用 prebuilt_components_greeting:get_account_details 网络钩子，通过其 ANI 识别调用方。如果配置的外部服务中存在来电者的手机号码，则系统将检索相关信息（包括来电者姓名和电子邮件地址）来打造个性化体验。

API 请求参数

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

参数名称	说明	输出格式
phone_number	来电者的手机号码 (ANI)	整数

API 响应参数

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

参数名称	说明	输出格式
user_first_name	最终用户的名字，用于提供个性化问候语。	字符串

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

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

完成

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