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

# Componentes e limites de caracteres dos WhatsApp Flows

> Todos os componentes de WhatsApp Flows com os limites da Meta: componentes por ecrã, texto e etiquetas, opções por lista, imagens, opt-ins e ficheiros.

Cada ecrã de um WhatsApp Flow é construído a partir de componentes: texto, campos de introdução, listas, seletores, opt-ins, imagens e um botão de rodapé. A Meta limita quantos componentes um ecrã pode ter e o comprimento de cada etiqueta e opção. Quando um Flow ultrapassa um limite, a Meta recusa-se a publicá-lo. Quando o texto é longo mas está dentro dos limites, o WhatsApp pode cortá-lo em telemóveis mais pequenos.

> [!NOTE]
>
> **No Flowella.** Parcialmente suportado. O Flowella constrói Flows a partir de um conjunto destes componentes e verifica os principais limites antes de publicar. Os campos de formulário do HubSpot correspondem ao componente mais próximo. Consulte [Como os campos HubSpot são convertidos](https://knowledge.flowella.io/pt/app/flows.md#how-hubspot-fields-convert) e o [Flow designer](https://knowledge.flowella.io/pt/app/flow-designer.md). O Flowella não usa listas de navegação, seletores de chips, seletores de calendário nem carrosséis de imagens.

## Limites por ecrã

| Limite | Máximo |
| - | - |
| Componentes | 50 |
| Rodapé (o botão na parte inferior) | 1 |
| Opt-ins | 5 |
| Links incorporados | 2 |
| Imagens | 3 |
| Seletores de fotos ou de documentos | 1 |

> [!NOTE]
>
> **No Flowella.** As caixas de consentimento de um formulário do HubSpot passam a opt-ins, por isso contam para os 5. Se um formulário do HubSpot precisar de mais de 50 componentes, o Flowella remove os blocos de rich text e mantém todas as perguntas.

## Texto

| Componente | Limite |
| - | - |
| Título | 80 caracteres |
| Subtítulo | 80 caracteres |
| Corpo | 4.096 caracteres |
| Legenda | 409 caracteres |
| Rich text | Para conteúdo longo, como termos. A partir do Flow JSON 6.3, pode partilhar um ecrã com o rodapé. |

O texto não pode estar vazio nem conter apenas espaços. O texto do corpo e das legendas suporta negrito, itálico, rasurado, links e listas simples.

## Campos de introdução

| Componente | Limites |
| - | - |
| **Text input** (uma linha) | Etiqueta com 20 caracteres, texto de ajuda com 80, texto de erro com 30. Respostas até 80 caracteres por predefinição. Tipos: text, number, email, password, passcode, phone. |
| **Text area** (várias linhas) | Etiqueta com 20 caracteres, texto de ajuda com 80. Respostas até 600 caracteres por predefinição. |
| **Date picker** | Etiqueta com 40 caracteres, texto de ajuda e de erro com 80. A partir do Flow JSON 5.0, as datas são trocadas como `YYYY-MM-DD`, independentemente do fuso horário. |
| **Calendar picker** | Data única ou intervalo. Título com 80 caracteres, descrição com 300, etiqueta com 40. |

## Escolhas

| Componente | Opções | Limites de texto |
| - | - | - |
| **Radio buttons** (escolher uma) | 1 a 20 | Etiqueta e título da opção com 30 caracteres, descrição com 300 |
| **Checkboxes** (escolher várias) | 1 a 20 | Etiqueta e título da opção com 30 caracteres, descrição com 300 |
| **Dropdown** | 1 a 200, ou 100 se as opções tiverem imagens | Etiqueta com 20 caracteres, título da opção com 30, descrição com 300 |
| **Opt-in** | Uma caixa de seleção | 120 caracteres, com um link **Read more** opcional |

A partir do Flow JSON 6.0, as imagens das opções têm de ter 100 KB ou menos. As imagens WebP não aparecem em versões do iOS anteriores à 14.

## Botões e links

| Componente | Limites |
| - | - |
| **Footer** | Etiqueta com 35 caracteres, legendas com 15 caracteres. Um por ecrã. |
| **Embedded link** | 25 caracteres, 2 por ecrã |

## Imagens e ficheiros

| Componente | Limites |
| - | - |
| **Image** | JPEG ou PNG, idealmente com menos de 300 KB, 3 por ecrã |
| **Photo picker** e **document picker** | Permitem ao cliente anexar imagens ou documentos. Até 10 ficheiros numa resposta, 100 MB no total. |

> [!WARNING]
>
> O Flowella guarda as fotos que os clientes carregam no HubSpot como ficheiros públicos. Não peça documentos de identificação nem outras imagens sensíveis. Consulte [Limites e armadilhas](https://knowledge.flowella.io/pt/app/flows.md#limits-and-gotchas).

## Lógica

Os componentes **If** e **Switch** mostram ou ocultam partes de um ecrã com base em respostas anteriores, sem chamar um endpoint. Pode aninhar até três componentes **If**. Um rodapé dentro de um **If** tem de aparecer em ambos os ramos. No Flowella, defina as condições no [separador Logic](https://knowledge.flowella.io/pt/app/flow-designer.md#logic-tab) do designer.

## Manter os Flows legíveis

Os limites são máximos, não objetivos. O WhatsApp encurta etiquetas e títulos de opções longos para caberem no ecrã, por isso uma etiqueta que cabe num telemóvel grande pode ficar cortada num pequeno. Para regras práticas, consulte [Boas práticas de design de formulários](https://knowledge.flowella.io/pt/app/form-design-best-practices.md).

## Relacionado

> [card] [Boas práticas de design de formulários](https://knowledge.flowella.io/pt/app/form-design-best-practices.md)
>
> Etiquetas e perguntas que cabem.

> [card] [Códigos de erro de Flows](https://knowledge.flowella.io/pt/whatsapp/errors/flows-error-codes.md)
>
> O que acontece quando um limite é ultrapassado.

> [card] [Versões do Flow JSON](https://knowledge.flowella.io/pt/whatsapp/flows/flow-json-versions.md)
>
> Que versão introduziu o quê.

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

Verificado com base na documentação da Meta a 18 de novembro de 2026: [Components](https://developers.facebook.com/documentation/business-messaging/whatsapp/flows/guides/components), [Media upload components](https://developers.facebook.com/documentation/business-messaging/whatsapp/flows/guides/media_upload) e [Best practices](https://developers.facebook.com/documentation/business-messaging/whatsapp/flows/guides/bestpractices).


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