> ## 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.
# Criar, testar e enviar em massa modelos WhatsApp
> Construa modelos WhatsApp aprovados pela Meta com cabeçalhos, corpo e botões, teste num dispositivo real e depois envie em massa com importação CSV ou Excel, agendamento e progresso em direto.
Os modelos WhatsApp são formatos de mensagem pré-aprovados que lhe permitem enviar mensagens estruturadas aos seus contactos. São essenciais para alcançar pessoas fora da janela de 24 horas de serviço ao cliente — para notificações, atualizações, lembretes e mais. Os modelos podem incluir media rica, como imagens e vídeos, variáveis de texto dinâmicas e botões interativos.
## O que são modelos e por que precisam de aprovação Meta
Como os modelos WhatsApp são enviados fora da janela padrão de conversa, a Meta revê cada modelo antes de poder ser usado. O processo de aprovação garante que as mensagens cumprem os padrões de qualidade e políticas empresariais do WhatsApp. Motivos comuns de rejeição incluem linguagem excessivamente promocional, conteúdo enganador ou má gramática, portanto compensa manter o seu texto claro e focado em valor genuíno para o destinatário.
Uma vez a Meta aprova um modelo, pode usá-lo em fluxos de trabalho Flowella, flows automatizados, campanhas e envios manuais da caixa de entrada. Quaisquer alterações à estrutura de um modelo exigem resubmissão — mas as variáveis dinâmicas permitem-lhe personalizar cada mensagem sem aprovações adicionais.
A aprovação é frequentemente quase instantânea. A Meta executa uma revisão automática de primeira fase que aprova a maioria dos modelos em minutos, mas qualquer coisa encaminhada para revisão humana pode demorar **até 48 horas**. Submeta com antecedência para que uma revisão mais lenta nunca bloqueie um envio de produção.
À procura de uma referência rápida sobre categorias, formatos de cabeçalho, tipos de botão, a sintaxe de variáveis `{{n}}` ou o ciclo de vida da submissão? Consulte [Referência do modelo](/pt/app/template-reference).
## Criar um modelo
### Escolher um ponto de partida
Clicar em **Novo modelo** (ou navegar para `/{org}/templates/new`) abre um seletor com três formas de começar:
* **Crie o seu próprio** — escreva a mensagem você mesmo. Escolha uma de duas opções:
* **Mensagem padrão** — abra o editor em branco para um modelo com cabeçalho, corpo, rodapé e botões opcionais.
* **Carrossel** (marcado como **NEW**) — abra o editor de carrossel para construir um conjunto deslizável de cartões de imagem ou vídeo. Consulte [Construir um modelo carrossel](#build-a-carousel-template).
* **Meta Library** — navegue pelo próprio catálogo de modelos de utility pré-construídos da Meta. São pré-avaliados pela Meta e normalmente aprovados rapidamente.
* **Modelos Flowella** — um catálogo curado de modelos iniciais que mostram as capacidades do Flowella (botões de Flow, cupões, re-engajamento, etc.).
O **Carrossel** permanece desativado até ligar um número WhatsApp. Cada cartão precisa da sua própria imagem ou vídeo, e o Flowella carrega essa media para a Meta através do seu número ligado. Passe o cursor sobre a opção desativada para ver uma dica que explica isto.
Pode fazer deep-link diretamente para uma opção específica com o parâmetro de consulta `entry`: `?entry=meta`, `?entry=flowella`, `?entry=scratch` (mensagem padrão) ou `?entry=carousel`. O passo **Crie o seu primeiro modelo** do guia de configuração de integração usa `?entry=meta` para aterrar diretamente na Meta Library.
Ambas as galerias renderizam **cartões de pré-visualização WhatsApp partilhados** para que o que vê enquanto navega corresponda à forma como os modelos são renderizados no catálogo — mesma pré-visualização de cabeçalho, corpo e botões.
#### Galeria Meta Library
A galeria Meta Library permite-lhe pesquisar o catálogo de modelos de utility da Meta e adicionar modelos sem os reescrever.
* **Pesquisa** — escreva para filtrar por nome; os resultados são "debounced" e guardados em cache por cerca de uma hora por WABA.
* **Filtro de idioma** — por defeito, a galeria é filtrada pelo idioma WhatsApp derivado do **idioma de conteúdo** da sua organização (definido em **Definições → Organização**). Alterne **Todos os idiomas** para navegar por todas as regiões Meta.
* **Abrir como rascunho** — clique em **Abrir como rascunho** num cartão para instanciar esse modelo como um rascunho local e ir diretamente para o editor. Nada é submetido à Meta até clicar em **Publicar**.
* **Adicionar em multi-seleção** — marque a caixa de seleção em vários cartões, depois clique em **Criar rascunhos (**{count}**)** para instanciar todos os modelos selecionados de uma só vez. Em caso de sucesso, o Flowella devolve-o à lista de modelos.
Seleções da Library abrem sempre como **rascunhos locais** na sua WABA. Pode renomear, editar variáveis, adicionar botões ou alterar categorias antes de publicar — a entrada Meta Library é apenas um ponto de partida.
#### Galeria de Modelos Flowella
A galeria de Modelos Flowella lista iniciadores curados mantidos pelo Flowella (fluxos de estado de encomenda, promoções de cupões, lembretes de agendamento, etc.). Escolha um iniciador para pré-preencher o editor com um rascunho pronto a personalizar, e depois publique na Meta quando estiver satisfeito. Nos bastidores, a galeria coloca-o no editor via `?starter=`.
### Preencher o editor
Introduza um nome descritivo que reflita o propósito do modelo.
Use apenas letras minúsculas, números e sublinhados — por exemplo, `order_confirmation` ou `appointment_reminder`. Espaços e caracteres especiais não são permitidos pela Meta.
Opcionalmente, adicione uma imagem ou vídeo como cabeçalho do modelo para tornar a sua mensagem mais envolvente.
A media de cabeçalho é opcional, mas recomendada. Imagens devem ter menos de 5 MB e vídeos menos de 10 MB. Vídeos devem ter menos de 60 segundos e abrir com um frame envolvente.
Introduza o texto principal do corpo do seu modelo. Mantenha-o claro, conciso e relevante para o seu público.
Use chavetas duplas para adicionar variáveis dinâmicas — por exemplo, `Olá {{1}}, a sua encomenda {{2}} está pronta para levantamento!`. Estas são substituídas por dados reais do contacto quando o Flowella envia a mensagem.
Evite linguagem excessivamente promocional. A revisão da Meta procura mensagens que forneçam valor claro para o destinatário.
Clique em **Adicionar um botão ao seu modelo** para incluir um elemento interativo.
Botões dão aos contactos um próximo passo claro e aumentam o envolvimento. Pode adicionar até três botões por modelo.
Escolha o tipo de botão que se adequa ao seu caso de uso:
* **Botão de call-to-action** — direciona os utilizadores para um website ou número de telefone.
* **Botão de resposta rápida** — permite aos utilizadores responder com texto predefinido.
* **Botão URL** — envia os utilizadores para uma página web específica.
Pode misturar tipos de botão no mesmo modelo. Por exemplo, combine um botão URL etiquetado "Ver encomenda" com um botão de resposta rápida etiquetado "Contactar suporte".
Introduza a ação ou destino para o botão — por exemplo, um número de telefone para um botão de chamada ou um URL para um botão de link.
Introduza a etiqueta que aparecerá no botão. Torne-a orientada à ação e clara — por exemplo, "Saber mais", "Contactar-nos" ou "Começar".
O texto do botão tem um limite de 25 caracteres. Use verbos de ação curtos e torne óbvio o que acontece quando o botão é tocado.
Clique em **Criar modelo** para guardar e submeter o seu modelo.
Submeter o modelo envia-o à Meta para revisão. Isto é frequentemente quase instantâneo, uma vez que a maioria dos modelos passa a revisão automática da Meta em minutos, embora alguns sejam encaminhados para revisão humana e possam levar até 48 horas.
Durante a revisão, a Meta verifica a conformidade com a política. Certifique-se de que o seu modelo fornece valor claro aos destinatários e evita linguagem promocional que possa levar a rejeição.
Modelos submetidos aterram no estado **Pending**. A maioria passa a revisão automática da Meta em minutos; alguns são encaminhados para revisão humana.
A Meta diz-lhe que a aprovação **pode levar até 12 horas** e o Flowella **enviar-lhe-á email** assim que o estado mudar. Não precisa de continuar a atualizar a página.
Uma vez que a Meta aprova o modelo, pode usá-lo em fluxos de trabalho Flowella, flows automatizados, a caixa de entrada e envios em massa.
### Construir um modelo carrossel
Um modelo carrossel envia uma bolha de mensagem seguida de uma fila de cartões que o destinatário percorre lateralmente. Cada cartão tem a sua própria imagem ou vídeo, texto opcional e botões. Use um carrossel para mostrar vários produtos, ofertas ou opções numa única mensagem de marketing.
**Pré-requisitos:** um número WhatsApp ligado e um ficheiro de imagem ou vídeo para cada cartão.
Clique em **Novo modelo** e depois em **Carrossel** no cartão **Crie o seu próprio**. O editor abre com um distintivo **Carousel · {count} cards** junto ao nome do modelo.
Introduza o texto de corpo que aparece na bolha de mensagem acima dos cartões. A categoria está bloqueada em **Marketing**. Os carrosséis não têm cabeçalho, rodapé nem botões ao nível da mensagem. Em vez disso, os botões ficam em cada cartão.
Em **Estrutura do cartão**, escolha o **Tipo de media** para todos os cartões: **Imagem** ou **Vídeo**. Todos os cartões usam o mesmo tipo de media. Ative **Corpo do cartão** se quiser texto em cada cartão. Quando o ativa, cada cartão precisa de texto de corpo, até **160 caracteres** por cartão.
Em **Botões do cartão**, adicione até **2 botões**. Cada botão é um **Quick reply**, **Link** ou **Número de telefone**. Todos os cartões recebem os mesmos tipos de botões pela mesma ordem. Define a etiqueta, o link ou o número de telefone de cada botão no próprio cartão, para que cada cartão possa apontar para um sítio diferente.
Um novo carrossel começa com 2 cartões. Clique em **Adicionar cartão** para adicionar mais, até **10 cartões**. Em cada cartão, carregue a imagem ou o vídeo, escreva o texto do cartão e defina as etiquetas e os valores dos botões.
A pré-visualização mostra os cartões como uma faixa lateral, tal como o WhatsApp os apresenta. Clique em **Publicar** para submeter o carrossel à Meta.
#### Gerir cartões
* **Reordenar** — arraste um cartão pela sua pega. Para usar o teclado, foque a pega de arrastamento e prima a tecla de seta para cima ou para baixo. Também pode usar **Mover para cima** e **Mover para baixo**.
* **Duplicar** — clique em **Duplicar** para copiar um cartão. O Flowella copia o texto, os botões e as amostras de variáveis, mas limpa a media. Carregue uma nova imagem ou vídeo na cópia.
* **Eliminar** — clique em **Eliminar** para remover um cartão. Um carrossel precisa de pelo menos 2 cartões.
Se alterar o número de cartões de um modelo que já submeteu, o Flowella avisa-o de que o modelo volta ao WhatsApp para revisão. Clique em **Alterar número de cartões** para continuar ou em **Cancelar** para manter os cartões atuais.
#### Media dos cartões
| Tipo de media | Formatos | Tamanho máximo |
| - | - | - |
| Imagem | JPEG ou PNG | 5 MB |
| Vídeo | MP4 | 16 MB |
O Flowella verifica cada ficheiro antes de o carregar. Se um ficheiro tiver o tipo errado ou for demasiado grande, o cartão mostra o erro de imediato, por exemplo **This image is over 5 MB. JPEG and PNG card images must be 5 MB or smaller.** Se um carregamento falhar, clique em **Tentar novamente** nesse cartão.
O WhatsApp recorta as imagens dos cartões num formato largo. Se carregar uma imagem em retrato, o Flowella avisa que a parte superior e inferior podem ser cortadas. Use imagens em paisagem ou mantenha o conteúdo importante ao centro.
#### Regras que o Flowella verifica antes de submeter
O Flowella verifica o carrossel face às regras do WhatsApp e destaca o cartão que precisa de correção. Por exemplo, se um cartão não tiver media, o Flowella destaca esse cartão e mostra **Card 3: has no image. Every card needs its own uploaded image before you can submit.**
* O carrossel tem de 2 a 10 cartões.
* Todos os cartões têm media carregada do mesmo tipo.
* Ou todos os cartões têm texto de corpo, ou nenhum tem. O texto de corpo do cartão tem 160 caracteres ou menos, e cada variável tem uma amostra.
* Todos os cartões têm o mesmo número de botões, com os mesmos tipos pela mesma ordem. As etiquetas podem variar.
* Um botão de link pode conter uma variável, no final do URL, com um valor de amostra.
Escolhe entre uma mensagem padrão e um carrossel quando cria o modelo. Não pode transformar um carrossel num modelo padrão, nem um modelo padrão num carrossel. Para mudar, crie um novo modelo.
Para a lista completa das regras de carrossel do WhatsApp, consulte [Modelos carrossel](/pt/app/template-reference#carousel-templates).
## Menu de ações do catálogo
Cada modelo no catálogo tem um **menu de ações de 3 pontos**, tanto na vista de grelha (cartão) como na vista de lista (tabela). O menu dá-lhe as mesmas ações em ambas as vistas, portanto já não precisa de abrir o editor para tarefas de rotina.
| Ação | Disponibilidade |
| - | - |
| **Editar** | Sempre. Abre o editor de modelos. |
| **Enviar** | Apenas modelos **Aprovados**. Desativado de outra forma com a dica "O modelo deve ser aprovado antes de enviar". |
| **Estatísticas** | Desativado para modelos **Rascunho** e **Pendentes**. Sempre ativado para modelos **Aprovados**. Para modelos **Rejeitados**, **Pausados** e **Desativados**, ativado quando o modelo tem registos de envio. |
| **Clonar** | Sempre. Cria uma cópia como um novo rascunho local. |
| **Copiar ID do modelo** | Modelos que foram submetidos à Meta. Desativado para rascunhos locais com a dica "O ID do modelo está disponível após este modelo ser submetido à Meta". |
| **Submeter para aprovação** | Mostrado apenas para modelos **Rascunho** e **Rejeitados**. Abre o modelo com a janela de submissão-para-aprovação. |
| **Eliminar** | Ativado para tudo exceto [modelos de reabertura do sistema](#system-managed-reopen-templates). Pede confirmação antes de eliminar. |
**Enviar** e **Estatísticas** fazem deep-link para o separador correspondente na página de detalhe do modelo através do parâmetro de consulta `tab` (`?tab=send`, `?tab=statistics`), e **Submeter para aprovação** acrescenta `?submit=1` para abrir a janela de submissão. Estes URLs são partilháveis — cole um numa mensagem para enviar um colega diretamente para o separador certo.
Revisão de captura de ecrã: a captura da lista de modelos acima antecede o menu de ações de 3 pontos. Atualize-a assim que estiverem disponíveis novas capturas.
### Copiar o ID do modelo Meta
Uma vez que um modelo foi submetido à Meta, tem um **ID do modelo Meta**. Precisa deste ID ao configurar envios API, depurar webhooks ou fazer referência cruzada a um modelo no Meta Business Manager.
Pode copiá-lo em dois lugares:
* **Catálogo** — abra o menu de 3 pontos e clique em **Copiar ID do modelo**.
* **Detalhe do modelo** — o cartão de informação no cabeçalho do editor mostra uma linha **ID do modelo** (junto a **Última atualização** e **Atualizado por**) com um botão de cópia.
Ambos mostram uma notificação "ID do modelo copiado" em caso de sucesso. Rascunhos locais que ainda não foram submetidos não têm ID Meta, portanto a ação está desativada para eles.
## Distintivos de saúde de entrega na lista de modelos
Cada linha na lista de modelos pode mostrar um **distintivo de saúde de entrega** além do distintivo de estado habitual. O distintivo sinaliza modelos que o WhatsApp parou de entregar, para que os possa identificar sem abrir cada editor.
| Distintivo | Quando aparece | O que significa |
| - | - | - |
| **Pausado pelo WhatsApp** | O estado da Meta é `PAUSED`. | O WhatsApp pausou este modelo. Jornadas, campanhas e ações de fluxo de trabalho HubSpot que o usam não enviarão até a Meta o restaurar. |
| **Desativado pelo WhatsApp** | O estado da Meta é `DISABLED`. | O WhatsApp desativou este modelo. Atualize ou substitua-o antes de enviar novamente. |
| **Qualidade: Vermelho** | A pontuação de qualidade da Meta é `RED` e o modelo ainda não está pausado ou desativado. | O WhatsApp classificou este modelo como Vermelho. Reveja envios recentes e feedback dos clientes no Meta Business Manager. |
Distintivos pausados e desativados substituem o distintivo de estado normal; o distintivo Qualidade: Vermelho aparece ao lado dele. Quando a Meta levanta a pausa, restaura o modelo ou traz a qualidade de volta a Amarelo/Verde, o distintivo limpa-se automaticamente na próxima sincronização.
### Pausas de ritmo vs pausas de qualidade
O Flowella classifica cada pausa Meta num de dois tipos, e o caminho de recuperação difere:
* **Pausa de ritmo** — o WhatsApp reteve temporariamente o modelo após feedback negativo inicial num envio de marketing. O Flowella mostra um botão **Retomar** ao lado do distintivo. Clique nele para pedir à Meta para restaurar o modelo. Reveja o conteúdo antes de retomar; o Flowella nunca retoma automaticamente.
* **Pausa de qualidade** — o WhatsApp pausou o modelo por violações de qualidade. Estas chegam em instâncias escalonadas, mostradas como **Pausa de qualidade 1/3**, **2/3** e assim por diante. A primeira pausa dura cerca de 3 horas e a segunda cerca de 6 horas; uma terceira violação desativa o modelo. Não há botão Retomar para pausas de qualidade. Aguarde que a pausa expire, e não edite ou volte a submeter enquanto estiver ativa, porque isso envia o modelo de volta para revisão da Meta e prolonga a interrupção.
Modelos desativados não podem ser retomados a partir do Flowella. Edite-os ou apele no WhatsApp Manager.
Transições de pausa, desativação e qualidade-VERMELHO também **disparam notificações** (`TEMPLATE_PAUSED`, `TEMPLATE_DISABLED`, `TEMPLATE_QUALITY`) para que descubra mesmo que não esteja na página de modelos. Ative ou desative em [Preferências de notificação](/pt/settings/notification-preferences); a lista completa de eventos está em [Eventos de notificação](/pt/app/notification-events).
## Histórico de estado Meta
Abra qualquer modelo suportado pela Meta e mude para o separador **Estatísticas**. Abaixo dos blocos de registo de envio verá uma secção **Histórico de estado** que lista cada transição registada que a Meta reportou para este modelo — aprovações, pausas, desativações, alterações de qualidade e reclassificações de categoria — com um timestamp e o campo de origem que mudou.
Use isto como um rasto de auditoria quando estiver a investigar um distintivo de saúde de entrega ou a responder "quando é que este modelo virou?" numa conversa de suporte.
O histórico de estado só aparece para modelos suportados pela Meta (não rascunhos locais) e está aninhado dentro do separador Estatísticas. Versões anteriores renderizavam-no abaixo da barra de ação do editor — agora vive com o resto das suas análises de entrega.
## Modelos de reabertura geridos pelo sistema
Os modelos `flowella_reopen_*` do Flowella (Service, Update, Offer) alimentam o [separador Resposta](/pt/app/inbox#reply-tab-smart-reply) da Caixa de entrada e o [CTA de Reengajar com um toque](/pt/app/inbox#one-tap-re-engage-on-a-closed-window). No catálogo de Modelos, estes modelos de reabertura geridos pelo sistema levam agora um distintivo **Sistema** tanto na vista de cartão como na de lista, para que os possa identificar rapidamente.
Pode ainda editar o texto de enquadramento em [Definições → Modelos de resposta](/pt/settings/reply-templates), mas os modelos de reabertura do sistema **não podem ser eliminados** — a ação **Eliminar** no menu de 3 pontos do catálogo e o botão eliminar dentro do editor de modelos estão desativados com uma dica a explicar porquê. Para parar de usar um tipo, desative-o em Modelos de resposta.
## Comportamento do editor
O editor de modelos está desenhado para nunca perder trabalho.
* **Guardar automaticamente** — cada alteração ao nome, idioma, categoria, canal ou componentes guarda após uma pausa de \~1 segundo. Uma barra de ação de rodapé fixa mostra o estado de guardar atual (**A guardar…**, **Guardado** ou **Alterações não guardadas**).
* **Publicar está bloqueado por guardar** — o botão **Publicar** permanece desativado até o último guardar automático terminar, para que nunca possa submeter um rascunho meio-guardado à Meta.
* **Quebras de linha do corpo e espaços do rodapé** são preservados entre mudanças de separador e guardares — o que escreve é o que a Meta recebe.
* **Botões Quick Reply começam vazios** com um espaço reservado. Guardar ou publicar um modelo com texto Quick Reply vazio é bloqueado por validação inline (`BUTTON_TEXT_REQUIRED`).
* **Dropdown de categoria** mostra apenas a etiqueta selecionada quando fechado; abri-lo revela descrições alinhadas com a Meta, uma nota de recategorização e um link para a [Referência do modelo](/pt/app/template-reference).
## Testar um modelo
Para testar um modelo antes de o usar com contactos reais, abra o modelo e mude para o separador **Enviar**.
Em **Modelos**, clique no modelo que quer testar, e depois selecione o separador **Enviar**.
Em **Testar Modelo**, escolha o **indicativo do país** e introduza o número WhatsApp em que pode receber mensagens.
O número deve estar em formato internacional com o indicativo do país — por exemplo, `+351911234567`.
Forneça um valor para cada variável do modelo. Para modelos de **Código de cupão**, introduza os códigos literais que quer enviar — o valor de exemplo do modelo é **apenas espaço reservado** e nunca é usado no momento do envio.
Clique em **Enviar Teste**.
Pode enviar um teste mesmo enquanto o modelo ainda está pendente de aprovação da Meta. Testar permite-lhe ver exatamente como a mensagem aparecerá aos contactos antes de a usar em produção.
Abra a mensagem no seu dispositivo e confirme que a media do cabeçalho, formatação do corpo e botões renderizam corretamente. Verifique tanto em iOS como em Android se possível.
### Enviar modelos carrossel
Pode enviar um carrossel aprovado a partir de um envio de teste, de um envio em massa, da [Caixa de entrada](/pt/app/inbox), da [API Flowella](/pt/api-reference/introduction) e do HubSpot.
* **Media dos cartões** — se não fornecer media para um cartão, o Flowella envia a imagem ou o vídeo de amostra aprovado desse cartão. Os envios de teste, envios em massa, envios da Caixa de entrada e envios do HubSpot usam sempre a media de amostra aprovada.
* **Valores por cartão** — através da API, passe uma entrada `carouselCards` por cartão, pela ordem dos cartões. Cada entrada pode definir a media do cartão (`mediaUrl` ou `mediaId`), as variáveis do corpo do cartão (`bodyParameters`) e os valores dos botões (`buttonParameters`).
* **Os mesmos cartões para todos os destinatários** — um envio em massa usa a mesma media e os mesmos valores de cartão para todos os destinatários. As variáveis do corpo da mensagem podem continuar a variar por destinatário.
```bash theme={null}
curl -X POST "https://api.flowella.io/v1/templates/send" \
-H "Authorization: Bearer flo_xxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"templateId": "clxxxxxxxxxxxxxxxxxxxxxxxx",
"whatsappChannelId": "clxxxxxxxxxxxxxxxxxxxxxxxx",
"recipients": [{ "phone": "+15551234567", "bodyParameters": ["Ada"] }],
"carouselCards": [
{
"mediaUrl": "https://cdn.example.com/card-1.jpg",
"buttonParameters": [{ "index": 1, "text": "summer" }]
},
{ "mediaUrl": "https://cdn.example.com/card-2.jpg" }
]
}'
```
Neste exemplo, o cartão 1 usa uma imagem personalizada e preenche a variável no final do link do seu segundo botão com `summer`. O cartão 2 usa uma imagem personalizada. O `index` do botão começa em zero.
## Envio em massa
O separador **Enviar** também lhe permite enviar um modelo **APROVADO** a muitos destinatários num único trabalho — útil para anúncios de marketing, lembretes em lotes ou qualquer saída estruturada que não caiba na caixa de entrada.
### Construir a lista de destinatários
O editor de lista de destinatários fica abaixo de **Testar Modelo** no separador Enviar.
* **Adicionar linhas manualmente** — uma linha por destinatário, com uma coluna de telefone e uma coluna por variável do modelo.
* **Importar um ficheiro** — clique em **Importar ficheiro** e escolha um ficheiro `.csv` ou `.xlsx`. A importação de ficheiro é a única forma de adicionar destinatários em massa; colar linhas não é suportado.
* **Descarregar um ficheiro de amostra** — clique em **Descarregar ficheiro de amostra** e escolha **Excel (.xlsx)** ou **CSV (.csv)**. O Flowella gera um ficheiro inicial com os cabeçalhos de coluna corretos para o modelo selecionado (phone + cada variável). Use-o como base para a sua própria lista.
* Remova linhas com a ação de eliminar ao nível de linha.
Os números de telefone devem estar em formato internacional completo (`+351911234567`). Consulte [Formato do número de telefone](/pt/hubspot/phone-number-format).
#### Requisitos de importação de ficheiro
* **Formatos** — `.csv` e `.xlsx` são aceites. Ficheiros `.xls` legados são rejeitados; guarde como `.xlsx` ou `.csv` primeiro.
* **Limites** — os ficheiros devem ter menos de **10 MB** e conter no máximo **50.000 linhas de destinatários**.
* **Livros Excel** — o Flowella lê a folha chamada **Recipients** se presente, caso contrário a primeira folha. Números de telefone armazenados como números Excel importam como strings de dígitos completos (nunca notação científica), e células de data ou número importam como aparecem no Excel.
* **Aspas CSV** — campos entre aspas são analisados conforme RFC 4180, portanto vírgulas e quebras de linha dentro de aspas, aspas duplicadas (`""`) e o BOM UTF-8 da exportação "CSV UTF-8" do Excel funcionam todos. Linhas de preenchimento vazias que o Excel acrescenta são descartadas automaticamente.
### Agendamento e limitação de taxa
* **Agendamento** — envie imediatamente ou escolha uma data e hora futuras.
* **Limitação** — escolha quantas mensagens por segundo o Flowella despacha à Meta. Limite abaixo do **nível de limite de mensagens** do seu número de telefone para evitar picos que prejudiquem a pontuação de qualidade. Consulte [Limites de mensagens](/pt/meta/messaging-limits).
### Observar o trabalho a correr
Assim que clica em **Iniciar envio**, o separador **Estatísticas** no mesmo modelo mostra uma **faixa de progresso** em direto e **blocos de resumo do trabalho**: total em fila, enviado, entregue, lido, falhou e **suprimido**.
Enquanto um trabalho está a correr, a faixa e o registo de envio atualizam automaticamente a cada poucos segundos. Não precisa de mudar de separadores ou refocar a janela para ver novo progresso. Se abrir o separador Estatísticas a meio de um trabalho, a faixa reaparece com o progresso atual.
O estado **Suprimido** é usado quando o Flowella descarta uma linha porque o mesmo par `(template, phone)` já foi enviado dentro da **janela de deduplicação**. Isto evita duplicados acidentais se voltar a importar um ficheiro de destinatários ou reexecutar um agendamento.
Pode sair da página — o trabalho continua a correr no servidor e uma notificação dispara quando é concluído.
### Envios são retidos enquanto um modelo está pausado ou desativado
Se iniciar um envio em massa (ou acionar um envio através da API v1 ou um formulário de envio HubSpot) enquanto o estado Meta mais recente do modelo é **Pausado** ou **Desativado**, o Flowella cria o trabalho num estado **retido** em vez de o despachar. Nada é enviado e nada se perde.
* **Modelos pausados** — trabalhos retidos retomam automaticamente assim que a Meta restaura o modelo para Ativo. As notificações de pausa/restauro do Flowella incluem quantos trabalhos foram retidos e por quanto tempo. Retome pausas de ritmo a partir da lista de modelos, ou aguarde que uma pausa de qualidade expire.
* **Modelos desativados** — trabalhos retidos ficam estacionados. Edite ou apele o modelo no WhatsApp Manager antes de enviar novamente.
* **Envios de teste e envios da caixa de entrada** são recusados imediatamente enquanto o modelo está pausado ou desativado, com uma notificação a explicar porquê.
Separadamente, o próprio WhatsApp pode reter uma mensagem de marketing individual para **avaliação de qualidade** após aceitá-la. Estas linhas aparecem como **Retida** no registo de envio. Se o feedback inicial do destinatário for negativo, o WhatsApp descarta a mensagem retida; não é entregue e não é cobrada.
### Envios falhados e Reenviar não enviados
Se um trabalho termina sem alcançar todos os destinatários, o Flowella marca-o **Falhou** em vez de relatar uma contagem de concluídos inflacionada. A faixa de progresso permanece visível com a mensagem **Envio em massa terminado com destinatários não enviados** e um botão **Reenviar não enviados**.
Clique em **Reenviar não enviados** para colocar novamente em fila apenas os destinatários que nunca receberam a mensagem. Destinatários já enviados não são novamente contactados, portanto não há risco de duplicados.
### Coluna Detalhes por envio
Cada linha em **Estatísticas → Registo de envio** tem uma coluna **Detalhes** que explica o resultado em português simples em vez de um código de erro Meta. O texto Detalhes resolve o motivo da falha a partir de `meta_webhook_logs` e da carga de entrega persistida, para que falhas Meta pós-envio (por exemplo, método de pagamento **131042**) sejam apresentadas tal como falhas de trabalho pré-envio.
| Detalhe | O que significa |
| - | - |
| **Entregue** | A Meta confirmou a entrega. |
| **Telefone inválido** | O número de telefone do destinatário não é um número WhatsApp válido. |
| **Com opt-out** | O contacto está na lista de opt-out. |
| **Contacto em falta** | O telefone não conseguiu ser resolvido para um contacto Flowella no momento do envio. |
| **URL de media de cabeçalho inválido** | O modelo tem um cabeçalho de media cujo URL de amostra não pode ser usado para envios. Volte a carregar a media no editor. |
| **Método de pagamento (131042)** | A Meta rejeitou o envio porque o método de pagamento da sua WABA é inválido ou tem fundos insuficientes. |
| **Descartada após retenção de qualidade** | O WhatsApp reteve esta mensagem para avaliação de qualidade, recebeu feedback inicial negativo e descartou-a. A mensagem não foi entregue e não foi cobrada. |
| **Outro erro da API Meta** | Uma falha Meta não-determinística — reenvie se o problema for transitório. |
| **Falha de entrega desconhecida** | A Meta aceitou o envio mas mais tarde relatou que não conseguiu entregar. |
Os distintivos de estado são localizados para o idioma da interface da sua conta.
## Relacionado
Categorias, cabeçalhos, botões, variáveis e o ciclo de vida da submissão.
Sintaxe, valores de exemplo, mapeamento HubSpot e armadilhas de rejeição.
Que formatos e tamanhos de media o WhatsApp aceita em cabeçalhos de modelos.
Motivos comuns de rejeição Meta e como corrigi-los.
Como a categoria do modelo determina o preço por mensagem da Meta.
Envie os seus modelos aprovados a partir de um fluxo de trabalho HubSpot.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.