> ## 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.

# Versões do Flow JSON: congelamento e expiração

> Como o WhatsApp gere versões do Flow JSON, da Data API e das mensagens de Flow, o que congelada e expirada significam e que versões o Flowella usa.

Cada WhatsApp Flow declara a versão do Flow JSON em que está escrito, e os Flows com endpoint declaram também uma versão da Data API. A Meta acrescenta funcionalidades em novas versões e retira as antigas em duas etapas: uma versão **congelada** já não pode ser publicada, e uma versão **expirada** não pode ser enviada nem aberta. Manter os Flows numa versão suportada é o que os mantém a funcionar.

> [!NOTE]
>
> **No Flowella.** Suportado. O Flowella escreve todos os Flows em Flow JSON **7.3**, a versão mais recente, e os Flows de formulários HubSpot usam a Data API **3.0**. O Flowella não passa os Flows publicados para uma nova versão por iniciativa própria: um Flow usa a versão que o Flowella escreve no momento em que o volta a sincronizar ou publicar.

## As três versões

| Versão | Formato | Controla |
| - | - | - |
| **Flow JSON** | `major.minor`, por exemplo `7.3` | Que componentes e propriedades o Flow pode usar, e como se comportam |
| **Data API** | `major.minor`, por exemplo `3.0` | Como um Flow com endpoint encripta e formata os pedidos. Apenas Flows com endpoint. |
| **Mensagem** | Um número inteiro, atualmente `3` | O formato de uma mensagem de Flow interativa |

Uma alteração no primeiro número é uma alteração incompatível, por isso um Flow pode precisar de ajustes para passar para essa versão. Uma alteração no segundo número acrescenta funcionalidades sem quebrar nada. Depois de `1.9` vem `1.10`, e não `2.0`.

## Congelada e expirada

| Estado | Publicação | Envio e abertura |
| - | - | - |
| **Suportada** | Permitida | Permitidos |
| **Congelada** | Recusada. Não pode criar nem atualizar um Flow nesta versão. | Continuam permitidos |
| **Expirada** | Recusada | Recusados. Os clientes não conseguem abrir Flows nesta versão, mesmo os que já receberam. |

A Meta costuma avisar com cerca de 90 dias de antecedência antes de uma versão congelar ou expirar, e anuncia as datas no changelog de Flows. Pode agir mais depressa por motivos de segurança e pode saltar totalmente a etapa de congelamento.

## Situação das versões

| Versão | Lançamento | Estado no changelog da Meta |
| - | - | - |
| 7.3 | Setembro de 2025 | Mais recente, não congelada |
| 7.2, 7.1, 7.0 | Março a julho de 2025 | Não congeladas |
| 6.0 a 6.3 | Novembro de 2024 a janeiro de 2025 | Não congeladas |
| 5.1 | Setembro de 2024 | Não congelada |
| 5.0 | Agosto de 2024 | Congelada desde 10 de setembro de 2025 |
| 4.0, 3.1, 3.0, 2.1 | 2023 a 2024 | Congeladas desde 8 de abril de 2025 |

O changelog de Flows da Meta foi atualizado pela última vez a 11 de novembro de 2025. Consulte-o antes de planear uma migração.

A Data API **4.0**, lançada em novembro de 2025, acrescenta uma assinatura opcional que prova que cada pedido ao endpoint veio de alguém que recebeu a mensagem de Flow. A Data API 3.0 continua suportada.

## Alterações incompatíveis a conhecer

| Ao passar para | O que mudou |
| - | - |
| 4.0 | Os grupos de caixas de seleção e de botões de opção precisam de uma etiqueta. Os nomes dos campos não podem estar vazios. |
| 5.0 | Os seletores de data trocam datas como `YYYY-MM-DD`, independentemente do fuso horário |
| 6.0 | Os valores de texto não podem estar vazios nem conter apenas espaços. As imagens das opções têm de ter 100 KB ou menos. |
| 7.0 | Selecionar uma opção deixa de voltar a executar a respetiva ação quando um ecrã é reaberto |

## O que fazer quando a Meta anuncia um congelamento

* **Os Flows construídos no Flowella** usam a versão que o Flowella escreve. Quando o Flowella passar para uma versão mais recente, volte a sincronizar ou publicar cada Flow para o atualizar.
* **Os Flows construídos no WhatsApp Manager ou noutra ferramenta** têm de ser atualizados aí antes de a versão expirar. A Meta mostra avisos no seu construtor de Flows e envia webhooks de aviso de versão.
* **Antes de uma versão expirar**, substitua qualquer modelo cujo Flow ainda a use, caso contrário os clientes que tocarem no botão não conseguem abrir o Flow.

## Relacionado

> [card] [Visão geral dos WhatsApp Flows](https://knowledge.flowella.io/pt/whatsapp/flows/flows-overview.md)
>
> Como funcionam os Flows e os seus estados.

> [card] [Componentes e limites de Flows](https://knowledge.flowella.io/pt/whatsapp/flows/flow-components-and-limits.md)
>
> O que cada versão pode mostrar.

> [card] [Endpoints e segurança de Flows](https://knowledge.flowella.io/pt/whatsapp/flows/flow-endpoints-and-security.md)
>
> As versões da Data API na prática.

> [card] [Alterações à plataforma](https://knowledge.flowella.io/pt/whatsapp/platform-changes.md)
>
> Próximas alterações da Meta que afetam o Flowella.

Verificado com base na documentação da Meta a 18 de novembro de 2026: [Versioning](https://developers.facebook.com/documentation/business-messaging/whatsapp/flows/guides/versioning) e o [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.