Saltar para o conteúdo principal
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.
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

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

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

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

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.

Visão geral dos WhatsApp Flows

Como funcionam os Flows e os seus estados.

Componentes e limites de Flows

O que cada versão pode mostrar.

Endpoints e segurança de Flows

As versões da Data API na prática.

Alterações à plataforma

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 e o WhatsApp Flows changelog.
Última modificação em 21 de novembro de 2026