Saltar para o conteúdo principal
As variáveis permitem que um único modelo aprovado envie mensagens personalizadas a milhares de contactos sem ter de voltar a enviar para o Meta. Esta página é um mergulho profundo sobre como as variáveis funcionam no Flowella, onde podem aparecer e como ligá-las aos dados do HubSpot. Para uma visão geral de alto nível da estrutura do modelo, consulte Referência do modelo. Para a criação de modelos passo a passo, ver Modelos.

​
Sintaxe

Os modelos WhatsApp utilizam variáveis posicionais com chavetas duplas e um índice baseado em 1: 
Hi {{1}}, your booking on {{2}} is confirmed. Reference: {{3}}.
Regras:
  • Os índices começam em {{1}} e devem ser sequenciais - não é possível saltar de {{1}} para {{3}}.
  • O mesmo índice pode ser reutilizado dentro de um único componente (corpo, cabeçalho ou URL), mas o Flowella enviará o mesmo valor para cada ocorrência.
  • Não é permitido espaço em branco dentro das chaves: {{ 1 }} é inválido.
  • As variáveis são apenas texto. Números, datas e moeda são enviados como strings - formate-os a montante no HubSpot antes de os enviar.
O Meta está a lançar variáveis nomeadas ({{first_name}}) para novos modelos. O Flowella suporta ambos, mas os índices posicionais continuam a ser o formato mais fiável em todos os tipos de modelos e versões Cloud API.

​
Onde as variáveis podem aparecer

ComponenteVariáveis permitidasNotas
Header (TEXT)1Apenas valores curtos - sem quebras de linha.
Cabeçalho (media)**1 (o identificador de media ou URL)A variável é o próprio media, não o texto.
Cabeçalho (LOCATION)**4 (lat, long, name, address)Todos os quatro são necessários quando o cabeçalho é variável.
Cada variável conta para o limite de caracteres do corpo do Meta.
Rodapé**NenhumRodapé é apenas texto estático.
Botão URL**1Anexado ao final de uma URL base estática.
Botão _COPY_CODE**1O valor completo do código.
Botões Resposta rápida, Telefone, Fluxo, Catálogo**NenhumConfiguração estática.
Cartões de carrossel**Até 3 por corpo de cartãoAs variáveis de cada cartão são numeradas independentemente.

​
Valores de amostra

Quando submete um modelo ao Meta, cada variável necessita de um valor de amostra. O Meta utiliza as amostras para:
  1. Decidir se o conteúdo do modelo corresponde à categoria escolhida (Marketing, Utilidade, Autenticação).
  2. Estimar a qualidade e o risco de spam.
  3. Mostrar uma pré-visualização aos revisores.
Os valores de amostra não são utilizados no momento do envio - são apenas para revisão. Mas eles são importantes:
  • Utilize valores realistas. {{1}} = "John" é bom; {{1}} = "xxx" provoca frequentemente a rejeição.
  • Mantenha as amostras curtas. Colar um parágrafo numa única variável é um sinal clássico de rejeição.
  • Certifique-se de que a amostra é adequada ao tipo. Se {{2}} for uma data, use uma data. Se for um número de encomenda, utilize algo que se pareça com um número de encomenda.

​
Ligar variáveis aos dados HubSpot

Num fluxo de trabalho HubSpot que utiliza a ação Enviar Modelo WhatsApp do Flowella:
1

Escolher o modelo

O Flowella mostra todos os modelos aprovados para o seu canal. As variáveis são detectadas automaticamente no corpo do modelo, no cabeçalho e nos botões.
2

Mapear cada variável para um valor do HubSpot

Para cada {{n}}, escolha uma propriedade HubSpot de contacto, empresa, negócio ou bilhete - ou escreva um valor estático. É possível misturar tokens de personalização e texto literal no mesmo mapeamento.
3

Definir uma alternativa para valores vazios

Se um contacto não tiver valor para a propriedade mapeada, a mensagem falhará, a menos que forneça uma alternativa. Falhas comuns: "there" para o primeiro nome, "your account" para o nome da conta.
4

Teste antes de entrar em ação

Enviar o fluxo de trabalho para um único contacto de teste primeiro. Meta rejeita envios em que qualquer variável esteja vazia, contenha apenas espaços em branco ou contenha uma nova linha.
Variáveis vazias falham no momento do envio, não na aprovação do modelo. Um fluxo de trabalho que é executado contra milhares de contactos pode ser silenciosamente abandonado se faltar uma propriedade crítica. Defina sempre fallbacks.

​
Dicas de formatação de variáveis

**Nomes 
Hi {{1}},
Colocar a propriedade em maiúsculas no HubSpot a montante, ou utilizar um passo do fluxo de trabalho HubSpot para copiar o firstname numa propriedade “Nome próprio (formatado)”. **Datas Os modelos WhatsApp não formatam datas. Se a sua propriedade HubSpot for 2026-05-24T00:00:00Z, é isso que aparece na mensagem. Utilize uma propriedade calculada HubSpot ou uma ação de fluxo de trabalho para formatar as datas como 24 May 2026 antes de as mapear. Moeda O mesmo que as datas - formato a montante. Incluir o símbolo da moeda no texto estático (Total: £{{1}}) para que a variável seja apenas o número. URLs no corpo do texto Pode incluir o URL completo dentro de uma variável do corpo, mas a pré-visualização da ligação não será apresentada e o URL conta para o limite de caracteres do corpo. Em vez disso, utilize um botão URL com um sufixo de variável: 
Base URL: https://acme.com/orders/
Variable: {{1}}
At send time: https://acme.com/orders/AB-1234

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

  • Índices saltados ({{1}} e depois {{3}}). Renumerar sempre.
  • Variável no início ou no fim do corpo sem texto circundante ({{1}} sozinho). Adicionar uma palavra antes ou depois.
  • Duas variáveis adjacentes ({{1}}{{2}}). Separe-as com pelo menos um espaço ou pontuação.
  • Valores de amostra que se parecem com placeholders** - "test", "xxx", "123" - especialmente em modelos de Marketing.
  • Variáveis no rodapé - não permitidas.
  • Mais do que uma variável num botão URL - só é permitida uma, e deve estar no fim do URL.

​
Padrões avançados

​
Reutilizar um valor entre componentes

Se um nome de cliente aparecer tanto no cabeçalho como no corpo, defina-o uma vez no seu fluxo de trabalho e mapeie tanto {{1}} (cabeçalho) como {{1}} (corpo) para a mesma propriedade HubSpot. O Flowella envia a cada componente a sua própria lista de parâmetros, pelo que os índices são independentes - mapeia o valor duas vezes, mas apenas o armazena uma vez no HubSpot.

​
Conteúdo condicional

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

​
Modelos multilingues

O nome e a estrutura de um modelo são partilhados entre idiomas, mas cada idioma é submetido, aprovado e armazenado separadamente. As variáveis devem estar nas mesmas posições em todas as versões linguísticas. O Flowella escolhe o idioma correto com base na propriedade hs_language do contacto (ou num fallback configurado por si).

​
Resolução de problemas

  • Template aprovado mas as mensagens falham com “parameter mismatch ”** - O Meta e o Flowella não concordam com o número de variáveis que o template tem. Re-buscar o modelo no Flowella (Modelos → atualizar) para que a contagem de variáveis seja sincronizada.
  • A variável mostra o literal {{1}} na mensagem entregue** - o fluxo de trabalho não mapeou um valor para esse índice. Verifique a lista de parâmetros da ação do fluxo de trabalho.
  • Mensagem rejeitada no envio com “violação de política ” - uma variável contém um URL ou conteúdo que não corresponde à categoria do modelo. O conteúdo de estilo de marketing não pode ser injetado num modelo de Utilitário através de variáveis.
Para obter informações sobre o ciclo de vida completo da submissão, edição e pausa de modelos, consulte Modelos e Referência do modelo. Para obter ajuda específica sobre rejeição, consulte Template rejected.