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

# WhatsApp Flows explicados: ecrãs, estados e regras

> O que são WhatsApp Flows, Flows estáticos e com endpoint, os estados de um Flow, o que a Meta exige antes de publicar e como o Flowella os constrói.

Um WhatsApp Flow é um formulário ou uma pequena app que abre dentro de uma conversa WhatsApp. O cliente toca num botão, surge um ecrã com perguntas, listas pendentes, seletores de data ou caixas de consentimento, e as respostas chegam até si quando o cliente submete. Os Flows são definidos em **Flow JSON**, publicados na Meta e enviados a partir de um botão de modelo ou de uma mensagem interativa.

> [!NOTE]
>
> **No Flowella.** Suportado. O Flowella constrói Flows a partir dos seus formulários HubSpot, ou de raiz no [Flow designer](https://knowledge.flowella.io/pt/app/flow-designer.md), e publica-os por si, por isso nunca tem de escrever Flow JSON. O Flowella envia Flows a partir do botão Flow de um modelo e regista todas as submissões. Consulte [Flows](https://knowledge.flowella.io/pt/app/flows.md).

## Os elementos básicos

| Termo | O que significa |
| - | - |
| **Flow** | Uma tarefa que o cliente conclui, como "Marcar uma visita" ou "Pedir um orçamento" |
| **Ecrã** | Uma página do Flow, com os seus próprios componentes e um botão na parte inferior |
| **Componente** | Um elemento num ecrã: texto, um campo de introdução, uma lista, um seletor de data, um opt-in, uma imagem |
| **Flow JSON** | A definição dos ecrãs e componentes, com um número de versão. Consulte [Versões do Flow JSON](https://knowledge.flowella.io/pt/whatsapp/flows/flow-json-versions.md). |
| **Endpoint** | Um servidor opcional que o Flow chama para carregar dados ou verificar respostas enquanto o cliente o preenche |
| **Flow token** | Um identificador que a empresa define quando envia o Flow, devolvido com as respostas para que possam ser associadas à pessoa certa |

## Flows estáticos e Flows com endpoint

| | Flow estático | Flow com endpoint |
| - | - | - |
| Como funciona | Está tudo no Flow JSON. As respostas chegam quando o cliente termina. | O Flow chama o seu servidor durante a execução, por exemplo para verificar respostas ou carregar opções. |
| Monitorização do estado | Nenhuma | A Meta monitoriza o servidor e pode limitar ou bloquear o Flow. Consulte [Estado dos Flows](https://knowledge.flowella.io/pt/whatsapp/flows/flow-health.md). |
| Configuração | Nenhuma além da publicação | Uma chave de encriptação no número de telefone e um servidor que responda às verificações de estado. Consulte [Endpoints e segurança de Flows](https://knowledge.flowella.io/pt/whatsapp/flows/flow-endpoints-and-security.md). |

> [!NOTE]
>
> **No Flowella.** Os Flows construídos a partir de formulários HubSpot são Flows com endpoint: o Flowella aloja o endpoint, que verifica cada submissão com base no formulário HubSpot atual antes de o cliente ver o ecrã de agradecimento. Os Flows do Flow designer e da API Flowella são estáticos.

## O que a Meta exige

Qualquer pessoa pode construir um Flow, mas para o publicar e enviar a Meta exige:

* Uma [empresa verificada](https://knowledge.flowella.io/pt/whatsapp/accounts/business-verification.md).
* Um número de telefone registado na WhatsApp Business Account.
* Uma boa classificação de qualidade de mensagens. Consulte [Classificação de qualidade](https://knowledge.flowella.io/pt/whatsapp/limits/quality-score.md).
* Flow JSON válido numa versão que não esteja congelada nem expirada.
* Para Flows com endpoint, uma chave de encriptação assinada no número e um endpoint saudável.

No Flowella, um requisito em falta aparece como um distintivo, como **Verification required** ou **Registration required**, quando sincroniza. Consulte [Erros de sincronização](https://knowledge.flowella.io/pt/app/flows.md#sync-errors).

## Os estados de um Flow

| Estado | Definido por | O que significa |
| - | - | - |
| **Draft** | Você | Em construção. Só pode ser enviado para testes e mostra uma faixa de rascunho. O único estado em que um Flow pode ser eliminado. |
| **Published** | Você | Ativo. Pode ser enviado a qualquer pessoa. |
| **Throttled** | WhatsApp | O endpoint ou a navegação entre ecrãs não está saudável. Os clientes continuam a poder abri-lo, mas só o pode enviar 10 vezes por hora. |
| **Blocked** | WhatsApp | O estado piorou. Não o pode enviar, e os clientes não conseguem abrir os Flows que já receberam. |
| **Deprecated** | Você | Retirado definitivamente. Não pode ser enviado, mas os clientes que já o têm podem ainda submetê-lo. |

Os estados Throttled e Blocked aplicam-se apenas a Flows com endpoint. O WhatsApp devolve um Flow a Throttled e depois a Published quando o estado recupera.

> [!NOTE]
>
> **No Flowella.** Uma sincronização publica de imediato, sem etapa de rascunho. O Flowella recusa-se a enviar um modelo cujo Flow esteja deprecated. Para Flows que gere através da API Flowella, `GET /v1/flows/{id}` atualiza o estado a partir da Meta e o webhook `flow.status_updated` comunica as alterações. Consulte [Webhooks](https://knowledge.flowella.io/pt/api-reference/webhooks.md).

## Como um Flow chega ao cliente

| Via | Quando a pode usar |
| - | - |
| **Modelo com um botão Flow** | A qualquer momento, depois de o modelo ser aprovado. É assim que inicia uma conversa com um Flow. |
| **Mensagem de Flow interativa** | Apenas enquanto a [janela de 24 horas](https://knowledge.flowella.io/pt/whatsapp/messaging/customer-service-window.md) do cliente estiver aberta |

Consulte [Enviar Flows](https://knowledge.flowella.io/pt/whatsapp/flows/sending-flows.md).

## Onde os Flows funcionam

Os Flows abrem em Android 6.0 ou posterior e em iOS 12 ou posterior. A Meta acrescentou o WhatsApp Web e Desktop a partir de dezembro de 2025. Consulte [Suporte de clientes para Flows](https://knowledge.flowella.io/pt/whatsapp/flows/flows-client-support.md).

## Relacionado

> [card] [Flows no Flowella](https://knowledge.flowella.io/pt/app/flows.md)
>
> Transforme um formulário HubSpot num Flow.

> [card] [Flow designer](https://knowledge.flowella.io/pt/app/flow-designer.md)
>
> Construa um Flow sem HubSpot.

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

> [card] [Códigos de erro de Flows](https://knowledge.flowella.io/pt/whatsapp/errors/flows-error-codes.md)
>
> Erros de publicação e de envio.

Verificado com base na documentação da Meta a 18 de novembro de 2026: [WhatsApp Flows overview](https://developers.facebook.com/documentation/business-messaging/whatsapp/flows/guides), [Lifecycle of a Flow](https://developers.facebook.com/documentation/business-messaging/whatsapp/flows/guides/lifecycle) e [Sending a Flow](https://developers.facebook.com/documentation/business-messaging/whatsapp/flows/guides/sendingaflow).


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