> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Versiones de Flow JSON de WhatsApp: congelación y caducidad

> Cómo versiona WhatsApp Flow JSON, la Data API y los mensajes de Flow, qué implica congelada y caducada para los Flows y qué versiones usa hoy Flowella.

Cada WhatsApp Flow declara la versión de Flow JSON en la que está escrito, y los Flows con endpoint también declaran una versión de Data API. Meta añade funciones en las versiones nuevas y retira las antiguas en dos pasos: una versión **congelada** ya no se puede publicar, y una versión **caducada** no se puede enviar ni abrir. Mantener los Flows en una versión compatible es lo que hace que sigan funcionando.

> [!NOTE]
>
> **En Flowella.** Compatible. Flowella escribe todos los Flows en Flow JSON **7.3**, la versión más reciente, y los Flows de formularios de HubSpot usan Data API **3.0**. Flowella no pasa por sí solo los Flows publicados a una versión nueva: un Flow usa la versión que Flowella escribe en el momento en que lo vuelves a sincronizar o publicar.

## Las tres versiones

| Versión | Formato | Qué controla |
| - | - | - |
| **Flow JSON** | `major.minor`, por ejemplo `7.3` | Qué componentes y propiedades puede usar el Flow, y cómo se comportan |
| **Data API** | `major.minor`, por ejemplo `3.0` | Cómo cifra y da formato a sus solicitudes un Flow con endpoint. Solo Flows con endpoint. |
| **Mensaje** | Un número entero, actualmente `3` | El formato de un mensaje de Flow interactivo |

Un cambio en el primer número es un cambio incompatible, así que puede que un Flow necesite modificaciones para pasar a esa versión. Un cambio en el segundo número añade funciones sin romper nada. Después de `1.9` viene `1.10`, no `2.0`.

## Congelada y caducada

| Estado | Publicación | Envío y apertura |
| - | - | - |
| **Compatible** | Permitida | Permitidos |
| **Congelada** | Rechazada. No puedes crear ni actualizar un Flow en esta versión. | Siguen permitidos |
| **Caducada** | Rechazada | Rechazados. Los clientes no pueden abrir Flows de esta versión, ni siquiera los que ya recibieron. |

Meta suele avisar con unos 90 días de antelación antes de congelar o caducar una versión, y anuncia las fechas en el changelog de Flows. Puede actuar más rápido por motivos de seguridad, y puede saltarse por completo el paso de congelación.

## Situación de las versiones

| Versión | Publicada | Estado en el changelog de Meta |
| - | - | - |
| 7.3 | Septiembre de 2025 | La más reciente, no congelada |
| 7.2, 7.1, 7.0 | De marzo a julio de 2025 | No congeladas |
| De 6.0 a 6.3 | De noviembre de 2024 a enero de 2025 | No congeladas |
| 5.1 | Septiembre de 2024 | No congelada |
| 5.0 | Agosto de 2024 | Congelada desde el 10 de septiembre de 2025 |
| 4.0, 3.1, 3.0, 2.1 | De 2023 a 2024 | Congeladas desde el 8 de abril de 2025 |

El changelog de Flows de Meta se actualizó por última vez el 11 de noviembre de 2025. Consúltalo antes de planificar una migración.

Data API **4.0**, publicada en noviembre de 2025, añade una firma opcional que demuestra que cada solicitud al endpoint procede de alguien que recibió el mensaje de Flow. Data API 3.0 sigue siendo compatible.

## Cambios incompatibles que conviene conocer

| Al pasar a | Qué cambió |
| - | - |
| 4.0 | Los grupos de casillas y de botones de opción necesitan una etiqueta. Los nombres de los campos no pueden estar vacíos. |
| 5.0 | Los selectores de fecha intercambian las fechas como `YYYY-MM-DD`, sin depender de la zona horaria |
| 6.0 | Los valores de texto no pueden estar vacíos ni contener solo espacios. Las imágenes de las opciones deben ocupar 100 KB o menos. |
| 7.0 | Seleccionar una opción ya no vuelve a ejecutar su acción cuando se abre de nuevo una pantalla |

## Qué hacer cuando Meta anuncia una congelación

* **Flows creados en Flowella**: usan la versión que escribe Flowella. Cuando Flowella pase a una versión más reciente, vuelve a sincronizar o publicar cada Flow para actualizarlo.
* **Flows creados en WhatsApp Manager o en otra herramienta**: hay que actualizarlos allí antes de que caduque la versión. Meta muestra avisos en su creador de Flows y envía webhooks de aviso de versión.
* **Antes de que caduque una versión**, sustituye cualquier plantilla cuyo Flow siga en ella, o los clientes que toquen el botón no podrán abrir el Flow.

## Relacionado

> [card] [Introducción a WhatsApp Flows](https://knowledge.flowella.io/es/whatsapp/flows/flows-overview.md)
>
> Cómo funcionan los Flows y sus estados.

> [card] [Componentes y límites de Flows](https://knowledge.flowella.io/es/whatsapp/flows/flow-components-and-limits.md)
>
> Qué puede mostrar cada versión.

> [card] [Endpoints y seguridad de Flows](https://knowledge.flowella.io/es/whatsapp/flows/flow-endpoints-and-security.md)
>
> Las versiones de Data API en la práctica.

> [card] [Cambios en la plataforma](https://knowledge.flowella.io/es/whatsapp/platform-changes.md)
>
> Próximos cambios de Meta que afectan a Flowella.

Comprobado con la documentación de Meta el 18 de noviembre de 2026: [Versioning](https://developers.facebook.com/documentation/business-messaging/whatsapp/flows/guides/versioning) y el [WhatsApp Flows changelog](https://developers.facebook.com/documentation/business-messaging/whatsapp/flows/changelog).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.