优惠和特惠 预构建组件 检查调用方是否为注册用户。如果用户拥有注册账号，该组件可以提供有关用户专属优惠和特惠的信息。用户还可以详细了解常规优惠和特惠，或报告特定优惠券代码存在的问题。该组件使用 字母数字集合 用于收集优惠券代码的预构建组件。该组件还使用 通话后使用的生成器 摘要、常见问题解答和优惠详情。
限制
除了常见的预构建组件限制之外，此预构建组件还存在以下限制：
- 此组件不会加密任何数据。
示例对话框
以下示例对话框展示了由此函数处理的常见场景 预构建组件。示例对话框演示了使用电话功能调用组件时的行为，该功能会在对话开始时触发默认欢迎 intent 和第一个客服人员回复。
针对特定用户的优惠和特惠
最终用户之前已通过身份验证。用户询问最新的优惠，客服人员会显示专门针对该用户的优惠列表。用户询问一些有关优惠的问题，然后询问特定类别的优惠。客服人员会显示该类别中的优惠列表。客服人员主动提出 向用户提供详细信息，然后用户拒绝。
| 用户输入 | 客服人员回复 |
|---|---|
| 欢迎！想了解我们的最新优惠，还是在使用特定优惠券代码时遇到任何问题？ | |
| 我想查看最新优惠 | |
| 确认一下，您要查找优惠。对吗？ | |
| 是 | |
| 我们为您找到了以下优惠，详情如下： 优惠 1：使用代码 APPARELS5 购买服装可享 5 折优惠，有效期至 2024 年 3 月 28 日。 优惠 2：使用代码 GROCERY500 购买日杂可享 8.5 折优惠，有效期至 2024 年 3 月 28 日。 希望您能对这些优惠感兴趣。您对优惠或特惠有任何疑问吗？我们可以为您解答。 |
|
| 日用品有最低购买量要求吗？ | |
| 是的，购物金额满 10 即可享受食品杂货八五折优惠。使用代码 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 项目。
- 选择您的代理。
- 选择 Build 标签页。
- 点击流部分中的导入的组件。
- 点击页面部分的“初始页”。
- 点击“开始”页面中的 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，以从外部服务检索所需信息。
获取优惠详情
该组件使用 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"}。 |
列表（对象） |
| all_offers | 一般优惠详情列表。列表中的每个元素都表示一个商品，其格式与 user_offer 字段相同。 |
列表（对象） |
如需为此组件配置“获取优惠详情”网络钩子，请展开即可查看相关说明。
- 打开 Dialogflow CX 控制台。
- 选择您的 Google Cloud 项目。
- 选择您的代理。
- 选择管理标签页。
- 点击 Webhook。
- 选择 prebuilt_components_offers_and_deals:get_offers_details webhook。
- 将“对话式客服 (Dialogflow CX)”Webhook 网址字段中的网址替换为您要集成的服务的端点。在下拉菜单中选择适当的方法。
- 查看并更新请求正文，为 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 项目。
- 选择您的代理。
- 选择管理标签页。
- 点击网络钩子。
- 选择 prebuilt_components_offers_and_deals:get_coupon_code_details webhook。
- 将“对话式客服 (Dialogflow CX)”Webhook 网址字段中的网址替换为您要集成的服务的端点。从下拉菜单中选择适当的方法。
- 查看并更新请求正文，为 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 项目。
- 选择您的代理。
- 选择管理标签页。
- 点击网络钩子。
- 选择 prebuilt_components_offers_and_deals:send_message webhook。
- 将“对话式客服 (Dialogflow CX)”Webhook 网址字段中的网址替换为您要集成的服务的端点。在下拉菜单中选择适当的方法。
- 查看并更新请求正文，为 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 | 用户提供的优惠券代码问题。 | 字符串 |
如需为此组件配置“提高票券网络钩子”，请展开即可查看相关说明。
- 打开 Dialogflow CX 控制台。
- 选择您的 Google Cloud 项目。
- 选择您的代理。
- 选择管理标签页。
- 点击 Webhook。
- 选择 rebuilt_components_offers_and_deals:raise_ticket 网络钩子。
- 将 Conversational Agents (Dialogflow CX) Webhook 网址 字段中的网址替换为服务的端点 哪些组件需要集成从下拉菜单中选择适当的方法。
- 查看并更新请求正文，为 webhook 构建正确的请求格式。
- 查看并更新响应配置，以从 webhook 的 响应。请勿修改参数名称，因为组件需要这些名称才能访问返回的字段值。
- 查看并根据需要更新身份验证设置。
- 点击保存。
完成
您的客服人员及其网络钩子现在应该已设置完毕，可以进行测试了。