优惠和特惠预构建组件会检查调用方是否为注册用户。如果用户拥有注册账号，该组件可以提供有关用户专属优惠和特惠的信息。用户还可以详细了解常规优惠和特惠，或报告特定优惠券代码存在的问题。此组件使用字母数字集合预构建组件来收集优惠券代码。该组件还使用生成器生成通话后摘要、常见问题解答和商品详情。
限制
除了常见的预构建组件限制之外，此预构建组件还存在以下限制：
- 此组件不会加密任何数据。
对话框示例
以下示例对话框演示了此预构建组件处理的常见场景。示例对话框演示了使用电话功能调用组件时的行为，该功能会在对话开始时触发默认欢迎 intent 和第一个客服人员响应。
面向特定用户和面向所有用户的优惠和特惠
最终用户之前已通过身份验证。用户询问最新的优惠，客服人员会显示专门针对该用户的优惠列表。用户询问一些有关优惠的问题，然后询问特定类别的优惠。客服人员会显示该类别中的优惠列表。客服人员提出向用户发送优惠详情，但用户拒绝了。
| 用户输入 | 客服人员回复 |
|---|---|
| 欢迎！您想了解我们最新的优惠活动吗？或者您在使用特定优惠券代码时遇到了问题吗？ | |
| 我想查看最新优惠 | |
| 确认一下，您要查找优惠。对吗？ | |
| 是 | |
| 我们为您找到了以下优惠，具体如下： 优惠 1：使用代码 APPARELS5 购买服装可享 5 折优惠，有效期至 2024 年 3 月 28 日。 优惠 2：使用代码 GROCERY500 购买日杂可享 8.5 折优惠，有效期至 2024 年 3 月 28 日。 希望您能对这些优惠感兴趣。您对优惠或特惠有任何疑问吗？我们可以为您解答。 |
|
| 杂货优惠是否设有最低购买金额？ | |
| 是的，购买金额必须达到 10 美元才能享受 85 折优惠。使用代码 GROCERY500 即可兑换此优惠，此代码的有效期为 2024 年 3 月 28 日。 我们希望能够为您提供所需的详细信息。您对优惠或特惠有任何疑问吗？我们可以为您解答。 |
|
| 您有电子产品优惠吗？ | |
| 当然可以！ 优惠详情如下： 优惠 1：使用代码 ELECTRIC5 可享 5% 的电子产品折扣，有效期至 2024 年 3 月 28 日。 优惠 2：使用代码 ELECTRIC15 可享 15% 的电子产品折扣，有效期至 2024 年 3 月 28 日。 我们希望能为您提供所需的详细信息。您对优惠或特惠有任何疑问吗？我们可以为您解答。 |
|
| 不用了，我没问题了 | |
| 您是否希望将优惠详情分享到您注册的手机号或电子邮件地址？ | |
| 不用了 | |
| 感谢您的来电。 |
优惠券代码存在问题
最终用户之前已通过身份验证。用户提到自己遇到了优惠券代码问题。客服人员会收集优惠券代码，并向用户提供有关优惠券代码兑换的详细信息。用户确认自己遇到了优惠券代码问题，客服人员提交工单来报告该问题。
| 用户输入 | 客服人员回复 |
|---|---|
| 欢迎！您想了解我们最新的优惠活动吗？或者您在使用特定优惠券代码时遇到了问题吗？ | |
| 我遇到了优惠券代码方面的问题 | |
| 确认一下，您要查找优惠券代码。对吗？ | |
| 是 | |
| 得知您遇到问题，我们深感抱歉。能否请您提供您使用的优惠券代码？ | |
| 代理使用字母数字集合预构建组件收集优惠券代码 | |
| 与服装相关联的优惠代码 APPARELS5 的最低购买金额为 100 美元，有效期至 2024 年 3 月 28 日，请确保满足最低购买金额等条件。 这些信息对您是否有帮助？ |
|
| 否 | |
| 请指明您遇到的问题。您可以这样说：“我的优惠券代码无效”“代码在我所在地区无效”。 | |
| 优惠券代码无法使用 | |
| 确认一下，您提供的优惠券代码问题是优惠券代码无效。对吗？ | |
| 是 | |
| 我们已创建工单来报告您的问题。感谢您的来电。 |
命名规则
此预构建组件使用以下命名惯例：
| 功能 | 格式 | 示例 |
|---|---|---|
| 流程 | [组件名称] | 优惠和特惠 |
| 实体类型 | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_offers_and_deals_category |
| 网络钩子 | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_offers_and_deals:get_offers_details |
输入参数
输入参数是用于配置组件特定行为的参数。流程中一个或多个条件将使用这些参数来确定组件的行为方式。必须在组件的起始页面上设置流程级范围的参数。会话级范围的参数可以通过调用流程或在此组件的首页上设置。
此预构建组件接受以下输入参数：
| 参数名称 | 说明 | 输入格式 |
|---|---|---|
| $session.params.phone_number | （可选）用户的本地手机号码（不含国家/地区代码），用于识别用户。 | 字符串 |
此预构建组件允许使用以下可选参数来配置组件的行为，包括重试。
| 参数名称 | 说明 | 格式 |
|---|---|---|
| $flow.max_retry_concern_type | 指定在选择用户是否想听取优惠信息或报告优惠券代码问题时允许的重试次数。默认值为 2。 |
整数 |
| $flow.max_retry_offers_category | 指定提供要收听优惠的类别时允许的重试次数。默认值为 2。 |
整数 |
| $flow.max_retry_another_coupon_code | 指定在提供用户遇到问题的特定优惠券代码时允许的重试次数。默认值为 2。 |
整数 |
| $flow.max_retry_coupon_code_issue_counter | 指定在提供用户遇到的优惠券代码问题时允许的重试次数。默认值为 2。 |
整数 |
| $flow.max_retry_message_confirm_channel | 指定提供用于接收商品详情的渠道时允许的重试次数。默认值为 2。 |
整数 |
| $flow.valid_coupon_code_status | 指定 get_coupon_code_details webhook 返回的 coupon_code_status 字段的值，表示优惠券代码有效。默认值为 "valid"。 |
字符串 |
| $flow.invalid_coupon_code_status | 指定 get_coupon_code_details webhook 返回的 coupon_code_status 字段的值，用于指示优惠券代码无效。默认值为 "invalid"。 |
字符串 |
| $flow.expired_coupon_code_status | 指定 get_coupon_code_details webhook 返回的 coupon_code_status 字段的值，表示优惠券代码已过期。默认值为 "expired"。 |
字符串 |
如需为此组件配置输入参数，请展开相应部分查看说明。
- 打开 Dialogflow CX 控制台。
- 选择您的 Google Cloud 项目。
- 选择您的代理。
- 选择构建标签页。
- 点击流部分中的导入的组件。
- 点击页面部分中的“首页”。
- 点击“开始”页面中的 true 路线。
- 在“路线”窗口中，根据需要修改参数预设值。
- 点击保存。
输出参数
输出参数是会话参数，会在退出组件后保持有效状态。这些参数包含组件收集的重要信息。此预构建组件会为以下输出参数提供值：
| 参数名称 | 说明 | 输出格式 |
|---|---|---|
| phone_number | 用户的本地手机号码（不含国家/地区代码），用于识别用户。 | 字符串 |
| transfer_reason | 如果流程未成功，此参数会指明流程退出的原因。返回的值如下：agent：最终用户在对话过程中的某个时间点请求了人工客服。denial_of_information：最终用户拒绝分享组件请求的信息。max_no_input：对话达到了无输入事件的最大重试次数。请参阅无输入内置事件。max_no_match：对话达到了无匹配事件的最大重试次数。请参阅无匹配内置事件。webhook_error：发生了网络钩子错误。请参阅 webhook.error 内置事件。webhook_not_found：无法访问某个网络钩子网址。请参阅 webhook.error.not-found 内置事件。 |
字符串 |
生成器
此组件使用生成器来启用对话的特定部分。
摘要
Summarization 生成器用于生成通话后摘要，用于描述组件处理的对话。
常规常见问题解答
General FAQ 生成器用于处理与折扣、促销、购买和会员回馈活动相关的常见问题。
- 如果我改变主意，可以退回促销商品吗？
- 购买某些商品时，我可以获得免费的样品或赠品吗？
- 如果我购买的商品日后降价，可以申请价格调整吗？
- 会员回馈活动奖励是否有兑换期限？
特定于用户的优惠详情
User-specific offer details 生成器用于根据 get_offers_details
webhook 提供的信息，提供有关特定用户的优惠的详细信息。
优惠和特惠详情
Offers and deals details 生成器用于根据 get_offers_details
webhook 提供的信息提供有关常规优惠和特惠的详细信息。用户可以询问特定类别的优惠，也可以询问特定优惠的更多详细信息。
优惠和特惠常见问题解答
Offers and deals FAQ 生成器用于处理与商品和特惠相关的常见问题。
- 新客户有没有专属优惠？
- 如何收到即将推出的优惠的通知？
- 是否有仅在实体店或线上提供的优惠？
- 您的平台多久会添加一次新特惠？
折扣和促销代码常见问题解答
Discount and promo code FAQ 用于处理与折扣和促销代码相关的常见问题。
- 折扣代码可以多次使用吗？
- 我可以在一个订单中使用多种折扣吗？
- 如何在结账时兑换折扣代码？
- 如果我在结账时忘记应用折扣代码，该怎么办？
基本设置
如需设置此预构建组件，请执行以下操作：
- 导入预构建组件。
- 使用描述外部服务的配置配置提供的灵活的 Webhook，请参阅 Webhook 设置。
网络钩子设置
如需使用此组件，您需要配置随附的灵活的 Webhook，以从外部服务检索所需信息。
获取优惠详情
该组件使用 prebuilt_components_offers_and_deals:get_offers_details Webhook 检索有关用户专属优惠和通用优惠的详细信息。
API 请求参数
该组件会将以下参数作为 API 请求的输入提供给 API 请求。
| 参数名称 | 说明 | 输入格式 |
|---|---|---|
| $session.params.phone_number | 要检索优惠详情的电话号码。 | 字符串 |
API 响应参数
系统会从 API 响应中提取以下参数，以供组件使用。
| 参数名称 | 说明 | 输出格式 |
|---|---|---|
| active_category | 可供用户选择的优惠类别列表。有效值由 prebuilt_components_offers_and_deals_category 实体定义。 |
列表（字符串） |
| user_email | 注册所提供账号的电子邮件地址，用于发送优惠详情。 | 字符串 |
| user_offer | 特定于用户的优惠详情列表。列表中的每个元素代表一件商品，其中键值对用于描述商品的不同属性，例如 {"valid_from": "2024-01-29", "sale_type": "none", "valid_until": "2024-03-28", "offer_id": "G5E0M2D7A6Y4W9S", "discount_value": "5%", "coupon_code": "ELECTRIC5", "is_redeem_allowed": "true", "minimum_order_value": "1000", "maximum_discount_amount": "200", "offer_category_name": "electronics"}。 |
列表（对象） |
| all_offers | 常规优惠详情列表。列表中的每个元素都表示一个商品，其格式与 user_offer 字段相同。 |
列表（对象） |
如需为此组件配置“获取商品详情”Webhook，请展开相应部分查看说明。
- 打开 Dialogflow CX 控制台。
- 选择您的 Google Cloud 项目。
- 选择您的代理。
- 选择管理标签页。
- 点击网络钩子。
- 选择 prebuilt_components_offers_and_deals:get_offers_details webhook。
- 将“对话式 AI 助理 (Dialogflow CX)”的 Webhook 网址字段中的网址替换为您要集成的服务的端点。在下拉菜单中选择适当的方法。
- 查看并更新请求正文，为您的网络钩子构成正确的请求格式。
- 查看并更新响应配置，以从您的 webhook 响应中提取特定字段。请勿修改参数名称，因为组件需要这些名称才能访问返回的字段值。
- 根据需要查看并更新身份验证设置。
- 点击保存。
获取优惠券代码详情
该组件使用 prebuilt_components_offers_and_deals:get_coupon_code_details Webhook 来检索用户报告存在问题的特定优惠券代码的详细信息。
API 请求参数
该组件会将以下参数作为 API 请求的输入提供给 API 请求。
| 参数名称 | 说明 | 输入格式 |
|---|---|---|
| $flow.coupon_code | 要检索详细信息的优惠券代码。 | 字符串 |
| $session.params.phone_number | 与用户账号关联的电话号码。 | 字符串 |
API 响应参数
系统会从 API 响应中提取以下参数，以供组件使用。
| 参数名称 | 说明 | 输出格式 |
|---|---|---|
| offer_id | 优惠券代码的优惠 ID。 | 字符串 |
| offer_category_name | 优惠券代码的类别。有效值由 prebuilt_components_offers_and_deals_category 实体定义。 |
字符串 |
| coupon_code_status | 优惠券代码的状态。有效值由 $flow.valid_coupon_code_status、$flow.invalid_coupon_code_status 和 $flow.valid_coupon_code_status 输入参数定义。 |
字符串 |
| valid_until | 优惠券代码的有效期截止日期，采用 YYYY-MM-DD 格式。 |
字符串 |
| minimum_order_value | 优惠券代码的最低订单金额。 | 字符串 |
如需为此组件配置“获取优惠券代码详情”Webhook，请展开相应部分查看说明。
- 打开 Dialogflow CX 控制台。
- 选择您的 Google Cloud 项目。
- 选择您的代理。
- 选择管理标签页。
- 点击网络钩子。
- 选择 prebuilt_components_offers_and_deals:get_coupon_code_details webhook。
- 将“对话式 AI 助理 (Dialogflow CX)”的 Webhook 网址字段中的网址替换为您要集成的服务的端点。在下拉菜单中选择适当的方法。
- 查看并更新请求正文，为您的网络钩子构成正确的请求格式。
- 查看并更新响应配置，以从您的 webhook 响应中提取特定字段。请勿修改参数名称，因为组件需要这些名称才能访问返回的字段值。
- 根据需要查看并更新身份验证设置。
- 点击保存。
发送消息
该组件使用 prebuilt_components_offers_and_deals:send_message webhook 向用户选择的渠道发送包含商品详情的消息。
API 请求参数
该组件会将以下参数作为 API 请求的输入提供给 API 请求。
| 参数名称 | 说明 | 输入格式 |
|---|---|---|
| $session.params.phone_number | 用户的本地手机号码（不含国家/地区代码），用于识别用户。 | 字符串 |
| $flow.confirmation_channel | 用户选择接收优惠详情的渠道。有效值由 prebuilt_components_channel_email_phone 实体定义。 |
字符串 |
如需为此组件配置“发送消息”Webhook，请展开相应部分查看相关说明。
- 打开 Dialogflow CX 控制台。
- 选择您的 Google Cloud 项目。
- 选择您的代理。
- 选择管理标签页。
- 点击网络钩子。
- 选择 prebuilt_components_offers_and_deals:send_message webhook。
- 将“对话式 AI 助理 (Dialogflow CX)”的 Webhook 网址字段中的网址替换为您要集成的服务的端点。在下拉菜单中选择适当的方法。
- 查看并更新请求正文，为您的网络钩子构成正确的请求格式。
- 查看并更新响应配置，以从您的 webhook 响应中提取特定字段。请勿修改参数名称，因为组件需要这些名称才能访问返回的字段值。
- 根据需要查看并更新身份验证设置。
- 点击保存。
提交工单
该组件使用 prebuilt_components_offers_and_deals:raise_ticket webhook 提交工单，以报告用户的优惠券代码问题。
API 请求参数
该组件会将以下参数作为 API 请求的输入提供给 API 请求。
| 参数名称 | 说明 | 输入格式 |
|---|---|---|
| $session.params.phone_number | 用户的本地手机号码（不含国家/地区代码），用于识别用户。 | 字符串 |
| $flow.coupon_code | 用户报告存在问题的优惠券代码。 | 字符串 |
| $flow.offer_id | 所提供优惠券代码的优惠 ID。 | 字符串 |
| $flow.coupon_code_issue | 用户提供的优惠券代码问题。 | 字符串 |
如需为此组件配置“创建工单”Webhook，请展开相应部分查看相关说明。
- 打开 Dialogflow CX 控制台。
- 选择您的 Google Cloud 项目。
- 选择您的代理。
- 选择管理标签页。
- 点击网络钩子。
- 选择 rebuilt_components_offers_and_deals:raise_ticket webhook。
- 将“对话式 AI 助理 (Dialogflow CX)”的 Webhook 网址字段中的网址替换为您要集成的服务的端点。在下拉菜单中选择适当的方法。
- 查看并更新请求正文，为您的网络钩子构成正确的请求格式。
- 查看并更新响应配置，以从您的 webhook 响应中提取特定字段。请勿修改参数名称，因为组件需要这些名称才能访问返回的字段值。
- 根据需要查看并更新身份验证设置。
- 点击保存。
完成
您的客服人员及其网络钩子现在应该已设置完毕，可以进行测试了。