您位於此處:
建立 WhatsApp Pay 畫面流程
本教學課程會引導您建立使用付款傳訊元件將付款要求傳送給客戶的範例畫面流程。您可以使用此元件直接在 WhatsApp 傳訊管道內向客戶要求付款。若要傳送此元件並將其填入動態訂單詳細資料,您可以建立畫面流程。您可以透過呼叫 Apex 動作,使用此流程來收集必要的付款資料。資料包含條列項目、總計、訂單內容和自訂參數,例如寄送金額。資料收集後,流程會使用「增強型訊息」動作將元件傳送給使用者。
- 請參閱 使用畫面流程與使用者互動 並 開始使用畫面流程。
- 建立 WhatsApp 付款傳訊元件。
- 請確保在您的組織中可使用用於採取付款資料 (
PaymentMessageLineltems、PaymentPaymentTotal、PaymentOrderContext、PaymentMessage和PaymentInitiations) 的 Apex 類別。您可以擁有自己的類別名稱以進一步瞭解。如需如何建立 Apex 類別和範例程式碼的詳細資訊,請參閱 為 Apex 類別和範例程式碼片 建立 Apex 類別段。 - 如果您使用 PIX 作為付款方式,請確定您已指定商家名稱內容。
- 如果您要將訂單狀態傳送回一般使用者,請在付款傳訊元件中建立兩個自訂參數。一個用來捕捉參照識別碼,另一個用來捕捉訂單狀態標籤。此外,請確認您已針對訂單狀態設定 WABA 範本。如果您尚未設定,請登入您的 WABA 帳戶並移至您的訊息範本。在「公用程式」 索引標籤下方,選取「訂單狀態」,然後提交以供檢閱。
- 您可以建立自訂參數,以儲存貨運金額。這是依預設無法使用的選用參數。
建立自訂參數
- 進入「 設定」,在「快速尋找」方塊中輸入 傳訊元件,然後選取「 傳訊元件」。
- 找到並按一下您的 WhatsApp Pay 傳訊元件。
- 按一下「參數」。
-
按一下「新增」。
「新增 Pameter」視窗隨即顯示。
- 輸入 name as shipping_amount,並選取 type as double。
- 按一下「儲存」。
步驟 1:建立畫面流程
- 進入「設定」,在「快速尋找」方塊中輸入流程,然後選取「流程」。
-
按一下「新增流程」,然後選取「畫面流程」。
「畫面流程」會顯示在自動版面配置頁面上。如果您看不到「畫面流程」,請使用搜尋方塊搜尋「畫面流程」。
-
按一下 + 新增所需畫面流程元素。
如需如何使用 Flow Builder 元素 (例如「畫面」、「指派」和「動作」) 的詳細資訊,請參閱「流程元素」。
步驟 2:取得傳訊工作階段識別碼
-
按一下 + 可將「畫面」元素新增至流程,以取用工作階段識別碼。
「新畫面視窗」隨即顯示。
- 在「元件」下,在搜尋方塊中輸入 文字,然後選取「文字」,將「文字」元件新增至「畫面」元素。
- 在「內容」下,針對「標籤」輸入 GetSessionld,並視需要在其他欄位中輸入詳細資料。
-
按一下「完成」。
流程會以 GetSessionld 畫面元素更新。
-
按一下畫面元素下方的 + 可將「指派」元素新增至流程。
此步驟會建立變數以儲存工作階段識別碼。將其命名為 StoreSessionld。
-
建立名為 Messaging Sessionld 的變數,並將「資料類型」設為「文字」,然後選取「可供輸入」和「可供輸出」。
將「傳訊工作階段」變數指派給畫面元件的值 (GetSessionld.Sessionld)。如需如何建立變數的詳細資訊,請參閱 瞭解流程變數。
步驟 3:指派貨運金額
- 新增「指派」元素並將其命名為 SaveShippingAmount。
-
使用「資料類型」設為「數字」,建立名為 ShippingAmount 的變數。
為「貨運金額」變數指派值,例如 10。
步驟 4:取得付款條列項目
- 新增「動作」元素以呼叫提供 付款條列項目的 Apex 類別。
- 在「搜尋動作」下方,搜尋並選取「PaymentMessageLineltems」 動作。
- 將動作標記為 GetPaymentLineltems。
- 在「檢視輸出資源」下方,選取「手動指派變數 (進階)」。
-
在「儲存輸出值」下方,按一下搜尋方塊以 建立名為的變數PaymentLineltems。
-
將「資料類型」設定為「Apex 定義」,選取「
RichMessaging_PaymentLineltemApex」類別,然後選取「允許多重值 (集合)」。 - 選取「可供輸入」和「可供輸出」。將輸出指派給您的 PaymentLineltems 變數。
-
將「資料類型」設定為「Apex 定義」,選取「
- 按一下「完成」。
步驟 5:取得付款總額
- 新增「動作」元素以呼叫提供「總付款」的 Apex 類別。
- 在「搜尋動作」下,搜尋並選取「PaymentPaymentPaymentTotal」動作。
- 將動作標記為 GetPayment Total。
- 在「檢視輸出資源」下方,選取「手動指派變數 (進階)」。
-
在「儲存輸出值」下,按一下搜尋方塊以 建立名為的變數 「付款總額」。
- 將「資料類型」設定為「Apex 定義」,然後選取「RichMessaging_PaymentTotal Apex」類別。請勿允許多個值。將輸出指派給您的「付款總計」變數。
- 選取「可供輸入」和「可供輸出」。
- 按一下「完成」。
步驟 7:取得付款起始
- 新增「動作」元素以呼叫 Apex 類別進行 付款起始。
- 在「搜尋動作」下方,搜尋並選取「PaymentInitiations」 動作。
- 將動作標記為 GetPaymentInitiations。
- 在「檢視輸出資源」下方,選取「手動指派變數 (進階)」。
-
在「儲存輸出值」下方,按一下搜尋方塊以 建立名為的變數PaymentInitiations。
- 將「資料類型」設定為「Apex 定義」,選取「RichMessaging_PaymentInitiation Apex」類別,然後選取「允許多重值 (集合)」。將輸出指派給您的 PaymentInitiations 變數。
- 選取「可供輸入」和「可供輸出」。
- 按一下「完成」。
步驟 8:傳送付款元件
-
新增「畫面」元素以建立互動式介面,以收集使用者的輸入內容或向使用者顯示資訊。
將其標記為 SendPaymentComponent。
- 在「元件」下,在搜尋方塊中輸入 增強型訊息,然後選取「增強型訊息」。
-
在「內容」下,選取所需詳細資料。
- 針對「傳訊工作階段識別碼」,選取「傳訊工作階段」變數。
- 針對「傳訊元件名稱」,選取您的付款傳訊元件名稱。例如,「WhatsApp 付款元件」範例。
- 將標準參數對應至您建立的 Apex 定義變數。
- 付款條列項目參數:PaymentLineltems
- 付款總計參數:付款總額
- 訂單內容:OrderContext
- PaymentInitiations:PaymentInitiations
-
按一下「設定自訂參數」。
- 進入「參數名稱」,選取「shipping_amount」。
- 進入「參數值類型」,選取「變數」。
- 進入「變數」,選取「ShippingAmount」變數。
- 按一下「Add (新增)」。
- 按一下「完成」。


