Como criar templates de WhatsApp com varíaveis

Variáveis de template WhatsApp permitem personalizar em escala as mensagens enviadas por campanhas.

Disponível em
todos os planos
Quem pode fazer
qualquer usuário com acesso ao módulo Campanhas

Nesta página8 seções

Ao invés de disparar a mesma mensagem genérica para todos os contatos, você mapeia campos do contato (nome, empresa, cargo) com as variáveis definidas no template aprovado pela Meta.


O que você precisa antes de começar

  • Ao menos um WhatsApp conectado na plataforma

  • Os contatos da audiência possuem os campos que serão mapeados preenchidos

  • Acesso ao módulo Campanhas na navegação lateral

Passo 1: Acessar a seção de templates

  1. No Menu lateral, clique em Plataforma

  2. Clique em Canais

  3. Selecione a inbox/número de WhatsApp que você quer gerenciar (aparece uma lista se você tem múltiplos)

  4. Na seção Templates de mensagens, você vê todos os templates da sua conta


Passo 2: Criar um novo template

Na aba de Templates de mensagens, clique em Criar template e preencha as informações.

Campos obrigatórios

CampoO que preencherExemplo
Nome do template Identificador único para este template (sem espaços, use underscore) primeira_abordagem_sdrs
Categoria Tipo de mensagem (MARKETING, UTILITY, AUTHENTICATION) MARKETING
Idioma Idioma da mensagem Português (Brasil)
Corpo Texto principal da mensagem “Oi #{{var_contact_f_name}}, vimos que você trabalha na #{{var_business_name}}. Podemos conversar?”

Cabeçalho

Você pode adicionar um cabeçalho que aparece acima do corpo. Escolha um tipo:

  • Texto: linha de texto adicional (ex: “Oferta Especial”)

  • Imagem: imagem em JPG ou PNG (máximo 5 MB)

  • Vídeo: vídeo em MP4 (máximo 16 MB)

  • Documento: PDF (máximo 100 MB)

Corpo

O texto principal da mensagem. Você pode usar:

  • Variáveis de personalização: var_

  • Quebras de linha: pressione Enter

  • Emojis: totalmente permitidos

Limite: máximo 1.024 caracteres

Rodapé

Texto pequeno abaixo da mensagem (ex: “Responda com SIM ou NÃO”). Máximo 60 caracteres.

Botões

Você pode combinar dois grupos de botões no mesmo template: Respostas rápidas (Quick Reply) e Botões de Ação (CTA — URL e Telefone). No formulário de template, cada grupo tem seu próprio switch Habilitado/Desabilitado e configuração independente.

Respostas rápidas (Quick Reply)

Botões que enviam uma resposta predefinida quando o contato clica — ex: “Sim, quero conversar”, “Agendar demo”, “Não tenho interesse”. Cada resposta rápida vira uma mensagem do próprio contato no histórico da conversa.

Botões de Ação (CTA)

Ative o switch Botões de Ação para adicionar até 2 botões de URL e 1 botão de Telefone no mesmo template. Cada botão tem:

CampoO que preencherLimite
Texto do botão Rótulo visível ao contato (ex: “Saiba mais”, “Falar agora”) Máximo 25 caracteres
URL (somente botão Link) Endereço de destino — obrigatoriamente HTTPS URL completa com protocolo https://
Telefone (somente botão Telefone) Número formatado em padrão internacional (ex: +5511999999999) Inclua código do país

Regras do Meta para CTA:

  • Máximo 2 botões URL + 1 botão Telefone por template (3 CTAs no total)

  • URLs aceitam apenas https:// — http:// é rejeitado pelo Meta

  • Encurtadores (bit.ly, tinyurl) podem aumentar o tempo de aprovação ou gerar rejeição — prefira URL completa do seu próprio domínio

  • Você pode combinar CTAs com respostas rápidas no mesmo template


Passo 3: Entender variáveis de personalização

Variáveis permitem que você personalize a mensagem para cada contato sem criar templates repetidos. Para visualizar todas as variáveis disponíveis, digite var_. Um popup será exibido com as opções disponíveis — basta selecionar a variável que deseja utilizar.

Regras de nome das variáveis (validação na criação)

A Nuvia verifica os nomes das variáveis antes de deixar você salvar o template, seguindo as regras da Meta. Enquanto houver uma variável fora do padrão, o botão de salvar fica desabilitado e a plataforma mostra qual variável ajustar. As regras dependem do formato do template:

  • Formato posicional: use só números, como #{{1}}, #{{2}}. Qualquer outra coisa é recusada.

  • Formato nomeado: use só letras, números e underscore (_), começando por letra ou underscore — por exemplo, name ou order_number. Nome com número puro não vale no formato nomeado.

Além disso, no formato nomeado cada nome pode ter no máximo 20 caracteres — acima disso a Meta rejeita o template na revisão, então a Nuvia já barra na criação.


Passo 4: Submeter para aprovação do Meta

Depois de preencher todos os campos, clique em Submeter para aprovação.

A Nuvia envia o template para os servidores do Meta para análise. Você verá status Pendente até o template ser aprovado.


Passo 5: Acompanhar aprovação e reagir a rejeições

Para verificar se o template foi aprovado, clique no ícone de atualização ao lado de Status:

Você verá o status em tempo real na seção Templates de mensagens. Possíveis status:

StatusSignificadoO que fazer
Pendente Enviado, aguardando análise do Meta Aguarde. Você pode usar o template após aprovação
Aprovado Template pronto para usar Use em campanhas, Follow-ups e Funis Inteligentes
Reprovado Meta rejeitou o template Ajuste e resubmeta

Motivos comuns de rejeição de templates:

MotivoCausaSolução
“Conteúdo muito promocional” Muitas palavras em CAPS, muitos exclamações Reescreva com tom mais profissional
“Falta de opt-in claro” Não deixa claro que a pessoa autorizou contato Adicione frase como “Você recebe isso porque se cadastrou em…”
“URL suspeita” Link encurtado ou domínio desconhecido Use URL completa do seu domínio
“Solicita dados sensíveis” Pede senha, cartão, CPF Nunca peça dados pessoais em template inicial
“Semelhança com spam” Linguagem robótica ou excesso de símbolos Use tom natural e profissional

Ajuste o template e resubmeta o template. A Meta revisará novamente (leva minutos).

Um template rejeitado bloqueia campanhas que o usam. Resubmeta rapidamente para retomar operações.


Boas práticas para templates aprovados rapidamente

  1. Seja claro sobre o contexto — indique por que você está enviando (“Vi seu perfil no LinkedIn”, “Você se cadastrou em…”). Não envie para contatos sem contexto de consentimento prévio.

  2. Evite linguagem de spam — sem “APROVEITE AGORA!”, “OFERTA IMPERDÍVEL”, “ÚLTIMA CHANCE”; sem múltiplos exclamações ou símbolos; sem CAPS excessivo.

  3. Use variáveis para personalização — A Meta favorece templates personalizados em relação a genéricos.

  4. Mantenha templates curtos — máximo 1.024 caracteres no corpo, mas idealmente 200–500. Mensagens longas têm menor taxa de resposta.

  5. Inclua call-to-action claro — “Responda com SIM para agendar”, “Clique no botão abaixo para conversar”. Botões com texto rápido aumentam engajamento.


Limites e restrições

LimiteValor
Máximo de templates por número 6.000
Caracteres no corpo Máximo 1.024
Caracteres no rodapé Máximo 60
Componentes de imagem/vídeo 1 arquivo, máx 5 MB (imagem) ou 16 MB (vídeo)
Botões por template Até 3 CTA (2 URL + 1 Telefone) — somados a respostas rápidas
Texto do botão CTA Máximo 25 caracteres
URL em botão CTA Apenas HTTPS — http:// é rejeitado pelo Meta
Variáveis por template Até 10 (#{{1}} até #{{10}})
Tempo de aprovação Minutos a horas (Meta não garante)

Perguntas frequentes

Criei um template, mas vejo o status “Reprovado”. Posso enviar mesmo assim?

Não. Campanhas que usam templates não aprovados simplesmente não serão disparadas. Aguarde a aprovação do Meta.

Posso editar um template depois de aprovado?

Não. Caso queira editar, você precisará criar um novo template.

Meu template foi rejeitado 3 vezes. Qual é o limite?

Não há limite técnico. Você pode resubmeter quantas vezes quiser. Mas se continua rejeitando, revise profundamente: procure ajuda no suporte Nuvia ou consulte as políticas do Meta.

Eu posso usar o mesmo template para campanhas de LinkedIn e WhatsApp?

Não. Templates HSM são exclusivamente para WhatsApp. Para LinkedIn, use mensagens com variáveis no módulo de Campanhas.

Se meu número de WhatsApp for suspendido, perco os templates?

Os templates ficam armazenados na Meta. Se recuperar o número, você recupera acesso aos templates. Se mudar de número, precisará recriar no novo número.

Qual categoria de template devo escolher (Marketing ou Utility)?

Na maioria dos casos, escolha Marketing (promoções, follow-ups, agendamento). Use Utility para atualizações operacionais (confirmar reunião, aviso de atraso).

Posso adicionar botão de link (URL) e botão de telefone no mesmo template?

Sim. A Nuvia suporta até 2 botões de URL e 1 botão de Telefone no mesmo template, além das respostas rápidas. Ative o switch Botões de Ação no formulário de template e adicione cada botão clicando em Link (URL) ou Telefone. O texto de cada botão tem limite de 25 caracteres.

A URL do botão pode ser HTTP ou só HTTPS?

Apenas HTTPS. A Nuvia bloqueia o envio do template se a URL não começar com https://, e o Meta também rejeita URLs em HTTP. Use o endereço completo do seu domínio com certificado válido — não use encurtadores (bit.ly, tinyurl) pois aumentam o risco de rejeição.

O número do botão de telefone precisa estar em algum formato específico?

Sim, use o padrão internacional com sinal de mais e código do país.

Tentei criar um template e apareceu uma mensagem de erro. O que ela significa?

Quando o Meta recusa o template na criação, a Nuvia mostra o motivo específico devolvido pelo Meta, traduzido para português quando reconhecido. A mensagem indica o que ajustar — por exemplo: usar link direto do WhatsApp (wa.me ou api.whatsapp.com) em botão não é permitido; a conta atingiu o limite de 250 templates; algum campo excede o limite de caracteres; ou há variável no início ou no fim do texto. Corrija o ponto indicado e tente novamente.

Espaços em branco no começo ou no fim dos campos causam erro?

Não. A Nuvia remove automaticamente espaços em branco no início e no fim do nome do template, do texto dos botões, da URL e do telefone antes de enviar ao Meta. Ainda assim, campos obrigatórios (como o texto do botão) não podem ficar vazios.

Por que não consigo salvar o template com o nome de variável que escolhi?

O nome da variável provavelmente está fora do padrão da Meta. No formato posicional, use só números (1, 2). No formato nomeado, use só letras, números e underscore, começando por letra ou underscore, com no máximo 20 caracteres — nada de hífen, espaço ou acento. Quando o nome tem um desses caracteres, a Nuvia sugere a forma corrigida para você aplicar com um clique. Enquanto houver variável inválida, o botão de salvar fica desabilitado.

Este artigo ajudou?