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