Qué contiene un archivo Flow JSON
Un Flow JSON tiene dos propiedades obligatorias: version y screens. Cada pantalla tiene un id, un title opcional que aparece en la barra superior y un layout de tipo SingleColumnLayout cuyos children son componentes: textos, campos, listas de opciones, selectores de fecha, consentimientos y un único botón Footer.
La navegación se define con acciones. Un Footer con navigate abre la siguiente pantalla; en la última, marcada como terminal, un Footer con complete cierra el Flow y envía el payload a la empresa junto con el flow token. Desde Flow JSON 4.0, cualquier pantalla puede leer campos de una pantalla anterior con ${screen.SCREEN_ID.form.field}, así que las plantillas dejan vacíos los payloads de navigate y reúnen todas las respuestas en el payload final de complete.
- version: la versión de Flow JSON, «7.3» en todas las plantillas.
- screens: la lista ordenada de pantallas; la primera sin rutas de entrada es la pantalla inicial.
- routing_model y data_api_version: solo para Flows que llaman a su endpoint de datos.
- terminal y success: marcan la última pantalla y si terminar allí cuenta como éxito.
Flows con o sin endpoint de datos
Las doce plantillas funcionan sin endpoint. No necesitan servidor: las opciones están escritas en el JSON, Meta genera el modelo de enrutamiento y usted recibe las respuestas en su webhook cuando el cliente completa el Flow. Meta recomienda los Flows sin endpoint siempre que no haga falta información en tiempo real, porque se abren antes y se crean más rápido.
Añada un endpoint cuando la pantalla dependa de datos en tiempo real: horarios disponibles, precios que cambian, stock o una comprobación contra la cuenta del cliente. Entonces las pantallas usan data_exchange, el Flow necesita data_api_version y un routing_model, y su endpoint debe descifrar cada petición y responder dentro del tiempo límite de Meta. Esa es la parte que desarrollamos y alojamos para nuestros clientes.
Límites de caracteres y reglas de los componentes
La mayoría de los Flows rechazados fallan por reglas pequeñas. Las etiquetas son cortas: 20 caracteres para un campo de texto, un área de texto o un desplegable, 30 para un grupo de opciones o casillas, 40 para un selector de fecha y 35 para el botón del Footer. Los títulos de opción admiten 30 caracteres y las descripciones 300. Un encabezado admite 80 caracteres y el texto de cuerpo 4.096.
Por pantalla puede usar hasta 50 componentes, un Footer, dos enlaces incrustados, tres imágenes y cinco consentimientos. Los id de pantalla solo pueden llevar letras y guiones bajos, y SUCCESS está reservado. Las etiquetas en árabe cuentan caracteres, no bytes. El validador comprueba todo esto y señala la pantalla que hay que corregir.
Flows en árabe y de derecha a izquierda para clientes del Golfo
Cada plantilla tiene una versión nativa en árabe con las mismas pantallas y los mismos nombres de campo, así que su código de webhook gestiona ambos idiomas sin cambios. WhatsApp muestra los Flows en árabe de derecha a izquierda en el teléfono del cliente, y la vista previa también.
La biblioteca incluye casos de uso importantes en el Golfo: altas a ofertas de Ramadán y Eid con envío después del iftar, reserva de mesa en restaurante, solicitudes de visita inmobiliaria y una lista de documentos KYC que pide al cliente no enviar fotos de su identificación por el chat.
Cómo enviar un Flow a sus clientes
Cuando publique un Flow, envíelo como mensaje interactivo de tipo flow con su Flow ID, un flow token que usted genera, un texto de botón corto y la primera pantalla. La biblioteca le da el payload del mensaje para cada plantilla. Los mensajes interactivos solo funcionan dentro de la ventana de atención al cliente de 24 horas; para escribir usted primero, vincule el Flow a una plantilla de mensaje aprobada con un botón de Flow.
Cuando el cliente termina, WhatsApp le muestra un resumen de sus respuestas y usted recibe el payload de complete en su webhook. Responda con un mensaje de confirmación que explique los siguientes pasos y cómo modificar o cancelar.