Como configurar variáveis nos templates de WhatsApp

As variáveis em templates (como {{1}}, {{2}}, {{3}}) permitem personalizar mensagens com dados dinâmicos, como nome do contato, valores ou informações externas.

Para que funcionem corretamente, é necessário mapear cada variável para uma fonte de dados antes do envio.

Como funciona?

Sempre que um template possui variáveis, a plataforma solicita que você defina de onde virá cada informação. Esse mapeamento é feito por meio de um dropdown, onde você escolhe a origem do dado que será inserido na mensagem.

As variáveis podem ser preenchidas a partir de três fontes principais:

• Dados do contato (nome, e-mail, telefone, first name e last name.)
• Atributos personalizados: para serem exibidos, precisam estar previamente cadastrados — veja neste tutorial como configurar.
• Valores Estáticos (definidos manualmente)

Em fluxos, também é possível utilizar dados vindos de webhook.

Onde configurar?

O uso de variáveis pode acontecer em três contextos dentro da plataforma:

Mensagens individuais: São envios manuais para um único contato. Nesse caso, o preview já mostra os valores reais que serão enviados, facilitando a conferência.

Campanhas de WhatsApp: São envios em massa, agendados. As variáveis são resolvidas individualmente para cada contato com base nos dados cadastrados.

Fluxos de WhatsApp: São disparados automaticamente via webhook. Permitem usar dados externos (como valor, data, desconto), além de informações do contato e valores estáticos.

Como configurar?

Primeiro é necessário criar um template onde possui variáveis, para isso:

1. Acesse Modelos de conteúdo > WhatsApp e clique em criar modelo.
2. Na primeira etapa, preencha:

• Nome do modelo
• Idioma
• Tipo de conteúdo (neste caso exemplo: texto)

3. Após isso, avance para a etapa de conteúdo da mensagem.

No campo de corpo da mensagem, escreva o texto normalmente e utilize o botão “Adicionar variável” para inserir variáveis dinâmicas.

4. As variáveis seguem o formato sequencial:  {{1}}, {{2}}, {{3}}

Cada uma delas representa uma informação que será preenchida no momento do envio.

Ao adicionar uma variável, é obrigatório preencher um valor de exemplo. Esse valor é utilizado para validação do template e para simular como a mensagem será exibida.

Por exemplo:

• Na variável {{1}}, se a idéia for incluir o nome do contato, você pode preencher um nome como exemplo (ex: Alexia)
• Na variável {{2}}, se for o nome da empresa, você pode usar um valor como (ex: Leadster)
• Na variável {{3}}, se for um link, você pode inserir uma URL (ex: https://leadster.com.br/whatsapp-suite), que normalmente será utilizada como um valor estático.

Esses exemplos não são os valores finais enviados, mas ajudam a visualizar como a mensagem será montada e garantem que o template seja validado corretamente.

Após finalizar o conteúdo:

5. Clique em Criar
6. Solicite a aprovação do template (pela opção indicada na plataforma)

Somente após a aprovação o template poderá ser utilizado nos envios.

Como enviar?

Mensagens individuais:

Quando o envio é manual para um único contato:

Acesse um contato ou uma conversa, selecione enviar template e escolha o modelo desejado. Em seguida, mapeie as variáveis.

Você pode utilizar:

• Dados do contato (apenas os que estiverem preenchidos)
• Custom attributes (também apenas os preenchidos)
• Valor estático

O preview já exibe os valores reais, então basta validar e enviar.

Campanhas de WhatsApp

Quando o envio é em massa:

Acesse Campanhas > WhatsApp, crie uma campanha, selecione a inbox e o template. Depois, defina a origem de cada variável.

Você pode utilizar:

• Dados do contato
• Custom attributes
• Valor estático

Após o mapeamento, revise o preview (com placeholders), defina o público e agende o envio.

Fluxos de WhatsApp

Quando o envio é automatizado:

Acesse Fluxos de WhatsApp, crie ou edite um fluxo e, se necessário, configure previamente as variáveis de webhook.

Adicione um step de envio de template, selecione o modelo e mapeie as variáveis.

Você pode utilizar:

• Dados do contato
• Variáveis de webhook
• Valor estático

Depois disso, revise o preview (com placeholders) e salve o fluxo.

Diferencial: Preview com valores reais

A mensagem individual é o único contexto em que o preview exibe os valores reais do contato.

Isso acontece porque o envio é feito para um contato específico, já conhecido. Diferente de campanhas e fluxos, onde o destinatário final ainda não está definido no momento da configuração, e por isso o preview mostra apenas placeholders (ex: [Contact - Name]).

Pontos importantes 💡

• Na mensagem individual, o comportamento da plataforma traz algumas particularidades importantes.
• O dropdown exibe apenas campos que possuem valor preenchido para o contato selecionado. Ou seja, se uma informação não existir (como e-mail, por exemplo), ela não aparecerá como opção.
• O preview já mostra exatamente como a mensagem será enviada, com todos os dados reais preenchidos. Isso permite uma validação completa antes do disparo.
• Internamente, as variáveis são resolvidas automaticamente com base nos dados mais atualizados do contato no momento do envio.
• Sempre que um template for alterado, os mapeamentos das variáveis são resetados e precisam ser configurados novamente.
• Por fim, templates que não possuem variáveis continuam funcionando normalmente, sem qualquer alteração no fluxo de envio.

Ficou com alguma dúvida? Entre em contato com nossa equipe de suporte.

Abraços 👋