问候语预构建组件

问候语预建组件会检索来电者的手机号码 (ANI),如果可用的话。如果检索到手机号码,该组件会使用该手机号码进行软身份验证,并根据已注册的手机号码验证该手机号码。然后,代理会根据最终用户的账号信息,向其发送个性化的问候消息。

限制

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

  • 该组件假定客户手机号码保存在 CRM(客户关系管理)系统或其他服务中。
  • 使用备用手机号码联系的现有客户将无法通过此组件进行身份验证。

对话示例

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

经过身份验证的最终用户

系统会根据来电号码识别最终用户,并向其发送个性化的问候消息。

用户输入 智能体回答
[Caller First Name],您好。感谢您与 [公司名称] 联系,我们致力于为您提供优质的财务健康服务。您今天需要哪些方面的帮助?

无法识别的最终用户

系统无法识别最终用户的来电号码,并向最终用户显示标准问候消息。

用户输入 智能体回答
感谢您与 [公司名称] 联系,我们致力于为您提供优质的财务健康服务。您今天需要哪些方面的帮助?

命名规则

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

功能 格式 示例
Flow [组件名称] 问候语
参数 [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 请求的输入。

参数名称 说明 输出格式
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 网络钩子。
  7. 将 Dialogflow CX 网络钩子网址字段中的网址替换为您要集成的服务的端点。在下拉菜单中选择适当的方法
  8. 检查并更新请求正文,以形成适合您网络钩子的正确请求格式。
  9. 查看并更新响应配置,以从 Webhook 的响应中提取特定字段。请勿修改参数名称,因为组件需要这些名称才能访问返回的字段值。
  10. 根据需要查看并更新身份验证设置。
  11. 点击保存

完成

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