问候语预构建组件

问候语预构建组件会检索来电者的手机号码 (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. 选择构建标签页。
5. 点击流部分中的导入的组件。
6. 点击页面部分中的“首页”。
7. 点击“开始”页面中的 true 路线。
8. 在“路线”窗口中，根据需要修改参数预设值。
9. 点击保存。

输出参数

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

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

基本设置

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

1. 导入预构建组件。
2. 将提供的灵活 webhook 与您的外部服务配置在一起，请参阅下文中的 webhook 设置。

网络钩子设置

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

获取账号详情

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

API 请求参数

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

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

API 响应参数

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

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

如需为此组件配置“获取账号详情”Webhook，请展开相应部分查看说明。

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

完成

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