Introducción

¿Qué son los Flows?

Los Flows son formularios que se abren dentro de la propia conversación de WhatsApp. El cliente los rellena sin salir del chat y sin abrir el navegador, y tú recibes las respuestas estructuradas. Sirven para reservar citas, registro, encuestas de satisfacción, captación de leads, atención y inicio de sesión.

Los Flows pertenecen a la WABA, no al canal. Usa el wabaId de Listar WABAs en los endpoints de esta sección.

Categorías

Meta usa la categoría al revisar el flow. Elegir mal puede provocar el rechazo.

Categoría	Para qué sirve
`APPOINTMENT_BOOKING`	Reserva de cita
`LEAD_GENERATION`	Captación de leads
`SIGN_UP`	Registro de cuenta
`SIGN_IN`	Inicio de sesión / autenticación
`CONTACT_US`	Contacto
`CUSTOMER_SUPPORT`	Atención y soporte
`SURVEY`	Encuesta y satisfacción
`OTHER`	Cuando ninguna de las anteriores aplica

Ciclo de vida

Estado	Significado
`DRAFT`	En edición. Es el único estado en el que el `flow_json` puede cambiar y el flow se puede eliminar
`PUBLISHED`	Publicado y disponible para usarlo en mensajes. El `flow_json` queda congelado
`DEPRECATED`	No admite nuevas aperturas; las sesiones en curso continúan
`BLOCKED`	Bloqueado por Meta por incumplir una política
`THROTTLED`	Limitado por Meta debido a un exceso de errores en tu endpoint

Arma el flow_json

Define las pantallas, los componentes y el routing_model. Es un JSON, enviado como string en el campo flow_json.

Créalo en DRAFT

Usa Crear flow sin publish. Así todavía puedes iterar.

Corrige las incidencias

Consultar flow devuelve validation_errors con lo que señaló Meta.

Publica

Publicar flow. A partir de ahí el flow_json ya no cambia.

Estructura del `flow_json`

{
  "version": "7.0",
  "routing_model": { "WELCOME": ["DONE"], "DONE": [] },
  "screens": [
    {
      "id": "WELCOME",
      "title": "Reserva",
      "layout": {
        "type": "SingleColumnLayout",
        "children": [
          { "type": "TextHeading", "text": "Elige una hora" },
          {
            "type": "Form",
            "name": "form",
            "children": [
              { "type": "TextInput", "name": "nombre", "label": "Tu nombre", "input-type": "text", "required": true },
              { "type": "DatePicker", "name": "fecha", "label": "Fecha" },
              {
                "type": "Footer",
                "label": "Continuar",
                "on-click-action": { "name": "navigate", "next": { "type": "screen", "name": "DONE" }, "payload": {} }
              }
            ]
          }
        ]
      }
    }
  ]
}

Componentes disponibles

Grupo	Componentes
Texto	`TextHeading`, `TextSubheading`, `TextBody`, `TextCaption`
Multimedia	`Image`
Entrada	`TextInput`, `TextArea`, `DatePicker`
Selección	`Dropdown`, `RadioButtonsGroup`, `CheckboxGroup`
Consentimiento	`OptIn`

En TextInput, el input-type admite text, number, email, password, passcode y phone.

Acciones

Acción	Qué hace
`navigate`	Va a la pantalla siguiente, declarada en `next.name`
`complete`	Finaliza el flow y devuelve las respuestas
`data_exchange`	Llama a tu `endpoint_uri` a mitad del flow para decidir el siguiente paso

data_exchange exige tener endpoint_uri configurado. Si tu endpoint falla demasiado, Meta pone el flow en THROTTLED.

Endpoints

Listar flows

Consulta los flows de la WABA con su estado y categorías.

Crear flow

Crea un flow a partir de su flow_json.

Consultar flow

Busca un flow y sus incidencias de validación.

Actualizar flow

Cambia el nombre, las categorías o el flow_json.

Publicar flow

Deja el flow disponible para usarlo.

Descontinuar flow

Deja de aceptar nuevas aperturas.

Eliminar flow

Elimina un flow en DRAFT.

Sincronizar flows

Fuerza la actualización de estados con Meta.

Canales

Mensajes

Plantillas (WhatsApp)

Flows (WhatsApp)

Webhooks

¿Qué son los Flows?

Categorías

Ciclo de vida

Estructura del `flow_json`

Componentes disponibles

Acciones

Endpoints

Listar flows

Crear flow

Consultar flow

Actualizar flow

Publicar flow

Descontinuar flow

Eliminar flow

Sincronizar flows

​¿Qué son los Flows?

​Categorías

​Ciclo de vida

​Estructura del flow_json

​Componentes disponibles

​Acciones

​Endpoints

Listar flows

Crear flow

Consultar flow

Actualizar flow

Publicar flow

Descontinuar flow

Eliminar flow

Sincronizar flows

¿Qué son los Flows?

Categorías

Ciclo de vida

Estructura del `flow_json`

Componentes disponibles

Acciones

Endpoints