As variáveis permitem personalizar automaticamente as mensagens enviadas em campanhas do WhatsApp. Com elas, é possível incluir informações como nome do contato, número de telefone, agente responsável e identificador da conversa.
Em vez de enviar uma mensagem genérica para todos os contatos, a plataforma substitui cada variável pelos dados correspondentes de cada destinatário.
Exemplo de personalização
Ao configurar uma campanha com a seguinte mensagem:
Olá, {{contact.first_name}}!
Temos uma condição especial para você.
Cada contato receberá a mensagem com seu próprio nome:
Olá, João!
Temos uma condição especial para você.
Como adicionar uma variável na campanha
Para configurar uma campanha personalizada:
-
Acesse o menu Campanhas.
-
Selecione a opção WhatsApp.
-
Clique em Criar campanha.
-
Informe o título da campanha.
-
Selecione o canal do WhatsApp que será utilizado.
-
Escolha o modelo de mensagem aprovado.
-
No campo Variáveis, informe a variável que deverá substituir o parâmetro do modelo.
-
Selecione o público da campanha.
-
Defina a data e o horário do envio.
-
Revise as informações e clique em Criar.
Ao preencher o campo Variáveis, a visualização do modelo será atualizada para mostrar onde a informação será inserida.
Formato correto das variáveis
Nas campanhas, as variáveis devem ser informadas entre duas chaves de abertura e duas chaves de fechamento.
Exemplo:
{{contact.first_name}}
Não altere o nome interno da variável.
Correto
{{contact.first_name}}
Incorreto
{{nome_do_contato}}
{contact.first_name}
{{ contact.first_name }}
Para evitar erros, utilize a variável exatamente como apresentada nesta documentação.
Variáveis disponíveis
Variáveis da conversa
conversation.id
Retorna o identificador numérico da conversa.
Na campanha, utilize:
{{conversation.id}}
Exemplo:
O número do seu atendimento é {{conversation.id}}.
Variáveis do contato
contact.id
Retorna o identificador numérico do contato.
{{contact.id}}
contact.name
Retorna o nome completo do contato.
{{contact.name}}
Exemplo:
Olá, {{contact.name}}!
contact.first_name
Retorna somente o primeiro nome do contato.
{{contact.first_name}}
Exemplo:
Olá, {{contact.first_name}}! Tudo bem?
Essa é uma das variáveis mais recomendadas para campanhas, pois deixa a mensagem mais pessoal e natural.
contact.last_name
Retorna o sobrenome do contato.
{{contact.last_name}}
contact.phone_number
Retorna o número de telefone cadastrado para o contato.
{{contact.phone_number}}
Exemplo:
O número cadastrado em nosso sistema é {{contact.phone_number}}.
Variáveis do agente
agent.name
Retorna o nome completo do agente responsável.
{{agent.name}}
Exemplo:
Meu nome é {{agent.name}} e estou entrando em contato para continuar seu atendimento.
agent.first_name
Retorna somente o primeiro nome do agente.
{{agent.first_name}}
agent.last_name
Retorna o sobrenome do agente.
{{agent.last_name}}
agent.phone_number
Retorna o número de telefone cadastrado para o agente.
{{agent.phone_number}}
Exemplo de campanha personalizada
Considere o seguinte modelo:
Olá, {{contact.first_name}}!
Aqui é {{agent.first_name}}, da nossa equipe de atendimento.
Estamos entrando em contato para apresentar uma condição especial para você.
Caso tenha alguma dúvida, basta responder a esta mensagem.
Para um contato chamado João e um agente chamado Maria, o resultado será:
Olá, João!
Aqui é Maria, da nossa equipe de atendimento.
Estamos entrando em contato para apresentar uma condição especial para você.
Caso tenha alguma dúvida, basta responder a esta mensagem.
Como configurar campanhas com mais de uma variável
Quando o modelo possuir mais de um campo dinâmico, preencha cada variável de acordo com a posição apresentada na tela de criação da campanha.
Exemplo de modelo:
Olá, {{contact.first_name}}!
Meu nome é {{agent.first_name}} e vou acompanhar seu atendimento.
Nesse caso, utilize:
{{contact.first_name}}
para o campo correspondente ao nome do contato e:
{{agent.first_name}}
para o campo correspondente ao nome do agente.
Respeite sempre a ordem dos campos exibidos na configuração da campanha.
Como selecionar o público da campanha
No campo Público, selecione as etiquetas dos contatos que deverão receber a mensagem.
Antes de criar a campanha, confirme se:
-
Os contatos possuem números de telefone válidos;
-
As etiquetas selecionadas correspondem ao público correto;
-
Os dados utilizados pelas variáveis estão preenchidos;
-
O modelo escolhido está aprovado e disponível no canal selecionado.
Agendamento da campanha
No campo Horário agendado, informe a data e o horário em que a campanha deverá começar.
Antes de concluir, revise:
-
O canal selecionado;
-
O modelo do WhatsApp;
-
As variáveis;
-
O público;
-
A data e o horário do envio.
Após a criação, a campanha será exibida na lista de campanhas do WhatsApp com seu respectivo status.
Boas práticas
Utilize o primeiro nome do contato
Para mensagens promocionais, reativações e lembretes, prefira:
{{contact.first_name}}
Essa variável geralmente deixa a comunicação mais natural do que o nome completo.
Evite depender de informações não preenchidas
Uma variável somente poderá ser substituída corretamente quando a informação estiver disponível no cadastro.
Por exemplo, se o contato não possuir nome cadastrado, a variável:
{{contact.first_name}}
poderá não apresentar o resultado esperado.
Faça um envio de teste
Antes de enviar uma campanha para muitos contatos, crie uma etiqueta de teste e envie a mensagem para um grupo reduzido.
Confira se:
-
As variáveis foram substituídas;
-
Os nomes foram apresentados corretamente;
-
A formatação da mensagem foi mantida;
-
Os botões e links do modelo estão funcionando;
-
O modelo está associado ao canal correto.
Não altere os nomes das variáveis
Os nomes técnicos devem ser mantidos exatamente como estão:
conversation.id
contact.id
contact.name
contact.first_name
contact.last_name
contact.phone_number
agent.name
agent.first_name
agent.last_name
agent.phone_number
Problemas comuns
A variável apareceu como o na mensagem
Verifique se ela foi escrita entre duas chaves:
{{contact.first_name}}
Também confirme se o nome da variável foi digitado corretamente.
O nome do contato não apareceu
Confira se o nome está preenchido no cadastro do contato.
Também verifique se foi utilizada a variável adequada:
{{contact.name}}
para o nome completo ou:
{{contact.first_name}}
para somente o primeiro nome.
A informação do agente ficou vazia
Confirme se os dados do agente estão cadastrados e se existe um agente relacionado ao cono do envio.
Faça um teste antes de utilizar variáveis agent.* em campanhas maiores.
A campanha foi criada para o público errado
Revise as etiquetas selecionadas no campo Público. A campanha será direcionada aos contatos vinculados às etiquetas escolhidas.
Conclusão
O uso de variáveis torna as campanhas do WhatsApp mais personalizadas e relevantes para cada contato.
Antes de realizar um envio em massa, revise o modelo, confira os cadastros e execute uma campanha de teste. Isso reduz erros e garante que cada destinatário receba a mensagem com as informações corretas.