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

> As variáveis no template do WhatsApp são espaços marcados, como {{1}}, que o sistema preenche com o dado de cada contato no envio: nome, produto, data. A Meta exige exemplo de valor para cada uma e rejeita template que começa ou termina com variável. A AD PRO revisa as variáveis e testa em números reais antes de disparar.

Página original: https://www.adprotecnologia.com.br/disparo-em-massa/variaveis-no-template-do-whatsapp
Autor: AD PRO Tecnologia. Publicado em 2026-10-31.

## 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.

**Mesma mensagem nos dois jeitos**

```text
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?

**Variáveis por parte do template (Meta, 31/10/2026)**

| Parte | Limite de tamanho | Variáveis |
| --- | --- | --- |
| Cabeçalho de texto | Até 60 caracteres | 1 variável |
| Corpo | Até 1.024 caracteres | Várias, com exemplo de valor para cada uma |
| Botão de URL | Link até 2.000 caracteres | 1 variável, só no final do link |
| Texto de card de carrossel | Até 160 caracteres | Aceita variáveis, e o valor conta no limite |

Mensagem e botão com variável aparecem em vários guias. Para botões, veja [botões no template do WhatsApp](https://www.adprotecnologia.com.br/disparo-em-massa/botoes-no-template-do-whatsapp). Para cards, o [carrossel no WhatsApp API](https://www.adprotecnologia.com.br/disparo-em-massa/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](https://www.adprotecnologia.com.br/disparo-em-massa/planilha-para-disparo-em-massa) mostra o arquivo completo, e o de [personalização de mensagem em massa](https://www.adprotecnologia.com.br/disparo-em-massa/personalizacao-de-mensagem-em-massa) mostra como escolher o que personalizar.

**Exemplo de ligação entre variável, coluna e cuidado**

| Variável | Coluna da planilha | Exemplo de valor | Cuidado |
| --- | --- | --- | --- |
| {{1}} | primeiro_nome | Carla | Só o primeiro nome, com maiúscula inicial |
| {{2}} | produto_ou_pedido | Pedido 4821 | Sem quebra de linha dentro da célula |
| {{3}} | data | 05/11 | Sempre o mesmo formato de data |
| {{4}} | valor | R$ 89,90 | Com R$ e vírgula, igual em todas as linhas |
| botão URL | codigo_link | carla-4821 | Sem espaço, sem acento, sem caractere especial |

**Cabeçalho de planilha pronto para colar**

```text
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)

**Aviso de entrega com 3 variáveis**

```text
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](https://www.adprotecnologia.com.br/disparo-em-massa/template-recategorizado-para-marketing).

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

**Reativação com 4 variáveis**

```text
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)

**Convite com nome, evento e data**

```text
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:

**Códigos de erro da Cloud API ligados a variáveis**

| Código | O que a Meta descreve | O que fazer |
| --- | --- | --- |
| 132000 | O número de valores enviados não bate com o número de variáveis do template | Conferir se a planilha tem uma coluna para cada variável |
| 132012 | Os valores não seguem o formato especificado no template | Padronizar datas, valores e textos na coluna |
| 132018 | Problema nos parâmetros do template (erro de validação) | Ler os erros listados, corrigir e reenviar |
| 132001 | O template não existe no idioma pedido ou ainda não foi aprovado | Conferir nome, idioma e status do template |

Todo envio de teste deveria passar por esses quatro casos. Para o panorama completo de códigos, veja [erros da API do WhatsApp](https://www.adprotecnologia.com.br/disparo-em-massa/codigos-de-erro-whatsapp-api).

## 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](https://www.adprotecnologia.com.br/disparo-em-massa/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?

> **Como a AD PRO faz:** Você envia a planilha de contatos, a copy, o criativo, o link e o objetivo. A AD PRO trata a base (remove duplicados, valida os números, padroniza DDI e DDD), confere coluna por coluna se cada variável está preenchida e no formato certo, revisa o template e envia um teste em números reais, onde dá para ver como o nome e a data aparecem de verdade. O disparo só acontece depois da sua aprovação, pela API oficial, na estrutura da AD PRO, em lotes e no dia e horário combinados. No final, o relatório de entrega.

Para saber como é o teste, veja [teste antes do disparo](https://www.adprotecnologia.com.br/disparo-em-massa/teste-antes-do-disparo). Se um template voltar reprovado, a saída está em [template reprovado no WhatsApp](https://www.adprotecnologia.com.br/crm/blog/template-reprovado-whatsapp), e a visão geral dos modelos está em [templates do WhatsApp API](https://www.adprotecnologia.com.br/crm/blog/templates-do-whatsapp-api). O serviço completo está em [disparo em massa](https://www.adprotecnologia.com.br/disparo-em-massa).

## Perguntas frequentes

### Posso começar ou terminar o template com uma variável?

Não. A Meta rejeita template que começa ou termina com parâmetro. Comece com uma saudação ou uma frase fixa e termine com um texto fixo, mesmo que curto.

### Quantas variáveis um template do WhatsApp pode ter?

A documentação da Meta aceita várias variáveis no corpo e não informa um máximo fixo, mas rejeita template com variáveis demais para o tamanho do texto. O cabeçalho de texto aceita uma, e o link do botão de URL também aceita uma, no final.

### O que é variável nomeada no template do WhatsApp?

É a variável marcada com uma palavra, como {{nome}}, em vez de um número. Você informa o nome de cada parâmetro e um valor de exemplo. Funciona igual à variável numerada, só deixa o template mais legível.

### Por que meu envio falhou com erro de parâmetros?

Os casos mais comuns são o número de valores diferente do número de variáveis (132000), formato de valor fora do esperado (132012) e erro geral de parâmetro (132018). Confira a planilha coluna por coluna.

### A AD PRO confere as variáveis antes de disparar?

Sim. A AD PRO revisa a copy, as variáveis e o template, envia um teste em números reais e só dispara depois da aprovação do cliente.

## Fontes

- [Meta for Developers, revisão de templates (motivos de rejeição)](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-review/), conferido em 2026-10-31
- [Meta for Developers, componentes de template (variáveis)](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/components), conferido em 2026-10-31
- [Meta for Developers, códigos de erro da Cloud API](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes), conferido em 2026-10-31
- [Meta for Developers, templates de carrossel de mídia](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/marketing-templates/media-card-carousel-templates), conferido em 2026-10-31

---

AD PRO Tecnologia LTDA, CNPJ 68.425.611/0001-15, São Paulo/SP. Atendimento on-line para todo o Brasil. Diagnóstico comercial gratuito de 30 minutos: https://www.adprotecnologia.com.br/#agendar. WhatsApp +55 11 98604-5939. Fatos e preços publicados: https://www.adprotecnologia.com.br/fatos