詳細情報:
WhatsApp 支払画面の作成フロー
このチュートリアルでは、支払メッセージングコンポーネントを使用して顧客に支払要求を送信する画面フローを作成する手順を説明します。このコンポーネントを使用して、WhatsApp メッセージングチャネル内で直接顧客に支払を要求できます。このコンポーネントを送信して動的な注文の詳細を入力するには、画面フローを作成します。このフローを使用して、Apex アクションをコールすることで必要な支払データを収集できます。データには、品目、合計、注文コンテキスト、カスタムパラメーター (配送金額など) が含まれます。データ収集後、フローは [拡張メッセージ] アクションを使用してコンポーネントをユーザーに送信します。
- 「画面フローを使用してユーザーと対話し、画面フローを開始する」を参照してください。
- WhatsApp 支払メッセージングコンポーネントを作成します。
- 支払データを取得するための Apex クラス (
PaymentMessageLineltems、Payment Payment Total、PaymentOrderContext、PaymentMessage PaymentInitiations) が組織で使用できることを確認します。Apex クラスの作成方法とサンプルコードについての詳細は、「Create an Apex Class and Sample Code Snippets for Apex」を参照してください。
ステップ 1: 画面フローの作成
- [設定] の [クイック検索] ボックスに「フロー」と入力し、[フロー] を選択します。
-
[新規フロー] をクリックし、[画面フロー] を選択します。
画面フローが自動レイアウトページに表示されます。[画面フロー] が表示されない場合は、検索ボックスを使用して [画面フロー] を検索します。
-
[+] をクリックして、必要な画面フロー要素を追加します。
Flow Builder 要素 (画面、割り当て、アクションなど) の使用方法の詳細については、「フロー要素」を参照してください。
ステップ 2: メッセージングセッション ID を取得する
-
[+] をクリックしてフローに画面要素を追加し、セッション ID を取得します。
[新規画面ウィンドウ] が表示されます。
- [コンポーネント] で、検索ボックスに「テキスト」と入力し、[テキスト] を選択してテキストコンポーネントを画面要素に追加します。
- [プロパティ] の下の [表示ラベル] に「GetSessionld」と入力し、必要に応じて他のフィールドに詳細を入力します。
-
[完了] をクリックします。
GetSessionld 画面要素でフローが更新されます。
-
画面要素の下の + をクリックして、割り当て要素をフローに追加します。
このステップでは、セッション ID を保存する変数を作成します。 StoreSessionld という名前を付けます。
-
[データ型] が [テキスト] に設定された Messaging Sessionld という名前の変数を作成し、[入力で使用可能] と [出力で使用可能] を選択します。
Messaging Sessionld 変数を画面コンポーネントの値 (GetSessionld.Sessionld) に割り当てます。変数の作成方法についての詳細は、「フロー変数について」を参照してください。
ステップ 3: 配送金額を割り当てる
- 割り当て要素を追加し、「SaveShippingAmount」という名前を付けます。
-
[データ型] を [数値] に設定して ShippingAmount という名前の変数を作成します。
Shipping Amount 変数に 10 などの値を割り当てます。
ステップ 4: 支払品目を取得する
- 支払品目を提供する Apex クラスをコールするアクション要素を追加します。
- [検索アクション] で、PaymentMessageLineltems アクションを検索して選択します。
- アクションに「GetPaymentLineltems」という表示ラベルを付けます。
- [出力リソースを表示] で、[Manually assign variables (advanced) (変数の手動割り当て (詳細))] を選択します。
-
[出力値を保存] で、検索ボックスをクリックして PaymentLineltems という変数を作成します。
-
[データ型] を [Apex-Defined] に設定し、[
RichMessaging_PaymentLineltemApex クラス] を選択して、[Allow multiple values (collection)] を選択します。 - [入力で使用可能] と [出力で使用可能] を選択します。出力を PaymentLineltems 変数に割り当てます。
-
[データ型] を [Apex-Defined] に設定し、[
- [完了] をクリックします。
ステップ 5: 支払合計を取得する
- 支払総額を提供する Apex クラスをコールするアクション要素を追加します。
- [Search Actions (検索アクション)] で、[Payment Payment Total (支払支払合計)] アクションを検索して選択します。
- アクションに「GetPayment Total」 (GetPayment 合計) という表示ラベルを付けます。
- [出力リソースを表示] で、[Manually assign variables (advanced) (変数の手動割り当て (詳細))] を選択します。
-
[出力値を保存] で、検索ボックスをクリックして「Payment Total」 (支払合計) という変数を作成します。
- [データ型] を [Apex-Defined] に設定し、RichMessaging_PaymentTotal Apex クラスを選択します。複数の値を許可しないでください。出力を支払合計変数に割り当てます。
- [入力で使用可能] と [出力で使用可能] を選択します。
- [完了] をクリックします。
ステップ 6: 注文コンテキストを取得する
- アクション要素を追加して、注文コンテキストまたは詳細を提供する Apex クラスをコールします。
- [検索アクション] で、PaymentOrderContext アクションを検索して選択します。
- アクションに GetPaymentOrderContext という表示ラベルを付けます。
- [出力リソースを表示] で、[Manually assign variables (advanced) (変数の手動割り当て (詳細))] を選択します。
-
[出力値を保存] で、検索ボックスをクリックして OrderContext という名前の変数を作成します。
- [データ型] を [Apex 定義] に設定し、RichMessaging_OrderContext Apex クラスを選択します。複数の値を許可しないでください。出力を OrderContext 変数に割り当てます。
- [入力で使用可能] と [出力で使用可能] を選択します。
- [完了] をクリックします。
ステップ 7: 支払の開始を取得する
- 支払の開始のために Apex クラスをコールするアクション要素を追加します。
- [検索アクション] で、[PaymentInitiations] アクションを検索して選択します。
- アクションに「GetPaymentInitiations」という表示ラベルを付けます。
- [出力リソースを表示] で、[Manually assign variables (advanced) (変数の手動割り当て (詳細))] を選択します。
-
[出力値を保存] で、検索ボックスをクリックして PaymentInitiations という変数を作成します。
- [データ型] を [Apex-Defined] に設定し、RichMessaging_PaymentInitiation Apex クラスを選択して、[Allow multiple values (collection)] を選択します。出力を PaymentInitiations 変数に割り当てます。
- [入力で使用可能] と [出力で使用可能] を選択します。
- [完了] をクリックします。
ステップ 8: 支払コンポーネントの送信
-
画面要素を追加して、ユーザーからの入力を収集したり、情報を表示したりする対話型のインターフェースを作成します。
「SendPaymentComponent」という表示ラベルを付けます。
- [コンポーネント] の検索ボックスに「拡張メッセージ」と入力し、[拡張メッセージ] を選択します。
-
[プロパティ] で、必要な詳細を選択します。
- [メッセージングセッション ID] で、[Messaging Sessionld] 変数を選択します。
- [メッセージングコンポーネント名] で、支払メッセージングコンポーネント名を選択します。たとえば、「Sample WhatsApp Payment Component」 (WhatsApp 支払コンポーネントのサンプル) とします。
- 作成した Apex で定義された変数に標準パラメータを対応付けます。
- Payment Line Items パラメーター: PaymentLineltems
- Payment Total パラメーター: Payment Total
- Order Context (注文コンテキスト): OrderContext
- PaymentInitiations: PaymentInitiations
-
[Configure Custom Parameters] をクリックします。
- [パラメーター名] で、[shipping_amount] を選択します。
- [パラメーター値種別] で、[変数] を選択します。
- [変数] から、ShippingAmount 変数を選択します。
- [追加] をクリックします。
- [完了] をクリックします。


