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

# Regras dos modelos WhatsApp: nomes, variáveis e limites

> As regras de todos os modelos WhatsApp: nomes, idiomas, variáveis numeradas e com nome, estados, quantos modelos pode ter e time-to-live.

Um modelo WhatsApp é uma mensagem que a Meta aprovou previamente. Os modelos são as únicas mensagens que pode enviar a alguém fora da [janela de atendimento ao cliente de 24 horas](https://knowledge.flowella.io/pt/whatsapp/messaging/customer-service-window.md), por isso todas as campanhas, lembretes e primeiros contactos usam um. Cada modelo pertence a uma WhatsApp Business Account, tem uma categoria e um idioma, e tem de estar **Approved** antes de o poder enviar.

> [!NOTE]
>
> **No Flowella.** Suportado. Cria modelos no [editor de modelos](https://knowledge.flowella.io/pt/app/templates.md), ou começa a partir da biblioteca da Meta ou de um modelo inicial do Flowella. O Flowella submete-os à Meta, mostra o estado atribuído pela Meta e envia os modelos aprovados a partir da Caixa de entrada, do envio em massa, dos workflows do HubSpot e da API. Os modelos que cria no WhatsApp Manager também aparecem no Flowella, porque a lista de modelos é lida a partir da Meta.

## De que é feito um modelo

| Parte | Obrigatória | Limite |
| - | - | - |
| **Cabeçalho** | Não | Texto (60 caracteres, uma variável), imagem, vídeo, documento ou localização |
| **Corpo** | Sim | 1.024 caracteres, com variáveis |
| **Rodapé** | Não | 60 caracteres |
| **Botões** | Não | Até 10 no total, com limites por tipo de botão |

Alguns modelos de marketing acrescentam partes próprias, como cartões de carrossel ou uma contagem decrescente de oferta. Para o detalhe de cada parte e os limites que o editor do Flowella aplica, consulte a [Referência de modelos](https://knowledge.flowella.io/pt/app/template-reference.md). Para ficheiros multimédia, consulte [Especificações multimédia](https://knowledge.flowella.io/pt/whatsapp/messaging/media-specs.md).

## Nomes

* Use apenas letras minúsculas, números e underscores, por exemplo `order_shipped_v2`. A Meta permite até 512 caracteres.
* Os nomes não têm de ser únicos. Pode dar o mesmo nome a modelos em idiomas diferentes, e é assim que oferece uma mensagem em vários idiomas.
* O mesmo nome no **mesmo** idioma é recusado. A Meta devolve o erro 2388024, que o Flowella mostra como **Content in This Language Already Exists**. Edite o modelo existente ou escolha um nome novo.
* Depois de eliminar um modelo aprovado, não pode reutilizar o nome durante 30 dias. Consulte [Manutenção de modelos](https://knowledge.flowella.io/pt/whatsapp/templates/template-housekeeping.md#delete-a-template).

## Idiomas

Cada modelo tem um [código de idioma](https://knowledge.flowella.io/pt/whatsapp/templates/supported-languages.md), como `en_GB` ou `pt_BR`. A Meta não traduz nada: escreve o texto e os valores de exemplo nesse idioma. Cada versão de idioma é um modelo separado, revisto individualmente e contado separadamente para o seu limite.

## Variáveis

As variáveis são marcadores que preenche no momento do envio, como um nome ou um número de encomenda. A Meta suporta dois formatos:

| Formato | Aspeto | Regras |
| - | - | - |
| **Posicional** (numerado) | `{{1}}`, `{{2}}` | Os números começam em 1 e seguem por ordem. Os valores são enviados pela mesma ordem. É o formato predefinido da Meta. |
| **Com nome** | `{{first_name}}`, `{{order_number}}` | Letras minúsculas e underscores, cada nome usado uma vez. Os valores são enviados pelo nome, por qualquer ordem. |

Um modelo usa um único formato do princípio ao fim. Cada variável precisa de um valor de exemplo quando submete, para que o revisor veja uma mensagem realista. Um corpo não pode começar nem terminar com uma variável, e demasiadas variáveis para o comprimento do texto levam à recusa do modelo. Consulte [Revisão de modelos](https://knowledge.flowella.io/pt/whatsapp/templates/template-review.md#common-rejection-reasons).

> [!NOTE]
>
> **No Flowella.** O editor cria variáveis posicionais e pede um **Fallback value** para cada uma, que a Meta revê como exemplo. O Flowella também pode enviar modelos que usam variáveis com nome, como os criados no WhatsApp Manager. Consulte [Variáveis de modelo](https://knowledge.flowella.io/pt/app/template-variables.md).

## Estados

A Meta revê cada modelo novo ou editado, normalmente em minutos e sempre em 24 horas. Depois, o estado muda ao longo da vida do modelo.

| Estado na Meta | O que significa | Apresentado no Flowella como |
| - | - | - |
| Em revisão (`PENDING`) | A Meta está a revê-lo | **Pending** |
| Aprovado (`APPROVED`) | Pronto a enviar. O WhatsApp Manager acrescenta uma etiqueta de qualidade, como **Active - Quality pending**. | **Approved** |
| Rejeitado (`REJECTED`) | A Meta recusou-o | **Rejected** |
| Em pausa (`PAUSED`) | Parado por agora, após feedback negativo ou taxas de leitura baixas | **Paused** |
| Desativado (`DISABLED`) | Parado após feedback negativo repetido | **Disabled** |
| Recurso pedido, arquivado, eliminação pendente, eliminado, sinalizado, bloqueado ou acima do limite | Não pode ser enviado | **Disabled** |

Os modelos guardados no Flowella mas ainda não publicados aparecem como **Draft**. A Meta não sabe nada sobre eles até os publicar. Para as pausas, consulte [Ritmo e pausa de modelos](https://knowledge.flowella.io/pt/whatsapp/limits/template-pacing-and-pausing.md). Para as ações de estado do editor, consulte [Estados dos modelos](https://knowledge.flowella.io/pt/app/template-reference.md#template-statuses).

## Quantos modelos pode ter

| O seu portfólio de negócios | Modelos por WhatsApp Business Account |
| - | - |
| Não verificado | 250 |
| [Verificado](https://knowledge.flowella.io/pt/whatsapp/accounts/business-verification.md), e pelo menos um número tem um [nome a apresentar](https://knowledge.flowella.io/pt/whatsapp/accounts/display-names.md) aprovado | 6.000 |

Cada versão de idioma conta como um modelo. Também não pode criar mais de 100 modelos numa WhatsApp Business Account numa hora.

Quando atinge o limite, a Meta recusa novos modelos com o erro 2388019. A mensagem do Flowella para este erro menciona 250, o limite para portfólios não verificados. Para libertar espaço, elimine os modelos que já não usa ou verifique a sua empresa para aumentar o limite. Consulte [Manutenção de modelos](https://knowledge.flowella.io/pt/whatsapp/templates/template-housekeeping.md).

## Outros limites de envio

A aprovação não significa que todos os envios são entregues. Aplicam-se ainda estes limites:

* [Limites de mensagens](https://knowledge.flowella.io/pt/whatsapp/limits/messaging-limits.md): com quantas pessoas pode iniciar conversas em 24 horas.
* [Ritmo e pausa de modelos](https://knowledge.flowella.io/pt/whatsapp/limits/template-pacing-and-pausing.md): a Meta retém ou para os modelos que recebem feedback negativo.
* [Limite de marketing por utilizador](https://knowledge.flowella.io/pt/whatsapp/limits/per-user-marketing-limit.md): o WhatsApp limita quantos modelos de marketing cada pessoa recebe.
* [Arquivo](https://knowledge.flowella.io/pt/whatsapp/templates/template-housekeeping.md#archival): os modelos sem utilização durante 12 meses são arquivados e depois eliminados.

## Time-to-live

Se o WhatsApp não conseguir entregar um modelo, por exemplo porque o telemóvel está desligado, continua a tentar durante um período chamado time-to-live (TTL). Depois disso, descarta a mensagem e não recebe o estado de entregue.

| Categoria | Predefinição da Meta | Intervalo que a Meta permite |
| - | - | - |
| Authentication | 10 minutos (30 dias para modelos criados antes de 23 de outubro de 2024) | 30 segundos a 15 minutos |
| Utility | 30 dias | 30 segundos a 12 horas |
| Marketing | 30 dias | 12 horas a 30 dias, apenas através da Marketing Messages API |

> [!NOTE]
>
> **No Flowella.** O Flowella não tem nenhuma definição de TTL, por isso os seus modelos usam as predefinições da Meta. Se a Meta mudar a categoria de um modelo, apaga qualquer TTL personalizado definido no WhatsApp Manager.

## Ordem de entrega

Quando envia várias mensagens seguidas à mesma pessoa, o WhatsApp não garante que cheguem pela ordem em que as enviou. Se a ordem for importante, aguarde o estado **delivered** da primeira mensagem antes de enviar a seguinte. Consulte [Estados das mensagens](https://knowledge.flowella.io/pt/whatsapp/messaging/message-statuses.md).

## Relacionado

> [card] [Categorias de modelos](https://knowledge.flowella.io/pt/whatsapp/templates/template-categories.md)
>
> Marketing, Utility ou Authentication, e quando a Meta a altera.

> [card] [Revisão de modelos](https://knowledge.flowella.io/pt/whatsapp/templates/template-review.md)
>
> Porque são rejeitados os modelos e como recorrer.

> [card] [Modelos no Flowella](https://knowledge.flowella.io/pt/app/templates.md)
>
> Crie, teste e gira modelos.

> [card] [Preços do WhatsApp](https://knowledge.flowella.io/pt/whatsapp/pricing/whatsapp-pricing.md)
>
> Quanto custa cada categoria.

Verificado com a documentação da Meta a 18 de novembro de 2026: [Template fundamentals](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/overview), [Template management](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-management) e [Time-to-live](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/time-to-live).


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