Saltar para o conteúdo principal
As variáveis permitem que um único modelo aprovado envie mensagens personalizadas a milhares de contactos sem nova revisão da Meta. Esta página explica como funcionam as variáveis no Flowella, como funcionam os valores de exemplo e de recurso, e como preencher variáveis a partir do HubSpot. Para a estrutura de um modelo, consulte Referência de modelos. Para criar um modelo passo a passo, consulte Modelos.

​
Sintaxe

Os modelos WhatsApp usam variáveis posicionais: chavetas duplas com um número.
  • Para adicionar uma variável, clique em + Variable no editor do corpo, ou em Variable junto a Header text. O Flowella insere o número seguinte por si.
  • Os números começam em {{1}} e têm de ser sequenciais. Não pode saltar de {{1}} para {{3}}.
  • As variáveis são texto. Números, datas e montantes são enviados como texto, por isso formate-os antes de chegarem ao modelo.
A Meta também suporta variáveis com nome, como {{first_name}}. O Flowella consegue enviar modelos com variáveis com nome que foram criados no WhatsApp Manager, mas o seu editor só cria variáveis posicionais.

​
Onde podem aparecer variáveis

​
Valores de exemplo

Quando publica um modelo, a Meta precisa de um exemplo para cada variável. A Meta usa os exemplos para:
  1. Verificar se o conteúdo corresponde à categoria que escolheu (Marketing, Utility ou Authentication).
  2. Avaliar a qualidade e o risco de spam.
  3. Mostrar uma pré-visualização aos revisores.
No Flowella, o exemplo de uma variável é o respetivo Fallback value. Bons exemplos ajudam na aprovação:
  • Use valores realistas. John é adequado; xxx leva muitas vezes à rejeição.
  • Mantenha os exemplos curtos. Um parágrafo numa única variável é um sinal clássico de rejeição.
  • Respeite o tipo. Se {{2}} for uma data, use uma data. Se for um número de encomenda, use algo que pareça um número de encomenda.

​
Valores de recurso

Cada variável no editor tem um campo Fallback value:
  • Variáveis do corpo: no painel Body variables do editor do corpo.
  • Variável do cabeçalho de texto: em Header variables no cartão Variables.
  • Variável do botão de URL: por baixo do endereço do botão.
O valor de recurso faz três coisas:
  1. Aparece na pré-visualização.
  2. É enviado à Meta como exemplo da variável quando publica.
  3. O Flowella envia-o quando o valor de um contacto está em falta ou vazio, depois de os valores de recurso serem confirmados.
Escolha um valor que se leia naturalmente para qualquer pessoa, como there em Hi there. Os valores de recurso não podem conter quebras de linha. Quando publica um modelo que criou no Flowella, os respetivos valores de recurso são confirmados automaticamente.

​
Modelos com valores de recurso não revistos

Alguns modelos mostram um distintivo Fallbacks not reviewed na lista de modelos. Ninguém confirmou ainda os respetivos valores de recurso, por exemplo porque o modelo foi criado no WhatsApp Manager. O Flowella preenche previamente os valores de recurso a partir dos exemplos do modelo. Até os confirmar:
  • O editor mostra um aviso: Review fallback values. These are used when a contact’s data is empty. Until you confirm them, sends with missing data will fail.
  • Qualquer envio com um valor vazio falha em vez de usar o valor de recurso.
Para encontrar estes modelos, clique em Fallbacks not reviewed acima da lista de modelos. Para confirmar os valores:
1

Abrir o modelo

Na página Templates, abra o modelo no editor.
2

Verificar cada valor de recurso

Leia cada Fallback value e altere os que não se leriam bem para todos os contactos.
3

Confirmar

Clique em Confirm fallback values no aviso. Se alterou um valor, clique antes em Save Template. Em qualquer dos casos, nada é enviado à Meta e o modelo não volta a ser revisto.
Depois de clicar em Confirm fallback values, o Flowella mostra Fallback values confirmed e o distintivo desaparece.

​
O que acontece no momento do envio

Isto aplica-se aos fluxos de trabalho HubSpot, aos envios em massa, à API, aos envios de teste e aos envios a partir da caixa de entrada. O Flowella nunca envia uma variável vazia à Meta. Quando um envio falha devido a uma variável vazia, o erro indica a variável e inclui uma ligação para o modelo. Por exemplo: Variable {{2}} is empty and has no fallback value. Num fluxo de trabalho HubSpot, a ação falha para esse contacto e o histórico do fluxo de trabalho mostra a mensagem. Se a variável não tiver valor de recurso, a saída Error code da ação é VARIABLE_EMPTY_NO_FALLBACK.

​
Mapear variáveis a partir do HubSpot

Num fluxo de trabalho HubSpot, a ação Send WhatsApp Template tem cinco posições para variáveis: Template Variable 1 a Template Variable 5. Consulte Ações de fluxo de trabalho.
1

Escolher o modelo

Escolha o modelo em Template Name. A lista mostra cada modelo uma vez, pelo nome.
2

Mapear as variáveis por ordem

O Flowella preenche primeiro uma variável do cabeçalho de texto e depois as variáveis do corpo por ordem. Por exemplo, um modelo tem {{1}} no cabeçalho e {{1}} e {{2}} no corpo. Mapeie Template Variable 1 para o valor do cabeçalho e Template Variables 2 e 3 para os valores do corpo. Os cabeçalhos de imagem, vídeo e documento não usam nenhuma posição.
3

Prever valores vazios

Se uma propriedade mapeada estiver vazia para um contacto, o Flowella envia o valor de recurso confirmado. Se o modelo não tiver um valor de recurso confirmado para essa variável, a ação falha para esse contacto. Se mapear menos posições do que as variáveis do modelo, o Flowella trata as que faltam como vazias.
4

Testar antes de ativar

Inscreva primeiro um contacto de teste e verifique a mensagem no seu telemóvel. Depois ative o fluxo de trabalho para todos.
Um modelo pode ter mais de cinco variáveis, mas a ação só consegue mapear cinco. Para cada variável a partir da sexta, o Flowella envia o valor de recurso confirmado, ou o envio falha se não existir.

​
Datas do HubSpot

O HubSpot envia as propriedades de data e de data e hora como um carimbo temporal. O Flowella converte-o em dd.MM.yyyy HH:mm em UTC, por exemplo 27.06.2026 14:30. Uma propriedade só de data mostra a hora 00:00. Para mostrar uma data na hora local do contacto, ou noutro formato, guarde a data formatada numa propriedade de texto HubSpot e mapeie essa propriedade. O Flowella envia as propriedades de texto exatamente como estão.

​
Idioma

A lista Template Name mostra cada nome de modelo uma vez. Se um modelo estiver aprovado em mais do que um idioma, o Flowella escolhe uma versão por esta ordem:
  1. O idioma passado com a ação do fluxo de trabalho, se existir.
  2. Uma versão com o código de idioma en. As versões em en_US ou en_GB não contam aqui.
  3. A versão aprovada atualizada mais recentemente.
O Flowella não usa a propriedade de idioma HubSpot do contacto. Para enviar idiomas diferentes a contactos diferentes, dê a cada versão de idioma o seu próprio nome de modelo e ramifique o fluxo de trabalho por idioma.

​
Cabeçalhos de localização

Um modelo com cabeçalho de localização precisa de uma latitude e de uma longitude em cada envio. O nome do local e a morada são opcionais. Num fluxo de trabalho HubSpot, mapeie a localização para as posições Template Variable que se seguem às variáveis do corpo: primeiro a latitude, depois a longitude e depois o nome do local. Por exemplo, com duas variáveis no corpo, mapeie a latitude para Template Variable 3 e a longitude para Template Variable 4.

​
Sugestões de formatação de variáveis

Nomes
Coloque primeiro a propriedade com maiúscula inicial no HubSpot, ou use um passo de fluxo de trabalho HubSpot para copiar firstname para uma propriedade “First name (formatted)”. Datas O WhatsApp não formata datas. Mapeie uma propriedade de texto que contenha a data tal como quer que se leia, por exemplo 24 May 2026. Consulte Datas do HubSpot. Moeda Formate os montantes antes de chegarem ao modelo. Coloque o símbolo da moeda no texto do modelo (Total: £{{1}}) para que a variável contenha apenas o número. URLs no texto do corpo Pode colocar um URL completo numa variável do corpo, mas a pré-visualização da ligação não aparece e o URL conta para o limite de caracteres do corpo. Em alternativa, use um botão URL com uma variável no fim:
Os envios de fluxos de trabalho HubSpot preenchem apenas variáveis do corpo, do cabeçalho e de localização. Não conseguem dar a um botão de URL um valor diferente para cada contacto, por isso, para ligações que mudam por contacto num fluxo de trabalho HubSpot, coloque o URL completo numa variável do corpo.

​
Motivos de rejeição comuns relacionados com variáveis

  • Números saltados ({{1}} e depois {{3}}). Numere as variáveis por ordem.
  • Uma variável no início ou no fim do corpo sem texto à volta. Adicione uma palavra antes ou depois.
  • Duas variáveis lado a lado ({{1}}{{2}}). Separe-as com pelo menos um espaço ou sinal de pontuação.
  • Exemplos que parecem marcadores de posição, como test, xxx ou 123, sobretudo em modelos Marketing.
  • Variáveis no rodapé. Os rodapés não podem ter variáveis.
  • Mais do que uma variável num botão de URL. Só é permitida uma, e tem de estar no fim do URL.

​
Padrões avançados

​
Reutilizar um valor em vários componentes

As variáveis do cabeçalho e do corpo são numeradas separadamente, por isso um {{1}} no cabeçalho e um {{1}} no corpo são variáveis diferentes. Se o nome de um cliente aparecer em ambos, mapeie a mesma propriedade HubSpot para as duas posições: Template Variable 1 para o cabeçalho e Template Variable 2 para o corpo.

​
Conteúdo condicional

Os modelos WhatsApp não suportam lógica if/else. Para enviar conteúdo diferente a grupos de contactos diferentes, crie modelos separados e ramifique o seu fluxo de trabalho HubSpot, por exemplo “Boas-vindas VIP” e “Boas-vindas padrão”.

​
Modelos multilingues

Cada versão de idioma de um modelo é submetida, aprovada e guardada separadamente. Mantenha as variáveis nas mesmas posições em todos os idiomas. Para ver que versão um fluxo de trabalho HubSpot envia, consulte Idioma.

​
Resolução de problemas

O valor do contacto estava vazio e o modelo não tem valor de recurso para essa variável. No HubSpot, o Error code da ação é VARIABLE_EMPTY_NO_FALLBACK. Certifique-se de que a propriedade está preenchida para todos os contactos, ou adicione um valor de recurso ao modelo e confirme-o.
O modelo tem um valor de recurso, mas ninguém o confirmou. Abra o modelo e clique em Confirm fallback values. Consulte Modelos com valores de recurso não revistos.
A propriedade mapeada estava vazia para esse contacto, ou o modelo tem mais de cinco variáveis. Verifique o registo do contacto e o mapeamento de variáveis na ação do fluxo de trabalho.
Não. O Flowella nunca envia uma variável vazia ou por preencher. Um valor em branco é substituído pelo valor de recurso confirmado, ou o envio falha.
Uma variável contém um URL ou conteúdo que não corresponde à categoria do modelo. Não pode adicionar conteúdo do tipo marketing a um modelo Utility através das suas variáveis. Para consultar o código de erro que o WhatsApp devolveu, consulte Códigos de erro WhatsApp no Flowella.
Para submeter, editar e pausar modelos, consulte Modelos e Referência de modelos. Para ajuda específica sobre rejeições, consulte Modelo rejeitado.
Última modificação em 24 de outubro de 2026