優惠與特惠資訊預先建構元件

優惠和特惠預建元件會檢查來電者是否為已註冊的使用者。如果使用者已註冊帳戶，元件可以提供使用者專屬優惠和特惠資訊。使用者也可以取得一般優惠和特惠的詳細資料，或回報特定優惠碼的問題。這個元件會使用英數字元收集預建元件收集優惠碼。該元件也使用生成器，提供通話後摘要、常見問題和優惠詳情。

限制

除了常見的預建元件限制外，這項預建元件還有下列限制：

• 這個元件不會加密任何資料。

對話範例

下列對話範例說明這項預建元件處理的常見情境。範例對話會示範使用電話呼叫元件時的行為，這會觸發預設歡迎意圖和對話開始時的第一個代理回覆。

使用者專屬和一般優惠與特價

使用者先前已通過驗證。使用者詢問最新優惠，服務專員則提供專屬優惠清單。使用者詢問一些關於優惠的問題，然後要求特定類別的優惠。代理會列出該類別的優惠。服務專員提議將優惠詳情傳送給使用者，但使用者拒絕。

使用者輸入內容	代理回覆
	歡迎！您想瞭解最新優惠，還是特定優惠碼有問題？
我想查看最新優惠
	確認一下，您想瞭解優惠。對嗎？
是
	我們為你找到以下優惠，詳情如下： 優惠 1：服飾 95 折，使用代碼 APPARELS5，有效期限至 2024 年 3 月 28 日。 優惠 2：雜貨 85 折，使用代碼 GROCERY500，有效期限至 2024 年 3 月 28 日。 希望你喜歡這些優惠。對於優惠或特價活動，您有任何問題需要我們解答嗎？
生鮮雜貨優惠是否有最低消費門檻？
	有，雜貨訂單金額須達 10 元，才能享有 85 折優惠。請使用代碼 GROCERY500 兌換這項優惠，有效期限至 2024 年 3 月 28 日。 希望以上說明能提供您所需的詳細資訊。對於優惠或特價活動，您有任何問題需要我們解答嗎？
有電子產品的優惠嗎？
	沒問題！以下是優惠詳情： 優惠 1：電子產品享 5% 折扣，請使用代碼 ELECTRIC5，有效期限至 2024-03-28。 優惠 2：電子產品享 15% 折扣，請使用代碼 ELECTRIC15，有效期限至 2024-03-28。 希望這些資訊對你有幫助。對於優惠或特價活動，您有任何問題需要我們解答嗎？
否，我已經選了
	您希望我們將優惠詳情傳送到您註冊的手機號碼或電子郵件地址嗎？
不用了，謝謝
	感謝你的來電。

優惠碼相關問題

使用者先前已通過驗證。使用者提到優惠碼有問題。服務專員會收集優惠碼，並向使用者提供優惠碼兌換的詳細資料。使用者確認優惠碼有問題，服務專員提交支援單回報問題。

使用者輸入內容	代理回覆
	歡迎！您想瞭解最新優惠，還是特定優惠碼有問題？
優惠碼有問題
	確認一下，您想索取優惠碼，對嗎？
是
	我們對此深感遺憾。能否請您提供使用的優惠碼？
	代理使用英數字元收集預先建構元件收集優惠碼
	服飾優惠碼 APPARELS5 的最低消費金額為$ 100 美元，有效期限至 2024 年 3 月 28 日，請確認符合最低消費金額等條件。 這項資訊對你有幫助嗎？
否
	請選取您遇到的問題。例如「我的優惠碼無法使用」、「優惠碼無法在我的地區使用」。
優惠碼無效
	確認一下，你提供的優惠碼問題是「優惠碼無效」。請問是否正確？
是
	我們已建立支援單回報你的問題。感謝你的來電。

命名慣例

這個預建元件採用下列命名慣例：

功能	格式	範例
Flow	[Component Name]	優惠和特惠
實體類型	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 Webhook 傳回的 coupon_code_status 欄位值，表示優惠碼有效。預設值為 "valid"。	字串
$flow.invalid_coupon_code_status	指定 coupon_code_status get_coupon_code_details Webhook 傳回的 欄位值，表示優惠碼無效。預設值為 "invalid"。	字串
$flow.expired_coupon_code_status	指定 get_coupon_code_details Webhook 傳回的 coupon_code_status 欄位值，表示優惠碼已過期。預設值為 "expired"。	字串

輸出參數

輸出參數是工作階段參數，在退出元件後仍會保持有效。這些參數包含元件收集的重要資訊。這個預建元件會提供下列輸出參數的值：

參數名稱	說明	輸出格式
phone_number	使用者的當地電話號碼 (不含國家/地區代碼)，用於識別使用者。	字串
transfer_reason	如果流程未成功，這個參數會指出流程退出的原因。傳回的值為下列其中一項： agent：使用者在對話期間要求與真人服務專員交談。 denial_of_information：使用者拒絕提供元件要求的資訊。 max_no_input：對話達到無輸入事件的重試次數上限。請參閱「無輸入內建事件」。 max_no_match：對話已達不相符事件的重試次數上限。請參閱不相符內建事件。 webhook_error：發生 Webhook 錯誤。請參閱「webhook.error 內建事件」。 webhook_not_found：無法連上 Webhook 網址。請參閱「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 用於處理與折扣和優惠碼相關的常見問題。

• 折扣碼可以重複使用嗎？
• 單筆訂單可以使用多個折扣嗎？
• 如何在結帳時兌換折扣碼？
• 如果結帳時忘記套用折扣碼，該怎麼辦？

基本設定

如要設定這項預建元件，請按照下列步驟操作：

1. 匯入預先建構的元件。
2. 使用描述外部服務的設定，設定提供的彈性 Webhook，請參閱「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 (object)
all_offers	一般優惠詳細資料清單。清單中的每個元素都代表一項優惠，格式與 user_offer 欄位相同。	List (object)

取得優惠碼詳細資料

元件會使用 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	優惠碼的訂單最低金額。	字串

傳送訊息

元件會使用 prebuilt_components_offers_and_deals:send_message Webhook，將包含優惠詳情的訊息傳送至使用者選取的管道。

API 要求參數

元件會提供下列參數，做為 API 要求的輸入內容。

參數名稱	說明	輸入格式
$session.params.phone_number	使用者的當地電話號碼 (不含國家/地區代碼)，用於識別使用者。	字串
$flow.confirmation_channel	使用者選擇接收優惠詳情的管道。有效值由 prebuilt_components_channel_email_phone 實體定義。	字串

提交支援單

元件會使用 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 應已設定完成，可以開始測試。