Variáveis dinâmicas e valores de exemplo em modelos
Personalize seus modelos de WhatsApp com variáveis {{1}}, {{2}} e defina os valores de exemplo que a Meta exige para aprovar o modelo.
As variáveis dinâmicas permitem reutilizar um mesmo modelo de WhatsApp aprovado mudando apenas alguns dados (o nome do cliente, um número de pedido, uma data…). Em vez de criar um modelo por contato, você escreve marcadores como {{1}} ou {{2}} e os preenche no momento do envio.
Como funcionam as variáveis
Uma variável é um número entre chaves duplas: {{1}}, {{2}}, {{3}}… São numeradas de forma sequencial a partir de 1. Você pode colocá-las em:
- O corpo da mensagem (até 10 variáveis).
- O cabeçalho de texto (1 variável).
- A URL de um botão de link.
Exemplo de corpo:
Olá {{1}}, seu pedido {{2}} já está a caminho e chegará no dia {{3}}.
Requisitos
- Um canal de WhatsApp conectado.
- Permissão de gestão de modelos (um perfil com
templates.manage). - A Meta exige um valor de exemplo para cada variável antes de aprovar o modelo.
Passos para criar um modelo com variáveis
- Vá em Canais, abra seu canal de WhatsApp e entre em Modelos.
- Clique em Novo modelo.
- Dê um nome em snake_case (letras minúsculas, números e sublinhados, começando por uma letra), escolha a categoria (marketing, utility ou authentication) e o idioma.
- Escreva o corpo e insira as variáveis
{{1}},{{2}}… onde quiser os dados dinâmicos. - Ao detectar cada
{{N}}, aparece um campo de valor de exemplo. Escreva um valor realista (para{{1}}, por exemplo: "Maria"). Esses são os valores que a Meta vê durante a revisão e os que a pré-visualização ao vivo exibe. - Revise a pré-visualização, adicione cabeçalho, rodapé e botões se precisar e clique em Enviar à Meta.
Preencher as variáveis ao enviar
Ao responder na Caixa de entrada, abra o seletor de modelos, escolha o modelo e verá um campo para cada variável. Escreva o valor real para aquele contato e envie.
Via API, use o endpoint de envio de modelos com os valores indexados:
POST /api/v1/conversations/{conversation}/templates/send
{
"template_id": 123,
"body_params": { "1": "Maria", "2": "#A-5567", "3": "sexta-feira, 27" }
}
As chaves de body_params são o número da variável (1, 2, 3…). Para botões com URL dinâmica use button_params.
Verificação
- Na pré-visualização, as variáveis são substituídas pelos seus valores de exemplo: nenhum
{{N}}deve ficar visível. - Após o envio, o modelo fica com status pendente até a Meta aprová-lo.
Se não funcionar
- A Meta rejeita o modelo por falta de exemplos: confirme que preencheu um valor de exemplo para cada
{{N}}. - Numeração com lacunas: as variáveis devem ser consecutivas (
{{1}},{{2}}…). Não pule de{{1}}para{{3}}. - O corpo excede o limite: o corpo aceita até 1024 caracteres já substituídos.
- Você não consegue editá-lo: um modelo já aprovado não pode ser alterado; crie uma nova versão.
Dicas
- Mantenha um mapeamento mental (1 = nome, 2 = pedido) e use a mesma ordem em todos os seus modelos para evitar enganos.
- Não coloque duas variáveis seguidas sem texto entre elas (
{{1}} {{2}}): a Meta costuma rejeitar.
Artigos relacionados
Artigos relacionados
-
Códigos de erro do WhatsApp (Meta): o que significam e o que fazer
Tabela com os códigos de erro da Meta mais comuns ao enviar pelo WhatsApp (131026, 131047, 131049, 130497, 141006, 131031, 131056, 132000, 190, 368…) e como resolver cada um.
-
Como conectar o Telegram
Conecte um bot do Telegram à sua caixa de entrada do Omnifox em minutos usando o BotFather.
-
Comentários do Instagram e do Facebook: responder e moderar pelo Omnifox
Veja e responda os comentários das suas publicações e anúncios do Facebook e do Instagram, em público ou no privado, e configure respostas automáticas.
-
Enviar e receber vídeos em cada canal: formatos e tamanhos máximos
Quais vídeos você pode enviar e receber pelo WhatsApp, Instagram, Messenger, Telegram, chat do site e e-mail, com os tamanhos máximos reais e o que fazer com um vídeo pesado.
-
Conectar o WhatsApp escaneando um código QR
Vincule seu WhatsApp ao Omnifox em um minuto, como no WhatsApp Web. Ideal para testar: tem limites, não permite campanhas e não é a API oficial.