O que são variáveis nas ações de campanhas?
As variáveis, também chamadas de campos dinâmicos, são marcadores que podem ser inseridos no texto das mensagens das ações de campanhas. No momento do disparo, o sistema substitui automaticamente cada variável pelo dado real do cliente ou do pedido.
Exemplo:
Olá, {{primeiro-nome-cliente}}! Obrigado por comprar na {{nome-da-loja}}.
No momento do envio, o cliente receberá algo como:
Olá, Maria! Obrigado por comprar na Loja Exemplo.
Dica: para não errar a escrita, insira as variáveis clicando nelas na lista de campos dinâmicos do editor de mensagem.
Regra importante sobre variáveis
⚠️ Utilize apenas variáveis que existirão no momento do disparo da campanha.
Exemplo: em uma campanha para notificar que o pedido foi aprovado, não utilize a variável código de entrega, pois nesse momento o código ainda não existe. Também não use variáveis de bônus sem ter um bônus configurado na campanha.
O editor só mostra as variáveis que fazem sentido para a campanha: as variáveis de pedido, carrinho, bônus e pesquisa aparecem conforme o gatilho, o bônus e a pesquisa configurados (veja a seção "Quando cada grupo de variáveis aparece").
Variáveis por canal de envio
A forma como as variáveis são utilizadas depende do canal de comunicação selecionado na ação da campanha. Além disso, a lista é filtrada por canal: algumas variáveis são exclusivas de um canal.
Nos disparos realizados pelo WhatsApp não oficial, as variáveis são inseridas diretamente no corpo da mensagem utilizando o formato {{nome-da-variável}}.
No editor de mensagem, abaixo do texto, aparece a lista "Utilize os campos dinâmicos abaixo para compor sua mensagem". Basta clicar na variável desejada para inseri-la no texto.
WhatsApp Oficial
Nos disparos realizados pelo WhatsApp Oficial, as mensagens são baseadas em modelos de mensagem (templates) previamente aprovados pela Meta. Nesses modelos, as variáveis utilizam o formato numérico: {{1}}, {{2}}, {{3}}, e assim por diante.
Como funciona
Ao selecionar o modelo na ação da campanha, o sistema exibe um campo para cada variável do modelo (no texto, no título, nos botões e nos cards, quando houver). Em cada campo, clique em Predefinições e escolha o campo dinâmico ou o atributo customizado que vai preencher aquela variável. Também é possível digitar um texto fixo.
Exemplo de mapeamento:
{{1}} → Predefinições → "Nome do cliente" → resultado: primeiro nome do cliente
{{2}} → Predefinições → "Número do pedido" → resultado: número do pedido
{{3}} → Predefinições → "Link de Rastreio do Pedido" → resultado: link de rastreio
Dica: Ao criar o modelo de mensagem na Meta, planeje a ordem das variáveis ({{1}}, {{2}}, etc.) de acordo com os campos dinâmicos que deseja utilizar na campanha.
SMS
Nos disparos por SMS, as variáveis funcionam da mesma forma que no WhatsApp não oficial, utilizando o formato {{nome-da-variável}} inserido diretamente no texto da mensagem.
⚠️ Atenção ao limite de caracteres: As variáveis serão substituídas pelo conteúdo real no momento do envio, o que pode aumentar significativamente o tamanho da mensagem. Lembre-se de que um SMS padrão suporta até 160 caracteres (ou 70 caracteres com caracteres especiais).
Nos disparos por E-mail, as variáveis também seguem o formato {{nome-da-variável}} e podem ser inseridas no corpo e no assunto do e-mail. No e-mail existe ainda a variável Link de cancelar inscrição, exclusiva desse canal.
Chat & Automação
Nos disparos via Chat & Automação (como Nextags e Pagebot), as variáveis disponíveis dependem da integração configurada com a ferramenta de automação.
A Martz envia os dados do cliente e do pedido para a ferramenta, que será responsável por utilizar essas informações no fluxo de automação.
Lista completa de variáveis
Abaixo está a lista de variáveis disponíveis na Martz, com o nome (como aparece nas predefinições e na lista de campos dinâmicos) e o código da variável que é inserido na mensagem.
Variáveis do cliente, da loja e gerais
Disponíveis em todas as campanhas.
Nome do cliente → {{primeiro-nome-cliente}} — Primeiro nome do cliente
Nome completo do cliente → {{nome-cliente}} — Nome completo do cliente
Email do cliente → {{email-do-cliente}}
Cidade do cliente → {{cidade-cliente}}
Estado do cliente → {{estado-cliente}}
Bairro do cliente → {{bairro-cliente}}
Nome do vendedor → {{nome-do-vendedor}} — Vendedor responsável pelo cliente
Email do vendedor → {{email-do-vendedor}}
Nome da loja → {{nome-da-loja}} — Nome da loja configurado na Martz
Site da loja → {{site-da-loja}} — URL do site da loja
Nome da campanha → {{nome-da-campanha}} — Nome da campanha que gerou o disparo
Data e hora atuais → {{data-atual}} — Data e hora do momento do disparo
Data atual → {{dia-atual}} — Data do dia do disparo
Variáveis de fidelidade
Preenchidas para lojas com programa de fidelidade integrado à Martz.
Categoria de Fidelidade → {{fidelidade_tier}}
Pontos de Fidelidade → {{pontos-fidelidade}}
Fidelidade - Pontos do último evento → {{fidelidade_ultimos_pontos}}
Link do webchat
Para lojas com o Webchat publicado, aparece a variável Link do webchat → {{link_webchat}}. Cada cliente recebe o próprio link para conversar com a loja.
Se a ação for enviada por uma integração de terceiros (por exemplo, uma ferramenta de e-mail ou automação), o painel avisa que o link do webchat vai para esse provedor junto com as variáveis da ação.
Variáveis do pedido
Disponíveis em campanhas com gatilho de pedido: Pós-Venda, Status do Pedido, Boas-Vindas, Saudades, Resgate, Recuperação de Pedidos e Aniversário da Primeira Compra.
Identificador do pedido → {{identificador-do-pedido}} — Identificador interno do pedido
Número do pedido → {{numero-pedido}} — Número do pedido visível ao cliente
Total da compra → {{total-da-compra}} — Valor total do pedido
Total em produtos da compra → {{total-produtos-compra}}
Total do frete → {{total-do-frete-pedido}}
Total em descontos → {{total-descontos-pedido}}
Data do pedido → {{data-do-pedido}} — Data em que o pedido foi realizado
Produtos do pedido → {{produtos-do-pedido}} — Lista dos produtos do pedido
Produtos do pedido (um por linha) → {{produtos-do-pedido-linha}}
Endereço de entrega → {{endereco-de-entrega}} — Endereço de entrega do pedido
Nome do frete → {{nome-do-frete}} — Nome ou tipo do frete selecionado
Código de entrega → {{codigo-de-entrega}} — Código de rastreio da encomenda
Link de Rastreio do Pedido → {{link-rastreio-pedido}} — Link para rastreamento da encomenda
Código de pagamento do pedido → {{codigo-pagamento-pedido}} — Código de pagamento (Pix, boleto, etc.)
Link de pagamento do pedido → {{link-pagamento-pedido}} — Link para realizar o pagamento do pedido
Link de troca de pagamento → {{link-troca-pagamento}} — Link para o cliente trocar a forma de pagamento
Caminho de acesso ao link do pedido → {{caminho-acesso-link-pedido}} — Apenas no WhatsApp Oficial: parte variável do link de pagamento, para botões de link dinâmico
⚠️ Variáveis como Código de entrega, Link de Rastreio do Pedido e Nome do frete só devem ser utilizadas em campanhas cujo gatilho garanta que esses dados já existam no momento do disparo (ex.: campanhas de Status do Pedido com status de envio). Verifique também se essas informações estão presentes nos dados dos pedidos enviados à Martz pela sua integração.
Variáveis de bônus
Disponíveis em campanhas com bônus configurado na aba Bônus e em campanhas de Lembrete de Bônus e Recuperação de Bônus.
Código do bônus → {{codigo-bonus}} — Código do cupom gerado para o cliente
Valor do bônus → {{valor-do-bonus}} — Valor do bônus gerado
Mínimo uso bônus → {{minimo-uso-bonus}} — Valor mínimo de compra para utilizar o bônus
Expiração bônus (data) → {{expiracao-bonus-data}} — Data de validade do bônus
Observação: A Martz calcula automaticamente os valores de bônus (incluindo cashback) e preenche as variáveis com os dados corretos no momento do envio.
Variáveis de carrinho abandonado
Disponíveis em campanhas de Carrinho Abandonado.
Link do carrinho abandonado → {{link-carrinho-abandonado}} — Link direto para o checkout do carrinho abandonado
Produtos do carrinho → {{produtos-do-carrinho}} — Lista dos produtos que estavam no carrinho
Produtos do carrinho (um por linha) → {{produtos-do-carrinho-linha}}
Total do carrinho → {{total_carrinho}}
Caminho de acesso ao carrinho → {{caminho-acesso-carrinho}} — Apenas no WhatsApp Oficial: parte variável do link do carrinho, para botões de link dinâmico
Variáveis de pesquisa
Disponíveis em campanhas com pesquisa associada na aba Pesquisa.
Link da Pesquisa → {{link-pesquisa}} — Link para a pesquisa associada à campanha
Variável exclusiva do e-mail
Link de cancelar inscrição → {{link-cancelar-inscrição}} — Link para o cliente deixar de receber e-mails
Atributos customizados
Além das variáveis acima, é possível usar os atributos customizados configurados na loja. Atributos de cliente aparecem em todas as campanhas; atributos de pedido, em campanhas com gatilho de pedido; e atributos de carrinho, em campanhas de carrinho abandonado.
Quando cada grupo de variáveis aparece
As variáveis do cliente, da loja e gerais estão sempre disponíveis. Os demais grupos dependem da configuração da campanha:
Pedido: gatilhos de pedido (Pós-Venda, Status do Pedido, Boas-Vindas, Saudades, Resgate, Recuperação de Pedidos e Aniversário da Primeira Compra).
Carrinho: gatilho de carrinho abandonado.
Bônus: quando a campanha tem bônus configurado, e em Lembrete de Bônus e Recuperação de Bônus.
Pesquisa: quando há uma pesquisa associada à campanha, em qualquer tipo de campanha (inclusive Avaliação).
Como usar as predefinições no WhatsApp Oficial
Ao configurar uma ação com o canal WhatsApp Oficial, o fluxo de uso das variáveis é diferente dos demais canais:
Primeiro, crie o modelo de mensagem (template) com as variáveis numéricas ({{1}}, {{2}}, etc.)
Após a aprovação do modelo pela Meta, selecione o número em Número de WhatsApp para disparo e o modelo em Modelo de mensagem
Em cada campo de variável, clique em Predefinições e escolha o campo dinâmico desejado
Exemplo prático:
Modelo aprovado: "Olá, {{1}}! Seu pedido {{2}} foi enviado. Rastreie em: {{3}}"
Variável 1 → "Nome do cliente"
Variável 2 → "Número do pedido"
Variável 3 → "Link de Rastreio do Pedido"
Dicas de uso
Verifique a disponibilidade da variável: confirme se o dado estará disponível no momento do disparo. Código de entrega ou nome do frete só existem após o envio do pedido, e variáveis de bônus precisam de bônus configurado.
Teste antes de ativar: utilize a opção "enviar mensagem de teste". Os campos dinâmicos não são preenchidos no teste, pois não há um cliente ou pedido associado.
Use as predefinições de texto: a Martz disponibiliza textos base com variáveis já configuradas. Eles são um bom ponto de partida.
Cuidado com SMS: as variáveis aumentam o tamanho da mensagem ao serem preenchidas. Monitore o número de caracteres para evitar custos adicionais com SMS concatenados.