Variáveis de template WhatsApp permitem personalizar em escala as mensagens enviadas por campanhas. Em vez de disparar a mesma mensagem genérica para todos os contatos, você mapeia campos do contato (nome, empresa, cargo) para os espaços dinâmicos ({{1}}, {{2}}, {{3}}) definidos no template aprovado pela Meta. Cada destinatário recebe uma mensagem que parece escrita especificamente para ele — mesmo em campanhas com centenas de contatos.
Disponível em: todos os planos.
Quem pode fazer: qualquer usuário com acesso ao módulo Campanhas.
Módulo: Menu lateral > Campanhas
O que você precisa antes de começar
Ao menos uma inbox WhatsApp conectada na plataforma (Auto Closer, Evolution API ou UazapAPI)
Ao menos um template WhatsApp aprovado pela Meta associado à inbox que será utilizada
O template contém variáveis do tipo texto (
{{1}},{{2}}, etc.)Os contatos da audiência possuem os campos que serão mapeados preenchidos (ex: se vai mapear
{{1}}para nome, os contatos precisam ter o campo nome preenchido)Acesso ao módulo Campanhas na navegação lateral
Configurar variáveis em uma etapa da campanha
O mapeamento de variáveis acontece no Passo 3 — Sequência de mensagens da criação de campanha. Cada etapa da sequência tem seu próprio template e mapeamento independente.
Na barra de navegação lateral, clique em Campanhas
Clique em Nova campanha (ou abra uma campanha existente em status Rascunho)
Preencha o nome, selecione o canal WhatsApp Business e configure a audiência nos passos anteriores
No Passo 3, clique em Adicionar Etapa
No campo Conexão, selecione a inbox (remetente) pelo dropdown
Em Tipo de envio, selecione Template
No campo de conteúdo, clique em Selecionar template — o dropdown exibirá apenas templates aprovados filtrados pela inbox escolhida
Selecione o template desejado. O sistema exibirá as variáveis identificadas (ex:
{{1}},{{2}})Para cada variável, escolha o campo do contato correspondente no dropdown:
Nome, E-mail, Telefone, País (campos fixos)
Campos customizados da empresa (criados pelo admin)
Observe o preview lateral sendo atualizado em tempo real com dados de um contato real da audiência
⚠️ Importante: O botão Lançar campanha permanece bloqueado enquanto existir pelo menos uma variável sem campo de contato associado em qualquer etapa da sequência. O card da etapa com mapeamento pendente é destacado visualmente.
Como saber se deu certo
A sidebar direita exibe a mensagem com dados reais do contato — os valores das variáveis aparecem substituídos (ex: "Olá, João" em vez de "Olá,
{{1}}")O card da etapa na listagem exibe o nome do template selecionado
Não há avisos de variáveis sem valor no preview
Verificar o mapeamento pelo preview
O preview lateral usa dados reais de contatos da audiência, não dados fictícios. Isso permite verificar exatamente como a mensagem chegará para cada prospect antes do lançamento.
Na listagem de etapas, clique na etapa que deseja verificar — o preview lateral atualiza automaticamente
Use as setas (anterior / próximo) no preview para navegar entre diferentes contatos da audiência
Verifique se todas as variáveis estão preenchidas com valores corretos para cada contato
Se alguma variável aparecer sem valor, o sistema exibe um aviso de mapeamento incompleto — corrija antes de lançar
O preview renderiza a mensagem com a formatação do WhatsApp aplicada — negrito (*texto*), itálico (_texto_) e quebras de linha são exibidos como aparecerão no aplicativo do destinatário.
💡 Dica: Revise o preview com pelo menos 5 contatos diferentes antes de lançar. Isso garante que as variáveis estão mapeadas corretamente para diferentes perfis da audiência.
Campos disponíveis para mapeamento
Campos fixos do contato
Disponíveis para todos os contatos da plataforma:
Campo
| Exemplo de uso no template
|
Nome
| "Olá,
|
| "Enviei um material para
|
Telefone
| Raramente usado — o envio já vai para o número do contato
|
País
| "Vi que você está em
|
O sistema também disponibiliza campos derivados como first_name (primeiro nome) e last_name (sobrenome), extraídos automaticamente do campo nome completo.
Campos customizados
Campos criados pelo admin da empresa, disponíveis no dropdown de mapeamento:
Exemplo de campo
| Exemplo de uso
|
Empresa
| "Vi que você trabalha na
|
Cargo
| "Como
|
Segmento
| "Atendemos muitas empresas do setor de
|
Cidade
| "Ótimo estar falando com alguém de
|
💡 Dica: Campos customizados devem ser criados pelo admin da plataforma em Plataforma antes de estarem disponíveis no mapeamento.
Componentes do template suportados
Componente
| Suporte a variáveis
|
Header (texto)
| Suportado — mapeamento disponível para
|
Body
| Suportado — principal componente com variáveis (
|
Footer
| Não suportado — footers não aceitam variáveis pela política da Meta
|
Botões de CTA (texto fixo)
| Não aplicável — botões com texto fixo não usam variáveis
|
Botões de URL dinâmica
| Suporte limitado — verifique com o suporte se sua inbox e plano suportam
|
O que acontece no momento do envio
As variáveis são resolvidas no momento do disparo de cada etapa, não no momento do lançamento da campanha. Isso significa que:
O sistema busca os dados atuais do contato quando chega o momento de enviar aquela etapa
Se o campo do contato for atualizado entre etapas, o valor atualizado será usado na próxima etapa
Se um contato não tiver o campo mapeado preenchido, a mensagem não será enviada para esse contato e o enrollment será marcado como falha
O mapeamento é definido uma única vez no template da etapa e aplicado automaticamente para todos os contatos da campanha. Cada variável {{n}} aceita apenas um campo de contato por mapeamento.
Limites e regras
Regra
| Valor
|
Número de variáveis por template
| Definido pela Meta na criação do template — a plataforma não impõe limite adicional
|
Limite de caracteres por variável
| 1.024 caracteres por componente de variável (limite da Meta)
|
Tipos de variável suportados
| Apenas variáveis do tipo texto (
|
Origem dos dados
| Apenas campos do contato (fixos ou customizados) — não é possível inserir texto livre como valor de variável
|
Templates disponíveis
| Apenas templates com status aprovado pela Meta
|
Filtro por inbox
| O dropdown de templates exibe apenas os templates da inbox selecionada na etapa
|
Imutabilidade após ativação
| Mapeamento de variáveis não pode ser alterado após a campanha entrar em status Ativa
|
Recomendação de variáveis por template
| 2 a 3 variáveis — suficiente para personalização relevante sem tornar a mensagem dependente de dados raramente preenchidos
|
Erros comuns e soluções
Problema
| Causa provável
| Solução
|
Dropdown de templates vazio
| Nenhum template aprovado pela Meta existe para a inbox selecionada, ou templates estão em status "pendente" ou "rejeitado"
| Verifique o status dos templates na sua conta WhatsApp Business na Meta. Selecione a inbox correta antes de procurar o template
|
Variável aparece em branco no preview
| O contato usado no preview não tem o campo mapeado preenchido
| Navegue para outros contatos no preview. Considere usar filtros de audiência para incluir apenas contatos com o campo preenchido
|
Template desselecionado após trocar inbox
| O template selecionado não pertence à nova inbox
| Defina a inbox antes de selecionar o template. Se trocar a inbox, reconfirme o template selecionado
|
Envio falhou com erro de variável vazia
| Contato não tinha o campo mapeado preenchido no momento do disparo
| Corrija os dados do contato e crie uma nova campanha segmentada para os contatos que falharam
|
Mensagem final ultrapassou o limite da Meta
| Valor do campo substituído na variável é muito longo (acima de 1.024 caracteres)
| Evite mapear variáveis para campos de texto livre ou anotações longas. Prefira campos curtos como nome, cargo e empresa
|
Perguntas frequentes
O que acontece se o contato não tiver o campo mapeado preenchido?
A mensagem não será enviada para esse contato. O enrollment fica marcado como falha com indicação de campo vazio. O sistema nunca envia um template com variável em branco. Para evitar isso, filtre a audiência para incluir apenas contatos com o campo preenchido antes de lançar.
Posso usar texto fixo como valor de uma variável?
Não. O mapeamento aceita apenas campos de contato (fixos ou customizados). Se você precisa de um valor fixo em uma posição do template, inclua-o diretamente no texto do template ao submetê-lo para aprovação na Meta — não como variável.
Posso usar o mesmo template em várias etapas da mesma campanha?
Sim. Você pode selecionar o mesmo template aprovado em múltiplas etapas com mapeamentos de variáveis iguais ou diferentes. Isso é útil em sequências de follow-up onde a estrutura da mensagem é similar mas o contexto muda.
Posso alterar o mapeamento de variáveis depois que a campanha foi lançada?
Não. Após a ativação da campanha, o conteúdo das etapas — incluindo o mapeamento de variáveis — é imutável. Se precisar corrigir, pause e arquive a campanha atual e crie uma nova com o mapeamento corrigido.
Se o nome do contato for atualizado depois que a campanha foi lançada, qual valor será enviado?
O valor no momento do disparo da etapa — ou seja, o valor mais recente do campo. O sistema busca os dados atuais do contato cada vez que uma etapa é executada, não congela os dados no lançamento.
Se o envio de uma etapa falhar por variável vazia, o contato continua nas próximas etapas?
Não. Quando o disparo de uma etapa falha por variável vazia, o enrollment daquele contato é encerrado. As etapas subsequentes da sequência não são executadas para esse contato.
O que acontece se eu trocar o template depois de já ter mapeado as variáveis?
O sistema limpa todos os mapeamentos anteriores ao trocar o template. Cada template pode ter variáveis com significados diferentes — manter mapeamentos antigos criaria inconsistências. É necessário refazer o mapeamento do zero para o novo template.
O sistema bloqueia variáveis que violem políticas da Meta?
Não diretamente. O controle de conformidade de conteúdo é feito pela Meta no processo de aprovação do template. Templates rejeitados pela Meta não aparecem disponíveis na plataforma. O sistema não realiza análise de conteúdo adicional sobre os valores das variáveis no momento do envio.
Existe limite de disparos por minuto quando uso variáveis?
Não. O uso de variáveis não adiciona limitação extra à velocidade de envio. As limitações aplicadas são as mesmas de qualquer campanha WhatsApp: capacidade da inbox e limites da API da operadora.
O preview mostra exatamente o que o contato vai receber?
O preview exibe a mensagem renderizada visualmente com as variáveis substituídas e formatação do WhatsApp aplicada. Ele não exibe o payload técnico JSON enviado à API. Para auditoria técnica, consulte o histórico de execuções após o envio.