Envío de WhatsApp Flow

El sistema permite lanzar escenarios de WhatsApp Flow mediante mensajes salientes. Flow permite recopilar datos del usuario (registro, inscripción a un curso, solicitud, formulario, etc.) directamente dentro de WhatsApp sin redirigir a un sitio externo.

El sistema admite dos tipos de mensajes salientes:

1. Lanzamiento de Flow mediante mensaje plantilla

2. Lanzamiento de Flow mediante mensaje de servicio (gratuito)

Importante: para enviar un escenario Flow debe estar publicado.

Más información sobre la creación y publicación del escenario aquí.

---

Lanzamiento de Flow mediante mensaje plantilla

Cuándo usarlo:

• El usuario aún no ha escrito (no hay ventana de 24 horas);

• Necesitas iniciar la conversación;

• Necesitas enviar un formulario de registro / solicitud / encuesta;

• Necesitas iniciar la generación de leads.

1

Creación de una plantilla con botón Flow

Crea la plantilla mediante addTemplate. Consulta el método y el ejemplo de creación en la documentación de la API.

2

Envío de la plantilla con botón Flow

Espera a que WhatsApp apruebe la plantilla creada. Tras la aprobación, envía la plantilla mediante sendTemplate. Consulta el método y el ejemplo de envío en la documentación de la API.

Envío de una plantilla con botón de tipo FLOW

Ejemplo de envío de una plantilla con botón de tipo flow:

  {
      "type": "button",
      "sub_type": "flow",
      "index": "0"
    }

Ejemplo de envío de una plantilla con botón de tipo flow incluyendo flow_token y flow_action_data.

Utiliza flow_action_data para pasar los datos iniciales al flow.

   {
      "type": "button",
      "sub_type": "flow",
      "index": "0",
      "parameters": [
        {
          "type": "action",
          "action": {
            "flow_token": "flow_demo_00001",
            "flow_action_data": {
                    "fname": "Anna",
                    "lname": "Stakina",
                    "age": "30"
            }
          }
        }
      ]
    }

Parameter	Description
flow_token	Parámetro opcional Token del flow generado por la empresa, utilizado como identificador.
flow_action_data	Parámetro opcional Objeto JSON con datos para la primera pantalla

3

Recibir el mensaje cuando el Flow se complete correctamente

Cuando el cliente termine de rellenar el formulario y lo envíe — recibirás una notificación por webhook. Si tienes activada la opción de guardado de mensajes — este mensaje entrante con los parámetros guardados del Flow se almacenará en el método messages.

La respuesta del cliente abre la ventana de 24 horas para seguir comunicándote o la amplía.

---

Lanzamiento de Flow mediante mensaje de servicio (gratuito)

Si el usuario ya ha escrito y la ventana está activa:

• El Flow se puede enviar como mensaje interactivo

• No se requiere plantilla

• No se requiere moderación previa del texto

1

Envío de un mensaje con botón Flow

Envía el escenario Flow mediante sendFlow sin aprobación previa de WhatsApp. Consulta el método y el ejemplo de envío en la documentación de la API.

Envío de un mensaje con botón FLOW

Ejemplo de botón flow:

{
  "body": "Please complete the flow.",
  "flowId": "25999010459692480",
  "flowToken": "flow_demo_25999010459692480",
  "flowCta": "Open flow"
}

Ejemplo de botón flow con flowActionPayload. Utiliza flowActionPayload para pasar los datos iniciales al flow.

{
  "phone": "{{phone}}",
  "header": "Header",
  "body": "Please complete the flow.",
  "footer": "Footer",
  "flowId": "{{flow_id}}",
  "flowToken": "flow_demo_1234",
  "flowMessageVersion": "3",
  "flowCta": "Button GO!",
  "flowAction": "navigate",
  "flowActionPayload": {
     "screen": "JOIN_NOW",
     "data": { 
           "fname": "Anna",
           "lname": "Stakina",
           "age": "30"
        }
    }
}

2

Recibir el mensaje cuando el Flow se complete correctamente

Cuando el cliente termine de rellenar el formulario y lo envíe — recibirás una notificación por webhook. Si tienes activada la opción de guardado de mensajes, este mensaje entrante con los parámetros guardados del Flow se almacenará en el método messages.