Usted está aquí:
Crear flujo de pantalla de pago de WhatsApp
Este tutorial le guía por la creación de un flujo de pantalla de muestra que utiliza un componente de mensajería de pago para enviar una solicitud de pago a un cliente. Puede utilizar el componente para solicitar pagos a clientes directamente en un canal de mensajería de WhatsApp. Para enviar este componente y rellenarlo con detalles de pedido dinámicos, puede crear un flujo de pantalla. Puede utilizar este flujo para recopilar datos de pago necesarios llamando a acciones Apex. Los datos incluyen partidas, totales, contexto de pedido y parámetros personalizados como importes de envío. Tras la recopilación de datos, el flujo utiliza la acción Mensaje mejorado para enviar el componente al usuario.
- Consulte Utilizar flujos de pantalla para interactuar con usuarios y comenzar a trabajar con flujos de pantalla.
- Cree un componente de mensajería de pago de WhatsApp.
- Asegúrese de que las clases Apex para recuperar datos de pago (
PaymentMessageLineltems,PaymentPaymentTotal,PaymentOrderContext,PaymentMessageyPaymentInitiations) están disponibles en su organización. Puede tener sus propios nombres de clase para una mejor comprensión. Para obtener más información sobre cómo crear una clase Apex y código de muestra, consulte Crear una clase Apex y miniprogramas de código de muestra para clases Apex. - Si está utilizando PIX como su método de pago, asegúrese de que especificó la propiedad de nombre de comerciante.
- Si está enviando el estado del pedido de vuelta al usuario final, cree dos parámetros personalizados en su componente de mensajería de pago. Uno para capturar el Id. de referencia y otro para capturar la etiqueta de estado del pedido. Además, asegúrese de que configuró su plantilla WABA para el estado del pedido. Si aún no configuró, inicie sesión en su cuenta de WABA y vaya a su plantilla de mensaje. Bajo la ficha Utilidad, seleccione Estado del pedido y luego envíelo para su revisión.
- Cree un parámetro personalizado para capturar el importe del envío. Es un parámetro opcional que no está disponible para usted de forma predeterminada.
Crear un parámetro personalizado
- Desde Configuración, en el cuadro Búsqueda rápida, ingrese Componentes de mensajería y, a continuación, seleccione Componentes de mensajería.
- Busque y haga clic en su componente de mensajería WhatsApp Pay.
- Haga clic en Parámetros.
-
Haga clic en Nuevo.
Aparecerá la ventana Nuevo parámetro.
- Ingrese el nombre como shipping_amount y seleccione tipo como double.
- Haga clic en Guardar.
Paso 1: Crear un flujo de pantalla
- En Configuración, en el cuadro Búsqueda rápida, ingrese Flujos y luego seleccione Flujos.
-
Haga clic en Nuevo flujo y seleccione Flujo de pantalla.
El Flujo de pantalla aparece en la página de formato automático. Si no ve Flujo de pantalla, utilice el cuadro de búsqueda para buscar Flujo de pantalla.
-
Haga clic en + para agregar los elementos de flujo de pantalla requeridos.
Para obtener más información sobre cómo trabajar con elementos de Flow Builder, como Pantalla, Asignación y Acción, consulte Elementos de flujo.
Paso 2: Obtener el Id. de sesión de mensajería
-
Haga clic en + para agregar un elemento Pantalla a su flujo para capturar el Id. de sesión.
Aparecerá la Nueva ventana de pantalla.
- Bajo Componentes, en el cuadro de búsqueda, ingrese Texto y, a continuación, seleccione Texto para agregar un componente Texto al elemento Pantalla.
- Bajo Propiedades, para Etiqueta, ingrese GetSessionld e ingrese detalles en otros campos si es necesario.
-
Haga clic en Listo.
El flujo se actualiza con el elemento de pantalla GetSessionld.
-
Haga clic en + debajo del elemento de pantalla para agregar un elemento Asignación al flujo.
Este paso crea una variable para almacenar el Id. de sesión. Asígnele el nombre StoreSessionld.
-
Cree una variable denominada Messaging Sessionld con el Tipo de datos establecido como Texto y seleccione Disponible para entrada y Disponible para salida.
Asigne la variable Messaging Sessionld al valor del componente de pantalla (GetSessionld.Sessionld). Para obtener más información sobre cómo crear variables, consulte Aprender sobre variables de flujo.
Paso 3: Asignar el importe de envío
- Agregue un elemento Asignación y asígnele el nombre SaveShippingAmount.
-
Cree una variable denominada ShippingAmount con el Tipo de datos establecido como Number.
Asigne un valor a la variable Importe de envío, como 10.
Paso 4: Obtener partidas de pago
- Agregue un elemento Acción para llamar a la clase Apex que proporciona partidas de pago.
- Bajo Acciones de búsqueda, busque y seleccione la acción PaymentMessageLineltems.
- Etiqueta la acción como GetPaymentLineltems.
- Bajo Ver recursos de salida, seleccione Asignar variables manualmente (avanzado).
-
Bajo Almacenar valores de salida, haga clic en el cuadro de búsqueda para crear una variable denominada PaymentLineltems.
-
Establezca el Tipo de datos como Definido por Apex, seleccione la clase Apex
RichMessaging_PaymentLineltemy seleccione Permitir múltiples valores (recopilación). - Seleccione Disponible para entrada y Disponible para salida. Asigne el resultado a su variable PaymentLineltems.
-
Establezca el Tipo de datos como Definido por Apex, seleccione la clase Apex
- Haga clic en Listo.
Paso 5: Obtener el total del pago
- Agregue un elemento Acción para llamar a la clase Apex que proporciona el pago total.
- Bajo Acciones de búsqueda, busque y seleccione la acción PaymentPaymentTotal.
- Etiqueta la acción como Total de GetPayment.
- Bajo Ver recursos de salida, seleccione Asignar variables manualmente (avanzado).
-
Bajo Almacenar valores de salida, haga clic en el cuadro de búsqueda para crear una variable denominada Total de pago.
- Establezca el Tipo de datos como Definido por Apex y seleccione la clase de Apex RichMessaging_PaymentTotal. No permita varios valores. Asigne el resultado a su variable Total de pago.
- Seleccione Disponible para entrada y Disponible para salida.
- Haga clic en Listo.
Paso 6: Obtener el contexto de pedido
- Agregue un elemento Acción para llamar a la clase Apex que proporciona el contexto o detalles del pedido.
- Bajo Acciones de búsqueda, busque y seleccione la acción PaymentOrderContext.
- Etiqueta la acción como GetPaymentOrderContext.
- Bajo Ver recursos de salida, seleccione Asignar variables manualmente (avanzado).
-
Bajo Almacenar valores de salida, haga clic en el cuadro de búsqueda para crear una variable denominada OrderContext.
- Establezca el Tipo de datos como Definido por Apex y seleccione la clase de Apex RichMessaging_OrderContext. No permita varios valores. Asigne el resultado a su variable OrderContext.
- Seleccione Disponible para entrada y Disponible para salida.
- Haga clic en Listo.
Paso 7: Obtener inicios de pago
- Agregue un elemento Acción para llamar a la clase Apex para la iniciación del pago.
- Bajo Acciones de búsqueda, busque y seleccione la acción PaymentInitiations.
- Etiqueta la acción como GetPaymentInitiations.
- Bajo Ver recursos de salida, seleccione Asignar variables manualmente (avanzado).
-
Bajo Almacenar valores de salida, haga clic en el cuadro de búsqueda para crear una variable denominada PaymentInitiations.
- Establezca el Tipo de datos como Definido por Apex, seleccione la clase de Apex RichMessaging_PaymentInitiation y seleccione Permitir múltiples valores (recopilación). Asigne el resultado a su variable PaymentInitiations.
- Seleccione Disponible para entrada y Disponible para salida.
- Haga clic en Listo.
Paso 8: Enviar el componente Pago
-
Agregue un elemento Pantalla para crear interfaces interactivas que recopilan entradas de usuarios o les muestran información.
Etiquete como SendPaymentComponent.
- Bajo Componentes, en el cuadro de búsqueda, ingrese Mensaje mejorado y, a continuación, seleccione Mensaje mejorado.
-
Bajo Propiedades, seleccione los detalles requeridos.
- Para Id. de sesión de mensajería, seleccione la variable Sessionld de mensajería.
- Para Nombre de componente de mensajería, seleccione su nombre de componente de mensajería de pago. Por ejemplo, Componente de pago de WhatsApp de muestra.
- Asigne los parámetros estándar a las variables definidas por Apex que creó.
- Parámetro Partidas de pago: PaymentLineltems
- Parámetro de total de pago: Total de pago
- Contexto de pedido: OrderContext
- PaymentInitiations: PaymentInitiations
-
Haga clic en Configurar parámetros personalizados.
- Desde Nombre de parámetro, seleccione shipping_amount.
- Desde Tipo de valor de parámetro, seleccione Variable.
- Desde Variable, seleccione la variable ShippingAmount.
- Haga clic en Agregar.
- Haga clic en Listo.


