优惠和优惠预构建组件

优惠和优惠预构建组件会检查调用方是否为注册用户。如果用户有注册帐号，该组件可以提供有关用户专属优惠的信息。用户还可以获取有关一般优惠和特惠的详细信息，或报告特定优惠券代码相关问题。此组件使用 字母数字集合预构建组件来收集优惠券代码。该组件还使用生成器生成通话后摘要、常见问题解答和优惠详情。

限制

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

  • 此组件不会对任何数据进行加密。

示例对话框

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

特定于用户的优惠和常规优惠和特惠

最终用户之前已经过身份验证。用户询问他们的最新优惠，代理提供特定于用户的优惠列表。用户询问一些有关优惠的问题，然后询问特定类别的优惠。代理会显示该类别中的优惠列表。代理提出将优惠详情发送给用户，但用户拒绝了。

用户输入 代理响应
欢迎！您是想了解我们的最新优惠，还是在使用特定优惠券代码时遇到了问题？
我想查看最新优惠
确认一下，您正在查找优惠。是这样吗？
是
我们发现了以下优惠，详情如下：
优惠 1：购买服装可享 5 折优惠，使用优惠码 APPARELS5，有效期至 2024 年 3 月 28 日。
优惠 2：使用优惠码 GROCERY500 购买食品杂货可享八五折优惠，优惠截止到 2024 年 3 月 28.8 日。

希望您感兴趣。
您是否有任何关于优惠或特惠的问题需要我们为您解答？
这项杂货优惠有最低购买金额要求吗？
是的，有最低购买金额为 10 时，杂货店可享八五折优惠。使用代码 GROCERY500 兑换此优惠，有效期至 2024 年 3 月 28 日。

我们希望能够为您提供所需的详细信息。您是否有任何关于优惠或特惠的问题需要我们为您解答？
你们有电子产品优惠吗？
当然可以！优惠详情如下：
优惠 1：使用优惠码 ELECTRIC5 购买电子产品，享受 5 折优惠，有效期至 2024 年 3 月 28 日。
优惠 2：使用优惠码 ELECTRIC15 购买电子产品可享八五折优惠，有效期至 2024 年 3 月 28 日。

我们希望能为您提供相关详细信息。您是否有任何关于优惠或特惠的问题需要我们为您解答？
不，我没问题了
您希望通过您注册的手机号码或电子邮件地址分享优惠详情吗？
不用了
感谢您的来电。

优惠券代码存在问题

最终用户之前已经过身份验证。用户提到他们无法使用优惠券代码。代理会收集优惠券代码，并向用户提供有关优惠券代码兑换的详细信息。用户确认他们无法使用优惠券代码，然后代理提交工单来报告问题。

用户输入 代理响应
欢迎！您是想了解我们的最新优惠，还是在使用特定优惠券代码时遇到了问题？
我遇到了优惠券代码方面的问题
确认一下，您正在查找优惠券代码。是这样吗？
是
我们对此深感抱歉。能否请您分享一下您正在使用的优惠券代码？
代理使用 Alphanumeric collection 预构建组件收集优惠券代码
与服装关联的优惠代码 APPARELS5 需要最低购买金额为 100 美元，有效期至 2024 年 3 月 28 日。请确保满足最低购买要求等条件。

此信息对您有帮助吗？
无
请指明您遇到的问题。您可能会这样说：我的优惠券代码无效，代码在我所在的地区无效。
优惠券代码无法使用
确认一下，您提供的优惠券代码问题是优惠券代码无效。是这样吗？
是
我们已经提交了工单，以便报告您的问题。感谢您的来电。

命名惯例

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

特征 形式 示例
流 [组件名称] 优惠和特惠
实体类型 prebuilt_components_[component_name]_[entity_type] prebuilt_components_offers_and_deals_category
Webhook 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 网络钩子返回的 coupon_code_status 字段的值，用于表明优惠券代码有效。默认值为 "valid"。 字符串
$flow.invalid_coupon_code_status 指定 get_coupon_code_details 网络钩子返回的 coupon_code_status 字段的值，用于指明优惠券代码无效。默认值为 "invalid"。 字符串
$flow.expired_coupon_code_status 指定 get_coupon_code_details 网络钩子返回的 coupon_code_status 字段的值，用于表明优惠券代码已过期。默认值为 "expired"。 字符串

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

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

输出参数

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

参数名称 说明 输出格式
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 生成器用于处理与折扣、销售、购买和会员回馈活动相关的常见问题。

  • 如果我改变了主意，可以退货商品吗？
  • 购买特定商品时可以免费获得样品或礼品吗？
  • 如果我购买的商品在晚些时候促销，Google 是否会提供价格调整？
  • 会员回馈活动奖励的兑换是否有时间限制？

特定于用户的优惠详情

User-specific offer details 生成器用于根据 get_offers_details 网络钩子提供的信息，提供有关用户专属优惠的详细信息。

优惠和特惠详情

Offers and deals details 生成器用于根据 get_offers_details 网络钩子提供的信息，提供有关常规优惠和特惠的详细信息。用户可以询问特定类别的优惠，也可以询问有关特定优惠的更多详细信息。

优惠和特惠常见问题解答

Offers and deals FAQ 生成器用于处理与优惠和特惠相关的常见问题。

  • 新客户是否有特别优惠？
  • 如何接收有关即将进行的特惠的通知？
  • 是否有仅限实体店或线上的特惠？
  • 新特惠多久添加到您的平台？

折扣和促销代码常见问题解答

Discount and promo code FAQ 用于处理与折扣和促销代码相关的常见问题。

  • 我可以多次使用一个折扣代码吗？
  • 我可以对一个订单使用多项折扣吗？
  • 如何在结账时兑换折扣代码？
  • 如果我在结账时忘记应用折扣代码，该怎么办？

基本设置

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

  1. 导入预构建组件。
  2. 使用描述 Dialogflow 外部服务的配置来配置所提供的灵活 webhook，请参阅网络钩子设置。

网络钩子设置

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

获取优惠详情

该组件使用 prebuilt_components_offers_and_deals:get_offers_details 网络钩子来检索有关用户专属优惠和常规优惠的详细信息。

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 字段相同的格式。 列表（对象）

如需为此组件配置“获取优惠详情”网络钩子，请展开查看相关说明。

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

获取优惠券代码详情

该组件使用 prebuilt_components_offers_and_deals:get_coupon_code_details 网络钩子来检索有关用户报告相关问题的特定优惠券代码的详细信息。

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 优惠券代码的最低订单金额。 字符串

若要为此组件配置“获取优惠券代码详情”网络钩子，请展开查看相关说明。

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

发送消息

该组件会使用 prebuilt_components_offers_and_deals:send_message 网络钩子向用户所选频道发送包含优惠详情的消息。

API 请求参数

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

参数名称 说明 输入格式
$session.params.phone_number 用户的本地手机号码（不含国家/地区代码），用于识别用户。 字符串
$flow.confirmation_channel 用户选择用来接收优惠详情的频道。有效值由 prebuilt_components_channel_email_phone 实体定义。 字符串

如需为此组件配置“发送消息”网络钩子，请展开查看相关说明。

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

提交工单

该组件使用 prebuilt_components_offers_and_deals:raise_ticket 网络钩子提交工单，报告用户使用优惠券代码的问题。

API 请求参数

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

参数名称 说明 输入格式
$session.params.phone_number 用户的本地手机号码（不含国家/地区代码），用于识别用户。 字符串
$flow.coupon_code 用户已报告相关问题的优惠券代码。 字符串
$flow.offer_id 所提供优惠券代码的优惠 ID。 字符串
$flow.coupon_code_issue 用户提供的优惠券代码问题。 字符串

如需为此组件配置“提交工单”网络钩子，请展开查看相关说明。

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

完成

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