Crea un flujo de datos dinámico en WhatsApp

Crea un flujo de datos dinámico de WhatsApp en ChatMaxima con listas dependientes encadenadas que se llenan en vivo desde tu API, como Categoría a Producto.

Visión general

Un flujo de datos dinámico es un WhatsApp Flow cuyas listas se llenan en vivo desde tu propia API. Cada paso es una lista, y la elección del cliente en un paso decide lo que muestra el siguiente. El flujo guía al cliente a través de una cadena de selecciones dependientes.

Ejemplos habituales:

Salud: Médico, luego la Fecha disponible y, a continuación, la franja de Hora disponible.
Comercio electrónico: Categoría y luego Producto.
Servicios: Sucursal, luego Servicio y, después, Miembro del personal.

A diferencia del Constructor de formularios, las opciones no se escriben a mano. Cuando el cliente pasa a la siguiente pantalla, WhatsApp llama a un endpoint seguro de ChatMaxima, que llama a tu API y devuelve la siguiente lista. Nada está fijado en el código, así que el mismo flujo funciona para cualquier cadena de pasos que definas.

Cómo funciona

El cliente abre el flujo y ve la lista del primer paso.
Hace una selección.
WhatsApp envía esa selección al endpoint cifrado de ChatMaxima.
ChatMaxima llama a tu API para el siguiente paso, pasando las selecciones anteriores.
Aparece la siguiente lista. Esto se repite hasta la pantalla de resumen final.

Requisitos previos

Antes de empezar, asegúrate de tener:

Una cuenta de WhatsApp conectada: un número de la WhatsApp Cloud API vinculado a ChatMaxima.
Una API para cada paso: un endpoint HTTPS que devuelva una lista JSON de opciones.
La clave de cifrado configurada: una configuración única por cuenta de WhatsApp, que se describe a continuación.

Nota: Los flujos de datos dinámicos se basan en endpoints, por lo que WhatsApp requiere una clave de cifrado. Debes completar la configuración del cifrado antes de poder guardar un flujo dinámico.

Paso 1: Inicia un flujo de datos dinámico

Ve a Campañas, luego a WhatsApp Flows y haz clic en Crear flujo.
Introduce un nombre de flujo y elige una categoría.
Establece el tipo de flujo en Flujo de datos dinámico.

El constructor cambia a la vista de pasos dinámicos.

Paso 2: Configura la clave de cifrado

Un flujo de datos dinámico llama a un endpoint de ChatMaxima por cada pantalla, y WhatsApp exige que ese canal esté cifrado.

En la tarjeta Cifrado del endpoint, haz clic en Configurar clave de cifrado.
ChatMaxima genera un par de claves RSA para la cuenta y sube la clave pública a Meta automáticamente.

Esta es una acción única por cuenta de WhatsApp. Todos los flujos dinámicos de esa cuenta reutilizan la misma clave.

Paso 3: Añade pasos

Cada paso es una lista dependiente. Haz clic en Añadir paso y completa el editor del paso.

Campos del paso

Campo	Descripción
Título del paso	El encabezado de la pantalla; por ejemplo, `Select a Category`
Clave del paso	Un identificador en minúsculas; por ejemplo, `category`, referenciado después como `{category}`
Etiqueta de la lista	La etiqueta que se muestra sobre la lista
Método HTTP	`GET` o `POST` para la llamada a la API
URL de la API	El endpoint que devuelve las opciones de este paso
Autenticación	Ninguna, token Bearer, autenticación básica o encabezado personalizado

Pasar las selecciones anteriores

Para que un paso posterior dependa de uno anterior, coloca la clave del paso anterior en su URL de la API como marcador de posición. ChatMaxima lo reemplaza por la selección del cliente en tiempo de ejecución.

https://api.example.com/products?category={category}

En este ejemplo, la URL del paso product inserta la category elegida.

Paso 4: Asigna la respuesta de la API

La sección Asignación de la respuesta del editor del paso le indica a ChatMaxima cómo leer el JSON de tu API.

Campo	Descripción
Ruta de la lista	Ruta al array en la respuesta; por ejemplo, `data`. Déjalo en blanco si la respuesta ya es un array
Campo de ID	El campo que se usa como valor de la opción; por ejemplo, `id`
Campo de título	El campo que se muestra como texto principal de la opción; por ejemplo, `name`
Campo de descripción	Una línea secundaria opcional; por ejemplo, `price`

Se admite la notación con puntos para campos anidados, como price.amount.

Paso 5: Guarda y publica

Haz clic en Guardar flujo dinámico. ChatMaxima genera las pantallas del WhatsApp Flow a partir de tus pasos y las sube.
Abre el borrador guardado y haz clic en Publicar.

La pantalla final es un resumen que recapitula cada selección antes de que el cliente confirme.

Buenas prácticas

Usa claves de paso claras: cortas, en minúsculas y con significado, ya que aparecen en las URL.
Devuelve listas pequeñas: las listas de WhatsApp funcionan mejor con un conjunto acotado de opciones.
Ordena los pasos de lo general a lo específico: por ejemplo, Categoría antes que Producto.
Prueba cada API: confirma que cada endpoint devuelve el JSON esperado antes de guardar.

Solución de problemas

El guardado falla y pide la clave de cifrado

Abre la tarjeta Cifrado del endpoint.
Haz clic en Configurar clave de cifrado y espera la confirmación.
Vuelve a guardar el flujo dinámico.

Un paso muestra una lista vacía

Comprueba que la URL de la API es correcta y accesible por HTTPS.
Verifica que la ruta de la lista, el campo de ID y el campo de título coinciden con el JSON de tu API.
Confirma que cualquier {placeholder} de la URL coincide con la clave de un paso anterior.

Un paso no puede llegar a la API

La API debe ser un endpoint HTTPS público. Las direcciones internas o privadas están bloqueadas por seguridad.
Confirma que los datos de autenticación son correctos.