Los flujos de FlujosChat se pueden guardar como archivo JSON para copiarlos, revisarlos o moverlos a otra cuenta. Este capítulo te ayuda a usar esa opción sin perder referencias, sesiones ni mediciones.
Descargar un flujo
En Flujos, cada tarjeta tiene la acción Descargar JSON. Al pulsarla, el navegador guarda un archivo con nombre parecido a flujo_bienvenida.json. Ese archivo contiene la información del flujo y sus pasos en el mismo formato que acepta la importación.
Descárgalo antes de hacer cambios grandes, cuando quieras duplicar una idea en otra cuenta o cuando un equipo externo vaya a revisar la conversación. El export usa números de orden de paso para las referencias entre pasos, no identificadores internos de la cuenta original; por eso se puede reimportar sin que las ramas apunten a un flujo viejo.
Si lo llevas a otra cuenta, ten en cuenta lo que no viaja: los números de WhatsApp y el equipo de IA de rescate de la cuenta original se descartan al importar. El teléfono de aviso de compras y las imágenes de portada sí viajan tal cual, así que cambia el teléfono si los avisos no deben seguir llegando al dueño original.
Importar JSON
Abre la importación
En Flujos, haz clic en Importar JSON. Solo el propietario y los administradores ven esta acción.
Sube el archivo o pega el contenido
La ventana pide JSON del Flujo y acepta dos caminos: Subir Archivo —o arrastrar el.json descargado sobre el cuadro de texto— y pegar el contenido a mano. El archivo que subes se vuelca en el cuadro de texto, así que puedes revisarlo y corregirlo antes de importar. También tienes Cargar Ejemplo para ver una estructura válida antes de reemplazarla por la tuya.
Importa y revisa
Pulsa Importar Flujo. Si el archivo es válido, FlujosChat crea el flujo con sus pasos y transiciones y lo añade a tu lista. Después ábrelo, revisa el diagrama y prueba las ramas principales en el Playground.
El flujo importado puede nacer activo
"isActive": true por "isActive": false en el cuadro de texto antes de importar, o páusalo en su tarjeta nada más importarlo. La única excepción: si al llevarlo a otra cuenta se descartan todos sus números de WhatsApp, nace pausado.El JSON de un paso
Dentro de un flujo no hace falta descargarlo entero para ver el detalle de un paso. Haz doble clic sobre el paso en el diagrama y, al final del editor, abre JSON del paso (avanzado): es su configuración completa tal como la guarda el servidor, útil para campos que el formulario no muestra. Si lo cambias, pulsa Aplicar JSON al formulario y después Guardar; sin aplicar, el cambio no se guarda.
Sesiones activas
Una sesión es un cliente que está ahora mismo dentro de un flujo. La pantalla Sesiones activas muestra el total activo, la última actualización y el estado en vivo, y se recarga cada pocos segundos. Todavía no tiene entrada propia en el menú: se abre añadiendo /dashboard/flows/sessions a la dirección del panel.
Cada tarjeta muestra el contacto, el flujo, hace cuánto empezó, la última interacción y las variables guardadas. Si ves muchas sesiones antiguas, revisa si una pregunta no tiene rama de salida o si un paso de espera está dejando clientes pendientes demasiado tiempo.
Métricas por flujo
Desde la acción Métricas de una tarjeta puedes ver total de sesiones, completadas, activas y tasa de completación. No es un informe de ventas: mide cómo atraviesan los clientes ese flujo.
- Muchas sesiones y baja completación: simplifica opciones o añade una salida de ayuda.
- Muchas activas: revisa esperas, cobros o preguntas sin respuesta clara.
- Pocas sesiones: comprueba si el disparador, las palabras clave o el anuncio están bien configurados.
- Buena completación: duplica el flujo y adáptalo para otro producto o canal.
Errores comunes
Qué se comprueba antes de importar, y qué no
flow y steps, que el flujo tenga un nombre de 3 a 100 caracteres y un tipo de activación válido, y que cada paso tenga su orden, su tipo, un nombre y su configuración. Si algo de eso falla, la ventana muestra el error y no crea nada. Lo que no se comprueba es el contenido de cada paso: textos vacíos, más botones de los que admite WhatsApp o títulos demasiado largos se importan igual. Para eso está el Playground del flujo, que avisa de esos límites. La importación también cuenta para el máximo de flujos de tu plan.JSON inválido
Ocurre cuando falta una coma, sobra una llave o el archivo no es JSON. La pantalla lo marca como JSON inválido.
Faltan las partes principales
El archivo debe tener una sección de flujo y una lista de pasos. Si faltan, verás que el JSON debe contener flow y steps.
Referencias mal nombradas
En las ramas, el destino se indica con el orden del paso destino. Errores frecuentes son usar nombres de campo inventados, poner las transiciones fuera de cada paso o apuntar a un paso que no existe. Estos casos no impiden la importación: la referencia rota se descarta y el flujo se crea igual, y la ventana no te avisa. Por eso, después de importar, abre el diagrama y busca pasos sin flecha de salida o ramas que no lleguen a donde esperabas.
Crear con asistente
También puedes pedir a un asistente conectado por MCP que cree el flujo por ti y lo guarde en FlujosChat. Es útil cuando tienes la conversación pensada en lenguaje natural y quieres que el asistente arme el JSON correcto. La guía está en Conectar Claude y otros asistentes.