以點數折抵的訂單預先建構元件

換貨訂單預建元件會檢查使用者的驗證層級。使用者通過驗證後，元件會提供使用者最近或過去的訂單資訊。使用者可以選擇換購訂單中的多項商品，並選取退款和運送方式等選項。這個元件會使用零售驗證預先建構元件來驗證使用者。這個元件也會使用生成器，在通話後產生摘要和常見問題。

限制

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

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

對話範例

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

在門市更換瑕疵商品

使用者先前已通過驗證。服務專員確認最近一筆訂單中要換貨的商品，並收集換貨原因。使用者選擇在商店換貨，服務專員提供最近的商店清單。使用者選取商店後，代理會產生運送標籤，並傳送至使用者的註冊管道。

使用者輸入內容	代理回覆
	你來電是要詢問最近一筆訂單嗎？訂單編號結尾為 12375，內含 2 盞燈、2 支 Pixel 和 10 項其他產品，下單日期為 2023-11-10。
是
	我們在你的訂單中找到一些符合資格的產品。請告訴我們你想換貨的產品。產品 1：Google 燈具、產品 2：Google Pixel、產品 3：Google LED 燈。 請說出或輸入要選取的產品編號，或說出「下一個」查看更多產品。
1
	我們想確認你是否要換貨 Google 燈具。請問是否正確？
是
	我們發現你選取的產品現有數量為 2。請指定要換貨的產品數量。
二
	請說明換貨原因。你可以說：「商品有瑕疵或無法使用」、「尺寸或版型問題」、「訂單不完整」、「款式問題」、「顏色不正確」或「其他」。
商品有瑕疵
	感謝你告知。 最後，請問你想如何換貨？例如：到店換貨或安排取貨。
我想在商店換貨
	一起尋找附近的商店吧！
	代理使用郵遞區號收集預建元件收集郵遞區號
	以下是靠近你輸入郵遞區號的地點清單。 地址 1：Google Texas, 500 W 2nd St, Suite 2900 Austin, Texas 78701, US。 地址 2：Google California, 19510 Jamboree Road, Irvine, California 92612, US。 請說出或輸入你要選取的地址編號，或說出「下一個」來顯示更多商店地址。
第一家商店
	您已選取 Google Texas (500 W 2nd St, Suite 2900 Austin, Texas 78701, US)，對嗎？
是
	太好了！我們已將運送標籤和票券號碼傳送至你註冊的電話號碼和電子郵件地址。請列印出來並貼在包裹上，然後在 30 天內寄出換貨商品。倉庫收到商品後，換貨資訊 (如有) 會在 3 到 5 個工作天內顯示在你的帳戶中。請注意：退款金額不含運費和處理費用。 換購產品的價值較高。價差為 $20 美元。你很快就會在註冊的手機號碼收到付款連結。請在 24 小時內付款，以便換貨。 你是否要換購其他訂單商品？
沒有，就這樣
	感謝你的來電。

退還差額

使用者先前已通過驗證。代理會收集訂單編號、要換貨的產品和換貨原因。使用者選擇換成不同尺寸，並安排取貨。服務專員發現換貨商品價格低於新商品，並向使用者確認退款方式。

使用者輸入內容	代理回覆
	你來電是要詢問最近一筆訂單嗎？訂單編號末 5 碼為 12345，內含 2 盞燈，下單日期為 2023-11-10。
否
	是否要換購其他訂單商品？
是
	能否請你提供要換貨的訂單 ID 末 5 碼？
12346
	我們取得的訂單 ID 末五碼是 12346，請問是否正確？
是
	太好了，我們已收集到訂單 ID。 我們在你的訂單中找到一些符合資格的產品。請告訴我們你想換貨的產品。產品 1：Google 水瓶，產品 2：Google T 恤。 請說出或輸入要選取的產品編號，或說出「下一個」查看更多產品。
二
	為確認您的意願，您想用 Google T 恤換取其他商品。請問是否正確？
是
	請說明換貨原因。你可以說：「商品有瑕疵或無法使用」、「尺寸或版型問題」、「訂單不完整」、「款式問題」、「顏色不正確」或「其他」。
尺寸或貼合度問題
	感謝你告知換貨原因。請告訴我們你想換成什麼尺寸。我們有以下尺寸： 說 1 代表小號。 說 2 代表中號。 說 3 代表大號。 說 4 代表特大號。 說 5 代表超大號。
1
	最後，請選擇換貨方式。例如：到店換貨或安排取貨。
安排取貨
	太好了！我們已將運送標籤傳送至你註冊的電話號碼和電子郵件地址。請列印出來並貼在包裹上。我們的團隊會在 24 到 48 小時內與你聯絡，安排取件時間。我們在倉庫收到商品後，換貨退款會在 3 到 5 個工作天內入帳。 換貨商品價值較低，因此你符合 5 美元的退款資格。 請告訴我們你希望透過哪種方式收到退款。例如「Google 商店消費金」或「來源帳戶」。
Google 商店消費金
	感謝你確認要將退款退回錢包。 你是否要換購其他訂單商品？
否
	感謝你的來電。

不符合資格的訂單

使用者先前已通過驗證。服務專員查看最近的訂單，發現沒有符合換貨資格的產品，虛擬服務專員向使用者收集訂單號碼，發現提供的訂單沒有任何符合資格的產品。

使用者輸入內容	代理回覆
	在最近的訂單中，我們找不到任何符合換貨資格的產品。 要更換其他訂單嗎？
是
	能否請你提供要換貨的訂單 ID 末 5 碼？
23487
	我們取得的訂單 ID 末五碼是 23487，對嗎？
是
	很好，我們已收集到訂單 ID。
	很抱歉，根據我們的政策，你訂單中的產品不符合換貨資格。如要進一步瞭解我們的換貨政策，請前往網站。 你是否要更換其他訂單的商品？
否
	感謝你的來電。

命名慣例

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

功能	格式	範例
Flow	[Component Name]	Order Status
實體類型	prebuilt_components_[component_name]_[entity_type]	prebuilt_components_exchange_order_location
Webhook	prebuilt_components_[component_name]:[webhook_action]	prebuilt_components_exchange_order:get_product_exchange_availability

輸入參數

輸入參數是用來設定元件的特定行為。流程中的一或多個條件會使用這些參數，決定元件的行為。流程範圍參數必須在元件的起始頁面上設定。以工作階段為範圍的參數可由呼叫流程設定，或在這個元件的起始頁面上設定。

這個預建元件接受下列輸入參數：

參數名稱	說明	輸入格式
$session.params.phone_number	(選用) 使用者的當地電話號碼 (不含國家/地區代碼)，用於識別使用者。	字串
$session.params.all_recent_order_id	(選用) 這個參數會列出與已驗證使用者相關聯的訂單 ID，並依訂單日期遞減排序。陣列的第一個元素代表最近的訂單。如果使用者沒有訂單，這個參數的值會是 null。	清單 (字串)
$session.params.email	(選用) 帳戶註冊的電子郵件地址。	字串
$session.params.user_first_name	(選用) 使用者的名字，用於問候及確認帳戶擁有權。	字串

這個預建元件允許使用下列選用參數，設定元件的行為，包括重試。

參數名稱	說明	格式
$flow.max_retry_another_account	指定選擇是否要繼續使用替代帳戶時，允許的重試次數。預設值為 3。	整數
$flow.max_retry_order_number	指定提供訂單編號末五碼時，允許的重試次數。預設值為 3。	整數
$flow.max_retry_another_order	指定在找不到訂單 ID 或訂單不符合換貨資格時，允許選取其他訂單退貨的重試次數。預設值為 2。	整數
$flow.max_retry_select_order_number	如果有多筆訂單的末五碼相同，系統會要求提供完整訂單號碼，並允許重試指定次數。預設值為 2。	整數
$flow.max_retry_exchange_reason	指定提供換貨原因時允許的重試次數。預設值為 3。	整數
$flow.max_retry_exchange_reason_counter	指定確認換貨原因時允許的重試次數。預設值為 2。	整數
$flow.order_product_exchange_reason_others	指定 prebuilt_components_exchange_order_reason 實體的值，表示使用者已選取「其他」換貨原因。預設值為 "others"。	字串
$flow.max_product_display_counter	指定單次對話中最多可顯示的產品數量。預設值為 2。	整數
$flow.max_product_display	指定整個對話中最多可顯示的產品數量。預設值為 9。	整數
$flow.max_product_exchange_confirm	指定確認所選產品時，允許的重試次數上限。預設值為 2。	整數
$flow.max_retry_product_number_counter	指定選取要換購的產品時，最多可重試幾次。預設值為 3。	整數
$flow.max_retry_select_quantity	指定選取換貨產品數量時，允許的重試次數上限。預設值為 2。	整數
$flow.max_retry_size_number_counter	指定選取要交換的大小，最多可重試幾次。預設值為 2。	整數
$flow.max_retry_another_zip_code	指定提供郵遞區號時允許的重試次數上限。預設值為 2。	整數
$flow.max_store_display_counter	指定單次回應中最多可顯示的商店數量。預設值為 1。	整數
$flow.max_store_display	指定整段對話中最多可顯示的商店數量。預設值為 10。	整數
$flow.max_retry_store_number_counter	指定選取商店時允許的重試次數上限。預設值為 2。	整數
$flow.max_retry_store_selection	指定確認商店選擇時允許的重試次數。預設值為 3。	整數
$flow.max_available_address_reselection_counter	指定確認使用者是否要選取其他商店地址時，允許的重試次數。預設值為 2。	整數
$flow.order_payment_mode_COD	指定 get_order_details Webhook 傳回的 order_payment_mode 欄位值，表示貨到付款 (COD) 付款方式。預設值為 "COD"。	字串
$flow.order_payment_mode_store_credit	指定 get_order_details Webhook 傳回的 order_payment_mode 欄位值，表示 Google 商店消費金付款方式。預設值為 "store_credit"。	字串
$flow.order_refund_mode_source_account	指定 prebuilt_components_exchange_order_refund_mode 實體的值，表示使用者選擇退款至來源帳戶。預設值為 source_account。	字串
$flow.order_exchange_location_scheduled_for_pickup	指定 prebuilt_components_exchange_order_location 實體的值，表示使用者選擇安排換貨取件。預設值為 scheduled_for_pickup。	字串

輸出參數

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

參數名稱	說明	輸出格式
phone_number	使用者的當地電話號碼 (不含國家/地區代碼)，用於識別使用者。	字串
all_recent_order_id	這個參數會列出與已驗證使用者相關聯的訂單 ID，並依訂單日期遞減排序。陣列的第一個元素代表最近的訂單。如果使用者沒有訂單，這個參數的值會是 null。	清單 (字串)
電子郵件	帳戶註冊的電子郵件地址。	字串
user_first_name	使用者的名字，用於問候及確認帳戶擁有權。	字串
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 內建事件」。	字串

生成器

這個元件會使用生成器，啟用對話的特定部分。

常見問題

FAQ 生成器用於處理退換貨的常見問題，包括：

• 退貨程序是否有期限？
• 我可以換貨嗎？
• 產品價格和退款金額不同。為什麼會這樣？

摘要

Summarization 生成器用於生成通話後摘要，說明元件處理的對話。

基本設定

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

1. 匯入預先建構的元件。
2. 使用描述外部服務的設定，設定提供的彈性 Webhook，請參閱「Webhook 設定」。

Webhook 設定

如要使用這個元件，您必須設定內含的彈性 Webhook，從外部服務擷取所需資訊。

驗證

如果您先前未設定驗證所需的外部服務，則必須設定這些服務，才能為這個元件啟用使用者驗證功能。如需詳細操作說明，請參閱「零售驗證 Webhook 設定」。

提供符合條件的訂單詳細資料：

元件會使用 prebuilt_components_exchange_order:get_order_details Webhook 擷取指定訂單的詳細資料。

API 要求參數

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

參數名稱	說明	輸入格式
$flow.order_id	要擷取詳細資料的訂單 ID。	字串

API 回應參數

系統會從 API 回應中擷取下列參數，供元件使用。

參數名稱	說明	輸出格式
order_date	下單日期，格式為 YYYY-MM-DD。	字串
order_product_count	訂單中不重複產品的數量。	整數
order_payment_mode	指出下單時使用的付款模式。	字串
exchangeable_product_id	訂單中可換貨產品的產品 ID 清單。	清單 (字串)
exchangeable_product_name	訂單中可換貨產品的產品名稱清單。	清單 (字串)
exchangeable_product_brand_name	訂單中可換貨產品的品牌名稱清單。	清單 (字串)
exchangeable_product_quantity	訂單中可換貨產品的數量清單。	清單 (字串)
exchangeable_product_price	訂單中可換貨產品的價格清單。	清單 (字串)

取得重複訂單詳細資料

元件會使用 prebuilt_components_retail_services:get_duplicate_order_details Webhook 擷取詳細資訊，以便在多個訂單編號的末五碼相同時，區分不同訂單。

API 要求參數

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

參數名稱	說明	輸入格式
$flow.duplicate_order_id	這份清單包含使用者一或多筆訂單的訂單編號末五碼。	清單 (字串)

API 回應參數

系統會從 API 回應中擷取下列參數，供元件使用。

參數名稱	說明	輸出格式
all_order_date	重複訂單的訂單日期清單，格式為 YYYY-MM-DD，並指定末五碼。這個陣列中的每個元素都對應到 all_order_time 陣列中的相同元素。	清單 (字串)
all_order_time	重複訂單的下單時間清單，其中包含以 HH:MM 格式指定的末五碼。這個陣列中的每個元素都對應到 all_order_date 陣列中的相同元素。	清單 (字串)

取得可換貨的尺寸

如果使用者因尺寸或合身問題而想換貨，元件會使用 prebuilt_components_exchange_order:get_available_exchange_size Webhook 擷取可換貨的尺寸。

API 要求參數

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

參數名稱	說明	輸入格式
$flow.selected_order_product_id	使用者想換購的產品 ID。	字串

API 回應參數

系統會從 API 回應中擷取下列參數，供元件使用。

參數名稱	說明	輸出格式
product_available_sizes	所選產品的可用尺寸清單。	清單 (字串)

取得產品換貨資格

元件會使用 prebuilt_components_exchange_order:get_product_exchange_availability Webhook，檢查使用者選取的產品、數量和選用尺寸是否可供兌換。

API 要求參數

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

參數名稱	說明	輸入格式
$flow.order_id	要擷取詳細資料的訂單 ID。	字串
$flow.selected_order_product_id	使用者想換購的產品 ID。	字串
$flow.order_product_quantity_exchange_count	使用者想換貨的產品數量。	整數
$flow.product_selected_size	使用者想換貨的產品尺寸。	字串

API 回應參數

系統會從 API 回應中擷取下列參數，供元件使用。

參數名稱	說明	輸出格式
product_exchange_availability	指出所選產品、數量和尺寸是否可換貨。	布林值
product_exchange_price	表示所選產品和尺寸的單件換購價格。	數字

提交不完整訂單支援單

當使用者因訂單不完整而想更換產品時，元件會使用 prebuilt_components_exchange_order:raise_incomplete_order_ticket Webhook 建立票證。

API 要求參數

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

參數名稱	說明	輸入格式
$session.params.phone_number	使用者的當地電話號碼 (不含國家/地區代碼)，用於識別使用者。	字串
$flow.order_id	要提交支援單的訂單 ID。	字串
$flow.selected_order_product_id	使用者想換購的產品 ID。	字串
$flow.order_product_quantity_exchange_count	使用者想換貨的產品數量。	整數
$flow.order_product_exchange_reason	使用者想換貨的原因。	字串

取得商店詳細資料

元件會使用 prebuilt_components_exchange_order:get_store_details Webhook，擷取使用者提供的郵遞區號附近的商店清單。

API 要求參數

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

參數名稱	說明	輸入格式
$flow.zip_code	搜尋附近商店時使用的郵遞區號。	字串

API 回應參數

系統會從 API 回應中擷取下列參數，供元件使用。

參數名稱	說明	輸出格式
store_id	商店 ID 清單。	清單 (字串)
store_address	與 store_id 各元素對應的商店地址清單。	清單 (字串)

換貨後詳細資料

元件會使用 prebuilt_components_exchange_order:post_exchange_details Webhook 提交換貨要求。

API 要求參數

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

參數名稱	說明	輸入格式
$session.params.phone_number	使用者的當地電話號碼 (不含國家/地區代碼)，用於識別使用者。	字串
$flow.order_id	要提交支援單的訂單 ID。	字串
$flow.selected_order_product_id	使用者想換購的產品 ID。	字串
$flow.order_product_quantity_exchange_count	使用者想換貨的產品數量。	整數
$flow.product_selected_size	使用者想換貨的產品尺寸。	字串
$flow.order_product_exchange_reason	使用者想換貨的原因。	字串
$flow.order_exchange_location	廣告交易平台選取的模式。有效值由 prebuilt_components_exchange_order_location 實體定義。	字串
$flow.order_exchange_store_id	使用者選取要換貨的商店 ID。	字串
$flow.order_refund_mode	退款方式 (如適用)。有效值由 prebuilt_components_exchange_order_refund_mode 實體定義。如果不需要退款，這個值會是 null。	字串
$flow.total_refund_amount	如果換購產品的價格高於新產品，則會退還差額。如果不需要退款，這個值會是 null。	整數

API 回應參數

系統會從 API 回應中擷取下列參數，供元件使用。

參數名稱	說明	輸出格式
order_exchange_ticket_id	已提交換貨要求的票證 ID。	字串

傳送貨到付款退款資訊

元件會使用 prebuilt_components_exchange_order:send_COD_refund_information Webhook，將與兌換相關的付款資訊傳送給使用者。

API 要求參數

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

參數名稱	說明	輸入格式
$session.params.phone_number	使用者的當地電話號碼 (不含國家/地區代碼)，用於識別使用者。	字串
$flow.order_id	要提交支援單的訂單 ID。	字串
$flow.channel	要傳送資訊的特定管道。有效值由 prebuilt_components_channel_email_phone 實體定義。系統預設支援 phone 和 email。	字串

完成

代理和 Webhook 應已設定完成，可以開始測試。