Variáveis em template do WhatsApp: como usar sem reprovar nem quebrar o envio

Como funcionam as variáveis num template do WhatsApp?

O template é um texto fixo aprovado pela Meta. Para a mensagem não sair igual para todo mundo, você marca pontos do texto como variáveis. No envio, cada marcação recebe o valor de um contato, e a mesma mensagem aprovada sai com o nome, o produto ou a data de cada um.

A Meta aceita dois jeitos de marcar. No jeito posicional, você usa números entre chaves duplas: {{1}}, {{2}}, {{3}}. No jeito nomeado, usa palavras, como {{nome}} e {{produto}}, e informa o nome de cada parâmetro. Em qualquer dos dois, o corpo precisa de valores de exemplo, porque a análise usa esses exemplos para entender a mensagem.

Posicional:
Oi, {{1}}! O pedido {{2}} da [Nome da loja] saiu para entrega e chega {{3}}.
Exemplos: 1 = Carla, 2 = 4821, 3 = amanhã

Nomeado:
Oi, {{nome}}! O pedido {{pedido}} da [Nome da loja] saiu para entrega e chega {{previsao}}.
Exemplos: nome = Carla, pedido = 4821, previsao = amanhã

O jeito nomeado ajuda quem mantém muitos templates, porque o nome diz o que vai ali. O posicional é mais comum e funciona igual. O que importa é a planilha de envio bater com a ordem ou com os nomes.

Onde cada variável pode ficar no template?

Mensagem e botão com variável aparecem em vários guias. Para botões, veja botões no template do WhatsApp. Para cards, o carrossel no WhatsApp API.

Que regras de variável fazem a Meta reprovar o template?

A página de revisão de templates lista os motivos de rejeição ligados a variáveis. Conferir estes cinco itens antes de submeter evita a maior parte das reprovações:

1. Variável no começo ou no fim. O template não pode começar nem terminar com parâmetro (a Meta chama de dangling parameters). Comece com uma saudação e termine com uma frase.
2. Chaves erradas. Variáveis faltando ou com chaves desencontradas, como {{1} ou {1}}, são rejeitadas.
3. Fora de sequência. {{1}}, {{2}}, {{5}}, {{4}} reprova. Numere em ordem, sem pular.
4. Variáveis demais para o tamanho do texto. Se a mensagem é curta e tem muitos parâmetros, a análise rejeita. Alongue o texto fixo ou reduza as variáveis.
5. Sem exemplo. Se o template usa variável, é preciso enviar valores de exemplo na criação do modelo.

Como ligar as colunas da planilha às variáveis?

Cada variável do template é uma coluna da planilha. A coluna precisa existir para todos os contatos, com o mesmo formato. O guia de planilha para disparo em massa mostra o arquivo completo, e o de personalização de mensagem em massa mostra como escolher o que personalizar.

telefone | primeiro_nome | produto_ou_pedido | data | valor | codigo_link
5511999990001 | Carla | Pedido 4821 | 05/11 | R$ 89,90 | carla-4821
5521999990002 | Marcos | Pedido 4822 | 06/11 | R$ 120,00 | marcos-4822

Regras:
- 1 linha por contato, 1 coluna por variável
- telefone com 55 + DDD + número, só dígitos
- nenhuma célula vazia nas colunas usadas pelo template
- datas e valores sempre no mesmo formato
- sem texto de várias linhas dentro de uma célula

Que modelos de template com variáveis funcionam?

Os exemplos abaixo usam poucas variáveis, cada uma com função clara. Quanto mais variáveis, maior a chance de erro de dado e de reprovação por excesso de parâmetros.

Modelo 1: aviso de pedido (utilidade)

Olá, {{1}}! Seu pedido {{2}} da [Nome da loja] saiu para entrega e deve chegar {{3}}. Se ninguém puder receber, responda esta mensagem e combinamos outro horário.

Aviso específico de um pedido que a pessoa fez, sem oferta, é o perfil de utilidade. Se entrar cupom ou promoção, a Meta trata como marketing. A explicação completa está em template recategorizado para marketing.

Modelo 2: reativação com produto e data (marketing)

Oi, {{1}}! Faz tempo desde sua última compra de {{2}} na [Nome da loja], em {{3}}. Preparamos uma condição para você voltar: {{4}}. Para ver os detalhes, toque em Ver oferta. Para sair da lista, responda SAIR.

Modelo 3: convite para evento (marketing)

Oi, {{1}}! A [Nome da empresa] vai receber {{2}} no dia {{3}}, e você está na nossa lista de convidados. Quer reservar seu lugar? Toque em Confirmar presença. Para não receber mais convites, responda SAIR.

Que erros de envio as variáveis causam e como resolver?

Mesmo com template aprovado, o envio pode falhar por problema de dado. A API devolve um código que diz o que aconteceu. Estes são os mais ligados a variáveis, segundo a documentação oficial de códigos de erro:

Todo envio de teste deveria passar por esses quatro casos. Para o panorama completo de códigos, veja erros da API do WhatsApp.

Como evitar variável vazia ou estranha na mensagem?

• Tenha um valor padrão. Se não há primeiro nome, o campo vira Cliente, e a mensagem não sai com a variável em branco. Uma lista bem tratada reduz esse caso, como em limpeza de base para disparo.
• Padronize a caixa do texto. Nome em maiúsculas inteiras (CARLA) parece grito, e nome tudo em minúscula parece erro.
• Corte nome composto. João Pedro da Silva vira João Pedro ou João, conforme o tom da marca.
• Uma informação por variável. Variável que carrega frase inteira estoura limite e reprova mais fácil.
• Cuidado com valores com muitas linhas. Mantenha cada valor numa linha só e sem espaços repetidos, porque isso mantém a mensagem limpa no celular.
• Teste com dados reais, inclusive os piores: nome longo, nome com acento, campo vazio.

Como a AD PRO revisa as variáveis do seu disparo?

Para saber como é o teste, veja teste antes do disparo. Se um template voltar reprovado, a saída está em template reprovado no WhatsApp, e a visão geral dos modelos está em templates do WhatsApp API. O serviço completo está em disparo em massa.