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.

Jun 25, 2026

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

  1. Vá em Canais, abra seu canal de WhatsApp e entre em Modelos.
  2. Clique em Novo modelo.
  3. 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.
  4. Escreva o corpo e insira as variáveis {{1}}, {{2}}… onde quiser os dados dinâmicos.
  5. 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.
  6. 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

Isso foi útil?

Artigos relacionados

Fale conosco no WhatsApp