您在此处:
创建 WhatsApp Pay 屏幕流
本教程将指导您构建使用付款消息传递组件向客户发送付款请求的屏幕流。您可以使用该组件直接在 WhatsApp 消息传递渠道中向客户请求付款。要发送此组件并使用动态订单详细信息进行填充,您可以构建屏幕流。您可以通过调用 Apex 操作来使用此流来收集必要的付款数据。数据包含行项目、总计、订单上下文和自定义参数,例如运费金额。在数据收集后,流使用增强消息操作将组件发送给用户。
- 请参阅使用屏幕流与用户交互和开始使用屏幕流。
- 创建 WhatsApp 付款消息传递组件。
- 确保用于检索付款数据(
PaymentMessageLineltems、Payment Payment Total、PaymentOrderContext、PaymentMessage PaymentInitiations)的 Apex 类在您的组织中可用。有关如何创建 Apex 类和示例代码的更多信息,请参见创建 Apex 类和示例代码片段。
步骤 1:创建屏幕流
- 从“设置”中,在快速查找方框中,输入流,然后选择流。
-
单击新建流,选择屏幕流。
屏幕流显示在自动布局页面上。如果您没有看到屏幕流,请使用搜索框搜索屏幕流。
-
单击 + 添加所需的屏幕流元素。
有关如何使用 Flow Builder 元素(例如屏幕、分配和操作)的更多信息,请参阅流元素。
步骤 2:获取消息传递会话 ID
-
单击 + 将屏幕元素添加到流,以捕获会话 ID。
将出现新屏幕窗口。
- 在组件下方,在搜索框中,输入文本,然后选择文本,以将文本组件添加到屏幕元素。
- 在“属性”下,对于标签,输入 GetSessionld,如有必要,在其他字段中输入详细信息。
-
单击“完成”。
流会使用 GetSessionld 屏幕元素更新。
-
单击屏幕元素下方的 +,以将分配元素添加到流。
此步骤会创建变量来存储会话 ID。将其命名为 StoreSessionld。
-
创建名为 消息传递 Sessionld 的变量,数据类型设置为文本,并选择可用于输入和可用于输出。
将消息传递 Sessionld 变量分配给屏幕组件的值 (GetSessionld.Sessionld)。有关如何创建变量的更多信息,请查看了解流变量。
步骤 4:获取付款行项目
- 添加操作元素,以调用提供付款行项目的 Apex 类。
- 在搜索操作中,搜索并选择 PaymentMessageLineltems 操作。
- 将操作标记为 GetPaymentLineltems。
- 在查看输出资源中,选择手动分配变量(高级 ) 。
-
在“存储输出值”下,单击搜索框,以创建变量名为 PaymentLineltems。
-
将数据类型设置为 Apex 定义,选择
RichMessaging_PaymentLineltemApex 类,并选择允许多个值(集合)。 - 选择可用于输入和可用于输出。将输出分配到 PaymentLineltems 变量。
-
将数据类型设置为 Apex 定义,选择
- 单击“完成”。
步骤 5:获取付款总额
- 添加操作元素,以调用提供总付款的 Apex 类。
- 在搜索操作中,搜索并选择付款付款总额操作。
- 将操作标记为 GetPayment Total。
- 在查看输出资源中,选择手动分配变量(高级 ) 。
-
在“存储输出值”下,单击搜索框,以创建变量名为付款总额。
- 将数据类型设置为 Apex 定义,并选择 RichMessaging_PaymentTotal Apex 类。不允许多个值。将输出分配到付款总额变量。
- 选择可用于输入和可用于输出。
- 单击完成。
步骤 6:获取订单上下文
- 添加操作元素,以调用提供订单上下文或详细信息的 Apex 类。
- 在搜索操作中,搜索并选择 PaymentOrderContext 操作。
- 将操作标记为 GetPaymentOrderContext。
- 在查看输出资源中,选择手动分配变量(高级 ) 。
-
在“存储输出值”下,单击搜索框,以创建变量名为 OrderContext。
- 将数据类型设置为 Apex 定义,并选择 RichMessaging_OrderContext Apex 类。不允许多个值。将输出分配到 OrderContext 变量。
- 选择可用于输入和可用于输出。
- 单击完成。
步骤 7:获取付款启动
- 添加操作元素,以调用 Apex 类进行付款启动。
- 在搜索操作中,搜索并选择 PaymentInitiations 操作。
- 将操作标记为 GetPaymentInitiations。
- 在查看输出资源中,选择手动分配变量(高级 ) 。
-
在“存储输出值”下,单击搜索框,以创建变量名为 PaymentInitiations。
- 将数据类型设置为 Apex 定义,选择 RichMessaging_PaymentInitiation Apex 类,并选择允许多个值(集合)。将输出分配到 PaymentInitiations 变量。
- 选择可用于输入和可用于输出。
- 单击完成。
步骤 8:发送付款组件
-
添加屏幕元素,以创建交互式界面,收集用户输入或向他们显示信息。
将其标记为 SendPaymentComponent。
- 在组件下,在搜索框中,输入增强消息,然后选择增强消息。
-
在“属性”下,选择所需的详细信息。
- 对于消息传递会话 ID,选择消息传递 Sessionld 变量。
- 对于消息传递组件名称,选择付款消息传递组件名称。例如,示例 WhatsApp 付款组件。
- 将标准参数映射到您创建的 Apex 定义变量。
- 付款行项目参数:PaymentLineltems
- 付款总额参数:付款总额
- 订单上下文:OrderContext
- PaymentInitiations:PaymentInitiations
-
单击配置自定义参数。
- 从参数名称中,选择 shipping_amount。
- 从参数值类型中,选择变量。
- 从变量中,选择 ShippingAmount 变量。
- 单击添加。
- 单击“完成”。


