问候语预构建组件

问候语预构建组件会检索来电者的电话号码 (ANI)（如果有）。如果检索到手机号码，该组件会执行 使用手机号码进行软身份验证，并根据已注册的 手机号码。然后，客服人员会根据最终用户的账号信息，向其发送个性化问候语。

限制

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

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

示例对话框

以下示例对话框展示了由此函数处理的常见场景 预构建组件。示例对话框演示了通过电话调用组件时的行为，这会触发默认欢迎 intent 并在对话开始时发出第一个客服人员回复。

经过身份验证的最终用户

根据呼叫号码识别最终用户，并接收个性化的 问候语。

用户输入	客服人员回复
	[Caller First Name]，您好！感谢您与 [公司名称] 联系，我们致力于帮助您改善财务状况。您今天需要什么帮助？

无法识别的最终用户

无法识别最终用户的呼叫号码，且最终用户会收到 标准问候语消息。

用户输入	客服人员回复
	感谢您与 [公司名称] 联系，我们致力于帮助您改善财务状况。您现在需要什么帮助？

命名规则

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

特征	格式	示例
流程	[组件名称]	问候语
参数	[param_name]	ani_auth
网络钩子	prebuilt_components_[component_name]:[webhook_action]	prebuilt_components_greeting:get_account_details

输入参数

输入参数是用于配置组件特定行为的参数。这些参数将会供 以确定组件的行为方式。必须在组件的开始页面上设置流程级范围的参数，如下所述。会话级范围的参数可以通过调用流程或在此组件的首页上设置。

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

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

若要配置此组件的输入参数，请展开即可查看相关说明。

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

输出参数

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

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

基本设置

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

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

网络钩子设置

要使用此组件，您需要配置包含的 灵活的网络钩子 从外部服务获取所需的信息

获取账号详情

该组件使用 prebuilt_components_greeting:get_account_details webhook 来使用来电者 ANI 来识别来电者。如果调用者的电话号码存在于配置的外部服务中，系统会检索用于个性化体验的相关信息，包括调用者姓名和电子邮件地址。

API 请求参数

该组件会将以下参数作为 API 请求的输入提供给 API 请求。

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

API 响应参数

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

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

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

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

完成

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