API oficial do WhatsApp

Como personalizar mensagem em massa com dados da sua planilha

Resposta rápida

Para personalizar mensagem em massa no WhatsApp, você cria variáveis no template, como {{1}} e {{2}}, e liga cada uma a uma coluna da planilha de contatos: nome, produto, data, cidade. No envio, cada pessoa recebe o texto com os próprios dados. A AD PRO confere as colunas, as variáveis e o resultado no teste antes de disparar.

Por AD PRO TecnologiaPublicado em 8 min de leitura
Neste conteúdo (9 partes)

Como funciona a personalização em um disparo de WhatsApp?

A mensagem em massa pela API oficial sai de um template aprovado. O texto fixo não muda, e os pontos marcados com variáveis recebem um valor diferente para cada contato. Quem monta o template define onde ficam as variáveis. Quem monta a planilha define o que entra em cada uma.

Pense numa mala direta digital: o modelo é um só, a base tem uma linha por pessoa e o sistema junta os dois no envio. A diferença é que, no WhatsApp, o modelo passa pela análise da Meta antes (veja o prazo de aprovação), e os valores precisam respeitar as regras de variável.

O que vale a pena personalizar além do nome?

O nome abre a conversa, mas quem faz a mensagem parecer escrita para a pessoa é o dado que importa a ela. Escolha poucos campos e escolha bem.

Campos de personalização, quando usar e o cuidado de cada um
Campo (coluna)Quando usarCuidado
Primeiro nomeQuase sempre, na aberturaPadronize a capitalização e use só o primeiro nome
Produto ou serviço de interesseRemarketing, recompra, lançamentoSó use se o dado for confiável
Data (vencimento, evento, aniversário)Lembretes e convitesPadronize o formato: dd/mm
Cidade ou unidadeRede com várias lojas ou campanha regionalConfira se o nome da cidade está sem abreviação
Consultor ou vendedor responsávelBase que já tem atendimento definidoO vendedor precisa estar preparado para responder
Link próprio do contatoPedido, proposta, cadastroVai no botão de URL, com a variável no fim do endereço
Valor ou condiçãoOferta com preço específicoO valor precisa ser verdadeiro na hora do envio

Quais são as regras das variáveis no template?

As regras abaixo vêm da documentação da Meta para criação e revisão de templates. Quebrar uma delas é uma das causas mais comuns de reprovação.

  • Formato: as variáveis numeradas usam chaves duplas, como {{1}}, {{2}}, sempre em sequência. Também existem variáveis com nome descritivo, como {{data_do_evento}}.
  • Posição: o corpo não pode começar nem terminar com variável. Sempre deve haver texto antes da primeira e depois da última.
  • Exemplo obrigatório: na criação, cada variável precisa de um valor de exemplo. A Meta usa esse exemplo para entender o contexto.
  • Proporção: variável demais para um texto curto reprova. Mensagem curta com cinco variáveis parece modelo vazio.
  • Cabeçalho: o texto do cabeçalho aceita no máximo 1 variável e 60 caracteres.
  • Corpo: até 1.024 caracteres, contando o texto fixo e o espaço dos valores.
  • Botão de link: aceita 1 variável, no fim do endereço.

O detalhe de cada limite está no guia de variáveis no template do WhatsApp. Aqui o foco é outro: preparar a planilha que alimenta essas variáveis.

Como preparar a planilha para alimentar as variáveis?

Uma coluna para cada variável, na ordem em que aparecem no template, mais as colunas de controle. Quanto mais limpa a planilha, menos surpresa no teste.

Modelo de planilha para personalização (copie as colunas)
telefone | nome | produto | data | cidade | consultor | origem_do_contato
5511999990001 | Mariana | tênis de corrida | 15/11 | Campinas | Rafael | cadastro no site
5521988880002 | Carlos | mochila 30L | 16/11 | Niterói | Bianca | compra em loja
5531977770003 | Ana | tênis de corrida | 15/11 | Betim | Rafael | cadastro no site

Regras:
- telefone: só números, com 55 + DDD + número, sem espaço, traço ou parênteses
- nome: só o primeiro nome, com inicial maiúscula
- data: sempre dd/mm
- nenhuma linha com célula vazia nas colunas usadas no template
- origem_do_contato: onde a pessoa deu o número (prova de opt-in)

Duas fórmulas resolvem a maioria dos problemas de nome. Em uma planilha em português, pegue o primeiro nome com ESQUERDA e LOCALIZAR, e acerte as maiúsculas com PRI.MAIÚSCULA. Dependendo da configuração regional do arquivo, o separador dos argumentos é ponto e vírgula ou vírgula.

Fórmulas para limpar o nome (coluna A = nome completo)
Primeiro nome:
=ESQUERDA(A2; LOCALIZAR(" "; A2 & " ") - 1)

Inicial maiúscula:
=PRI.MAIÚSCULA(B2)

Tudo em uma célula:
=PRI.MAIÚSCULA(ESQUERDA(A2; LOCALIZAR(" "; A2 & " ") - 1))

Depois de aplicar, copie a coluna e use "colar somente valores", para o arquivo enviado não carregar fórmulas.

Se a sua base ainda está bagunçada, comece por higienização de base de contatos e pelo formato de telefone para disparo. O modelo completo de planilha que a AD PRO recebe está em planilha para disparo em massa.

Quais modelos de mensagem personalizada posso copiar?

Os três modelos abaixo usam empresas fictícias e servem como ponto de partida. Troque pelos dados da sua operação, mantenha o nome da empresa e a opção de sair.

Modelo 1: reativação por produto de interesse (marketing)
Oi, {{1}}! Aqui é da Loja Exemplo. Na sua última visita você olhou {{2}}. Chegou reposição em {{3}} e separamos uma condição para quem já é cliente. Quer receber os detalhes?

Rodapé: Para não receber mais, responda SAIR
Botões: Quero os detalhes | Agora não

Exemplo de valores: {{1}} = Mariana | {{2}} = tênis de corrida | {{3}} = Campinas
Modelo 2: lembrete com data (clínica fictícia, informativo)
Olá, {{1}}. A Clínica Exemplo lembra que seu retorno está previsto para {{2}}. Se quiser escolher outro horário, é só tocar no botão abaixo.

Rodapé: Para parar de receber lembretes, responda SAIR
Botões: Ver horários | Já agendei

Exemplo de valores: {{1}} = Carlos | {{2}} = 18/11
Modelo 3: convite por cidade (rede de lojas fictícia)
Oi, {{1}}! A Rede Exemplo abre uma loja nova em {{2}} no dia {{3}}. Quem já é cliente ganha entrada antecipada. Quer confirmar presença?

Rodapé: Para não receber mais, responda SAIR
Botões: Confirmo | Não vou

Exemplo de valores: {{1}} = Ana | {{2}} = Betim | {{3}} = 22/11

Quais erros de personalização quebram o envio ou parecem spam?

  • Nome em caixa alta ou com sobrenome: "Olá, MARIANA SOUZA LIMA" soa como cadastro automático. Use só o primeiro nome com inicial maiúscula.
  • Célula vazia: a frase fica quebrada, como "Oi, ! Você olhou ". Preencha todas as colunas usadas ou separe essas pessoas em outra lista com outro texto.
  • Dado desatualizado: citar um produto que a pessoa já comprou ou uma data que já passou derruba a confiança e aumenta o bloqueio.
  • Variável demais: cada campo extra é um ponto de erro. Três variáveis bem escolhidas rendem mais do que seis.
  • Data em formato misto: 15/11 numa linha e 2026-11-15 em outra gera mensagens inconsistentes.
  • Personalização sem opt-in: nome certo em lista sem autorização continua sendo mensagem indesejada.
  • Segmento errado: o nome certo na oferta errada não resolve. Segmente antes de personalizar (veja segmentação de lista para disparo).

A personalização muda algo em LGPD e opt-in?

Muda o cuidado, não a regra. A política do WhatsApp só permite contatar quem deu o número e aceitou receber mensagens daquela empresa, e o pedido de saída precisa ser respeitado. Usar o nome e a compra da pessoa deixa a mensagem mais pessoal, o que torna ainda mais importante que ela tenha autorizado. Na LGPD, a empresa dona da base costuma ser a controladora dos dados, e quem executa o disparo por instrução dela atua como operadora. Por isso o texto da mensagem deve usar só os dados necessários para o objetivo da campanha.

O cliente garante que a base autorizou receber mensagens da empresa dele. A AD PRO trata a base e orienta sobre opt-in e saída. A página sobre LGPD no disparo em massa aprofunda o assunto.

Como a AD PRO confere a personalização antes de disparar?

Se as respostas à mensagem personalizada precisarem chegar ao vendedor certo, elas podem ir para o time comercial, para o CRM da empresa ou para o fluxo combinado. Quem ainda não tem CRM pode ver a implementação de CRM da AD PRO.

Perguntas frequentes

Como personalizar mensagem em massa no WhatsApp?

Crie um template com variáveis numeradas, como {{1}} e {{2}}, e ligue cada variável a uma coluna da planilha. No envio, cada contato recebe o texto com os próprios dados. A Meta exige um valor de exemplo para cada variável e não aceita variável no início ou no fim do corpo.

Posso colocar o nome do cliente em todas as mensagens?

Pode, desde que a pessoa tenha autorizado receber mensagens da sua empresa. Use só o primeiro nome, com inicial maiúscula, e confira no teste como ele aparece. Nome em caixa alta ou com erro de cadastro faz a mensagem parecer automática.

Quantas variáveis posso usar em um template?

O corpo aceita várias variáveis, mas a Meta reprova modelos com variáveis demais para o tamanho do texto. O cabeçalho de texto aceita 1 variável e o botão de link também aceita 1. Na prática, três ou quatro variáveis bem escolhidas funcionam melhor do que muitas.

O que acontece se uma célula da planilha estiver vazia?

A frase pode sair quebrada ou o envio dessa linha pode falhar. Por isso a AD PRO confere as colunas usadas no template antes do teste e separa quem está com dado faltando. O ideal é preencher a coluna ou usar outro texto para essas pessoas.

A AD PRO faz o teste da personalização antes do disparo?

Sim. A AD PRO envia o teste em números reais e só dispara depois da sua aprovação. O teste mostra como ficaram nome, data, produto, mídia, link e botões. Veja mais em teste de disparo antes de enviar.

Fontes
AD PRO Tecnologia

Envie a planilha e veja a personalização no teste

Mande a base, a copy e o link para a AD PRO. A gente confere as colunas, testa com você em números reais e só dispara depois da sua aprovação.

  • Disparo pela API oficial do WhatsApp, da estrutura da AD PRO
  • Base tratada: sem duplicados, números validados, DDI e DDD padronizados
  • Teste em números reais antes de disparar, com a sua aprovação
  • Preço final já com a tarifa da Meta, pago só pelo que foi entregue
  • Relatório de entrega por campanha

Já é cliente? Crie a demanda, aprove o teste e baixe o relatório no portal de disparos, operado com a Nexor Company, empresa parceira do mesmo grupo.

Suas informações ficam com o time da AD PRO. Nada de spam.