View a markdown version of this page

Envío de WhatsApp flujos a los usuarios - AWS Mensajería social para usuarios finales
Ejemplo: enviar un flujo mediante un mensaje de plantillaConfiguración de una plantilla para Flows

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Envío de WhatsApp flujos a los usuarios

Los flujos se envían a los usuarios a través de mensajes de plantilla utilizando la API existente. SendWhatsAppMessage No es necesario realizar cambios en la API de envío de mensajes. El flujo está incrustado en el mensaje de plantilla como un componente de botón con un flow subtipo.

Antes de poder enviar un flujo, debe cumplirse lo siguiente:

  • El flujo debe estar en estado PUBLICADO.

  • Debe tener una plantilla de mensaje que haga referencia al flujo (con un botón de flujo).

  • El usuario debe haber optado por recibir tus mensajes.

Ejemplo: enviar un flujo mediante un mensaje de plantilla

El siguiente ejemplo envía un mensaje de plantilla que contiene un botón de flujo. flow_tokenEs un identificador único que se proporciona para realizar un seguimiento de la sesión y flow_action_data especifica la pantalla de inicio y cualquier dato inicial.

aws socialmessaging send-whatsapp-message \
    --origination-phone-number-id {PHONE_NUMBER_ID} \
    --meta-api-version v20.0 \
    --message '{
        "messaging_product": "whatsapp",
        "to": "+14085551234",
        "type": "template",
        "template": {
            "name": "flow_template_name",
            "language": {"code": "en_US"},
            "components": [
                {
                    "type": "button",
                    "sub_type": "flow",
                    "index": "0",
                    "parameters": [
                        {
                            "type": "action",
                            "action": {
                                "flow_token": "unique-session-token-123",
                                "flow_action_data": {
                                    "screen": "WELCOME_SCREEN",
                                    "data": {}
                                }
                            }
                        }
                    ]
                }
            ]
        }
    }'

En el comando anterior, sustituya el siguiente:

  • {PHONE_NUMBER_ID}— El identificador de su número de teléfono original.

  • +14085551234— El número de teléfono del destinatario en formato internacional.

  • flow_template_name— El nombre de la plantilla de mensaje aprobada que incluye un botón de flujo.

  • unique-session-token-123— Un token único que generas para identificar esta sesión de Flow. Este token se devuelve al webhook cuando el usuario completa el Flow.

  • WELCOME_SCREEN— El ID de la primera pantalla de tu definición de Flow en JSON.

nota

flow_tokenDebe ser único por sesión para que puedas correlacionar las respuestas de Flow con eventos de envío específicos. Puedes usar un UUID o cualquier otro identificador único.

Configuración de una plantilla para Flows

Para enviar un flujo, necesita una plantilla de mensaje con un botón de flujo configurado. Al crear la plantilla, añade un botón de llamada a la acción del tipo FLOW que haga referencia a tu ID de flujo publicado.

Para obtener más información sobre la creación de plantillas de mensajes, consulte. Uso de plantillas de mensajes en AWS End User Messaging Social Para obtener información sobre la configuración de la plantilla de flujo, consulte Enviar un flujo en la documentación de Meta WhatsApp Business Platform.