优惠和促销活动预构建组件会检查来电者是否为注册用户。如果用户拥有已注册的账号，该组件可以提供有关用户专属优惠和特惠的信息。用户还可以获取有关一般优惠和特惠活动的详细信息，或报告特定优惠券代码的问题。此组件使用字母数字集合预构建组件来收集优惠券代码。该组件还使用生成器来提供通话后摘要、常见问题解答和优惠详情。
限制
除了常见的预构建组件限制之外，此预构建组件还具有以下限制：
- 此组件不会加密任何数据。
对话示例
以下示例对话展示了此预构建组件处理的常见场景。示例对话演示了使用电话服务调用组件时的行为，这会在对话开始时触发默认欢迎 intent 和第一个代理响应。
用户专属和通用优惠及特惠
最终用户之前已通过身份验证。用户询问最新优惠，智能体便会列出针对该用户的优惠。用户询问了一些关于优惠的问题，然后要求提供特定类别的优惠。智能体展示该类别中的优惠列表。代理提出向用户发送优惠详情，用户拒绝。
| 用户输入 | 智能体回答 |
|---|---|
| 欢迎！您是想了解我们的最新优惠，还是在使用特定优惠券代码时遇到了问题？ | |
| 我想查看最新优惠 | |
| 确认一下，您是在寻找优惠吗？对吗？ | |
| 是 | |
| 我们为您找到了以下优惠，详情如下： 优惠 1：服装享 5% 折扣，使用代码 APPARELS5，有效期至 2024 年 3 月 28 日。 优惠 2：杂货享 15% 折扣，使用代码 GROCERY500，有效期至 2024 年 3 月 28 日。 希望您对这些优惠感兴趣。您对优惠或折扣有任何疑问吗？我们可以为您解答。 |
|
| 杂货优惠有最低购买金额要求吗？ | |
| 是的，最低消费金额为 10 元，即可享受杂货 15% 的折扣。请使用代码 GROCERY500 兑换此优惠，有效期至 2024 年 3 月 28 日。 希望我们能为您提供所需的详细信息。您对优惠或折扣有任何疑问吗？我们可以为您解答。 |
|
| 你们有电子产品优惠吗？ | |
| 当然可以！ 以下是优惠详情： 优惠 1：购买电子产品可享 5% 的折扣，请使用代码 ELECTRIC5，有效期至 2024 年 3 月 28 日。 优惠 2：购买电子产品可享 15% 的折扣，请使用代码 ELECTRIC15，有效期至 2024 年 3 月 28 日。 希望这些信息对您有所帮助。您对优惠或折扣有任何疑问吗？我们可以为您解答。 |
|
| 不用了 | |
| 您希望通过注册的手机号还是邮箱接收优惠详情？ | |
| 不用了 | |
| 感谢您的来电。 |
优惠券代码问题
最终用户之前已通过身份验证。用户提到优惠券代码存在问题。智能体会收集优惠券代码，并向用户提供有关优惠券代码兑换的详细信息。用户确认其优惠券代码存在问题，客服人员提交工单报告该问题。
| 用户输入 | 智能体回答 |
|---|---|
| 欢迎！您是想了解我们的最新优惠，还是在使用特定优惠券代码时遇到了问题？ | |
| 我遇到了优惠券代码方面的问题 | |
| 确认一下，您是在寻找优惠券代码吗？对吗？ | |
| 是 | |
| 我们对此深感抱歉。能否请您分享您使用的优惠券代码？ | |
| 代理使用字母数字集合预构建组件收集优惠券代码 | |
| 与服装相关的优惠代码 APPARELS5 需要满足最低购买金额 100 美元的要求，且有效期至 2024 年 3 月 28 日，请确保满足最低购买金额要求等条件。 这些信息对您有帮助吗？ |
|
| 否 | |
| 请指明您遇到的问题。您可以说“我的优惠券代码无法使用”“代码在我的地区无法使用”之类的话。 | |
| 优惠券代码无法使用 | |
| 为确认起见，您提供的优惠券代码问题是优惠券代码无效。是这样吗？ | |
| 是 | |
| 我们已创建工单来报告您的问题。感谢您的来电。 |
命名规则
此预构建组件使用以下命名惯例：
| 功能 | 格式 | 示例 |
|---|---|---|
| Flow | [Component Name] | 优惠和特惠 |
| 实体类型 | 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 项目。
- 选择您的代理。
- 选择构建标签页。
- 在流部分中点击导入的组件。
- 点击页面部分中的“Start Page”。
- 点击“Start Page”中的 true 路由。
- 在“路线”窗口中，根据需要修改参数预设值。
- 点击保存。
输出参数
输出参数是在退出组件后仍保持有效状态的会话参数。这些参数包含组件收集的重要信息。此预构建组件会为以下输出参数提供值：
| 参数名称 | 说明 | 输出格式 |
|---|---|---|
| phone_number | 用户的本地手机号码（不含国家/地区代码），用于识别用户。 | 字符串 |
| transfer_reason | 此参数表示流程退出（如果未成功）的原因。返回的值为以下值之一：agent：最终用户在对话期间的某个时间点请求了人工客服。denial_of_information：最终用户拒绝分享组件请求的信息。max_no_input：对话达到了无输入事件的最大重试次数。请参阅无输入内置事件。max_no_match：对话达到了无匹配事件的重试次数上限。请参阅不匹配内置事件。webhook_error：发生了 webhook 错误。请参阅 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 请求的输入。
| 参数名称 | 说明 | 输入格式 |
|---|---|---|
| $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"}。 |
List（对象） |
| all_offers | 一般优惠详情列表。列表中的每个元素都代表一个优惠，其格式与 user_offer 字段相同。 |
List（对象） |
如需为此组件配置“获取优惠详情”Webhook，请展开查看说明。
- 打开 Dialogflow CX 控制台。
- 选择您的 Google Cloud 项目。
- 选择您的代理。
- 选择管理标签页。
- 点击 Webhooks。
- 选择 prebuilt_components_offers_and_deals:get_offers_details webhook。
- 将 Dialogflow CX 网络钩子网址字段中的网址替换为您要集成的服务的端点。在下拉菜单中选择适当的方法。
- 查看并更新请求正文，为您的 webhook 形成正确的请求格式。
- 查看并更新响应配置，以从 webhook 的响应中提取特定字段。请勿修改参数名称，因为组件需要这些名称来访问返回的字段值。
- 根据需要查看并更新身份验证设置。
- 点击保存。
获取优惠券代码详情
组件会使用 prebuilt_components_offers_and_deals:get_coupon_code_details webhook 来检索用户报告有问题的特定优惠券代码的详细信息。
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 项目。
- 选择您的代理。
- 选择管理标签页。
- 点击 Webhooks。
- 选择 prebuilt_components_offers_and_deals:get_coupon_code_details 网络钩子。
- 将 Dialogflow CX 网络钩子网址字段中的网址替换为您要集成的服务的端点。在下拉菜单中选择适当的方法。
- 查看并更新请求正文，为您的 webhook 形成正确的请求格式。
- 查看并更新响应配置，以从 webhook 的响应中提取特定字段。请勿修改参数名称，因为组件需要这些名称来访问返回的字段值。
- 根据需要查看并更新身份验证设置。
- 点击保存。
发送消息
组件使用 prebuilt_components_offers_and_deals:send_message webhook 向用户选择的渠道发送包含优惠详情的消息。
API 请求参数
以下参数由组件提供，作为 API 请求的输入。
| 参数名称 | 说明 | 输入格式 |
|---|---|---|
| $session.params.phone_number | 用户的本地手机号码（不含国家/地区代码），用于识别用户。 | 字符串 |
| $flow.confirmation_channel | 用户选择用于接收优惠详情的渠道。有效值由 prebuilt_components_channel_email_phone 实体定义。 |
字符串 |
如需为此组件配置“发送消息”Webhook，请展开以查看说明。
- 打开 Dialogflow CX 控制台。
- 选择您的 Google Cloud 项目。
- 选择您的代理。
- 选择管理标签页。
- 点击 Webhooks。
- 选择 prebuilt_components_offers_and_deals:send_message webhook。
- 将 Dialogflow CX 网络钩子网址字段中的网址替换为您要集成的服务的端点。在下拉菜单中选择适当的方法。
- 查看并更新请求正文，为您的 webhook 形成正确的请求格式。
- 查看并更新响应配置，以从 webhook 的响应中提取特定字段。请勿修改参数名称，因为组件需要这些名称来访问返回的字段值。
- 根据需要查看并更新身份验证设置。
- 点击保存。
提交工单
组件使用 prebuilt_components_offers_and_deals:raise_ticket webhook 提交工单，报告用户在使用优惠券代码时遇到的问题。
API 请求参数
以下参数由组件提供，作为 API 请求的输入。
| 参数名称 | 说明 | 输入格式 |
|---|---|---|
| $session.params.phone_number | 用户的本地手机号码（不含国家/地区代码），用于识别用户。 | 字符串 |
| $flow.coupon_code | 用户报告了问题的优惠券代码。 | 字符串 |
| $flow.offer_id | 所提供优惠券代码的优惠 ID。 | 字符串 |
| $flow.coupon_code_issue | 用户提供的优惠券代码问题。 | 字符串 |
如需为此组件配置“提交工单”Webhook，请展开查看相关说明。
- 打开 Dialogflow CX 控制台。
- 选择您的 Google Cloud 项目。
- 选择您的代理。
- 选择管理标签页。
- 点击 Webhooks。
- 选择 rebuilt_components_offers_and_deals:raise_ticket webhook。
- 将 Dialogflow CX 网络钩子网址字段中的网址替换为您要集成的服务的端点。在下拉菜单中选择适当的方法。
- 查看并更新请求正文，为您的 webhook 形成正确的请求格式。
- 查看并更新响应配置，以从 webhook 的响应中提取特定字段。请勿修改参数名称，因为组件需要这些名称来访问返回的字段值。
- 根据需要查看并更新身份验证设置。
- 点击保存。
完成
您的代理及其 webhook 现在应该已设置完毕，可以进行测试了。