反馈预构建组件

反馈预构建组件用于收集最终用户的定量反馈和定性反馈。

该组件首先使用配置的检查上次反馈 webhook 执行查找，以检查该特定最终用户是否提供了最近的反馈。如果不存在近期反馈，该组件会要求用户提供 1 到 5 之间的定量反馈得分。如果反馈是负面的，则组件可以选择向用户收集自由格式的定性反馈。

限制

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

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

示例对话框

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

正面反馈

检查上次反馈 webhook 的响应表示最终用户最近未提供反馈。代理请求用户提供反馈评分，用户提供表示积极体验的评分。

用户输入	代理响应
	感谢您的来电。您的反馈对我们至关重要。请花点时间回答几个简短的问题，分享您对于今天获得的服务的看法。您对今天获得的服务的满意度如何？请按 1 到 5 分，其中 1 表示最不满意，5 表示最满意？
5
	太好了，感谢你的好评。

负面反馈

检查上次反馈 webhook 的响应表示最终用户最近未提供反馈。代理请求用户提供反馈评分，用户提供表示负面体验的评分。然后，代理会要求用户提供定性反馈。

用户输入	代理响应
	感谢您的来电。您的反馈对我们至关重要。请花点时间回答几个简短的问题，分享您对于今天获得的服务的看法。您对今天获得的服务的满意度如何？请按 1 到 5 分，其中 1 表示最不满意，5 表示最满意？
2
	请告诉我们如何可以为您改善这一体验。
我的一些问题没有得到彻底的回答。
	感谢您提供反馈。对于由此给您带来的不便，我们深表歉意，并努力让下次为您提供更好的体验。

近期反馈

检查上次反馈 webhook 的响应表示最终用户最近提供反馈，因此代理不会要求用户进一步输入。

用户输入	代理响应
	感谢您与我们联系。

输入无效

检查上次反馈 webhook 的响应表示最终用户最近未提供反馈。代理请求用户的反馈得分，并且用户多次提供无效输入。组件以失败结束流程。

用户输入	代理响应
	感谢您的来电。您的反馈对我们至关重要。请花点时间回答几个简短的问题，分享您对于今天获得的服务的看法。您对今天获得的服务的满意度如何？请按 1 到 5 分，其中 1 表示最不满意，5 表示最满意？
-1
	抱歉，无法识别你说的内容。请告诉我们反馈得分（1 分、2 分、3 分、4 分或 5 分）。
100
	抱歉，无法识别你说的内容。请告诉我们反馈得分（1 分、2 分、3 分、4 分或 5 分）。
不错
	抱歉，已超过最大重试次数。请稍后再试。

命名惯例

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

特征	形式	示例
流	[组件名称]	反馈
参数	[参数名称]	feedback_score
Webhook	prebuilt_components_[component_name]:[webhook_action]	prebuilt_components_feedback:last_feedback_check

输入参数

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

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

参数名称	说明	输入格式
$session.params.phone_number	用户的本地手机号码，用于在 API 请求中标识用户。手机号码不应包含国家/地区代码。	字符串
$flow.minimum_feedback_score	此参数表示正反馈得分的阈值。低分（等于或小于此参数的值）表示负面体验，高分（大于此参数的值）表示良好的体验。如果最终用户给出低分，则会要求用户提供定性反馈，询问其体验可以如何改进。此参数的默认值是 `3`。	整数
$flow.feedback_max_retry_count	这是一个可配置的参数，用于捕获为用户提供的最大重试次数。分配给此参数的值应比可用尝试次数少 1 次。默认值为 `2`，表示调用方将尝试三次，以提供请求的信息。	整数

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

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

输出参数

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

参数名称	说明	输出格式
feedback_score	此参数会捕获最终用户提供的反馈得分。有效值为 1 到 5（包括 1 和 5）之间的整数。	整数
feedback_comment	此参数会捕获最终用户提供的定性评论（如果有）。	字符串
transfer_reason	此参数表示流程退出的原因（如果失败的话）。返回值为以下值之一： `agent`：最终用户在对话期间的某个时刻请求人工客服。 `denial_of_information`：最终用户拒绝分享该组件请求的信息。 `max_no_input`：对话已达到无输入事件的重试次数上限。请参阅无输入内置事件。 `max_no_match`：对话已达到非匹配事件的重试次数上限。请参阅无匹配的内置事件。 `webhook_error`：发生网络钩子错误。请参阅 webhook.error 内置事件。 `webhook_not_found`：某个网络钩子网址无法访问。请参阅 webhook.error.not-found 事件。	字符串

基本设置

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

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

网络钩子设置

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

查看上次反馈

该组件使用 prebuilt_components_feedback:last_feedback_check 网络钩子来检查用户最近是否提供了反馈。之前提供的反馈被视为最新反馈的时间段由与此 webhook 集成的外部服务定义，可由服务所有者配置。

API 请求参数

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

参数名称	说明	输入格式
phone_number	用户的本地手机号码（不含国家/地区代码），用于识别用户。	整数

API 响应参数

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

参数名称	说明	输出格式
last_feedback_time_elapsed	指明用户最近是否提供了反馈。`true` 表示自用户上次提供反馈以来经过了一段时间，但未找到最近的反馈。`false` 表示最近提供了反馈，自用户上次提供反馈以来未过多长时间。	boolean

如需为此组件配置“检查上次反馈”网络钩子，请展开查看相关说明。

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

更新反馈

该组件使用 prebuilt_components_feedback:update_feedback 网络钩子将收集的反馈发送到外部服务。

API 请求参数

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

参数名称	说明	输入格式
phone_number	用户的本地手机号码（不含国家/地区代码），用于识别用户。	字符串
feedback_score	此参数会存储最终用户提供的反馈得分。预期值是 1 到 5（包括 1 和 5）之间的整数。	整数
feedback_comment	此参数用于存储最终用户提供的定性反馈评论。	字符串

如需为此组件配置更新反馈网络钩子，请展开查看相关说明。

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

完成

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

异议

金融服务导向