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.
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 uma estratégia de bônus configurada na campanha.
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. Abaixo estão as diferenças entre cada 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, ao clicar no campo "Campos dinâmicos", o sistema exibe a lista de variáveis disponíveis para a campanha. Basta clicar na variável desejada para inseri-la no texto.
As variáveis disponíveis dependem do tipo de campanha selecionado. Veja a seção "Variáveis por tipo de campanha" abaixo para mais detalhes.
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 canal WhatsApp Oficial na ação da campanha, o sistema exibe as pré-definições dos campos de variáveis do template. Cada variável numérica (##{{1}}, ##{{2}}, etc.) deve ser mapeada para o campo dinâmico correspondente.
Exemplo de mapeamento:
{{1}} → Pré-definição "Nome do cliente" → resultado: primeiro nome do cliente
{{2}} → Pré-definição "Número do pedido" → resultado: número do pedido
{{3}} → Pré-definição "Link de Rastreio do Pedido" → resultado: link de rastreio
As pré-definições são os campos disponíveis que o sistema oferece para você vincular a cada variável numérica. Esses campos variam de acordo com o tipo de campanha configurado.
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 do e-mail.
As variáveis disponíveis dependem do tipo de campanha, assim como nos demais canais.
Chatbot & Automação
Nos disparos via Chatbot & Automação (Nextags, 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 completa de todas as variáveis disponíveis na Martz, com o nome legível (como aparece nas pré-definições e no seletor de campos dinâmicos) e o código da variável que é inserido na mensagem.
Variáveis do cliente e da loja
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
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 do pedido
Disponíveis em campanhas que envolvem pedidos: Pós-Venda, Status do Pedido, Boas-Vindas, Recuperação de Pedidos (Resgate), 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
Data do pedido → {{data-do-pedido}} — Data em que o pedido foi realizado
Produtos do pedido → {{produtos-do-pedido}} — Lista dos produtos do pedido
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
⚠️ 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 que possuem estratégia de bônus configurada, 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. Só utilize essas variáveis se a campanha tiver uma estratégia de bônus configurada.
Variáveis de carrinho abandonado
Disponíveis em campanhas de Carrinho Abandonado.
Link do carrinho abandonado → {{link-carrinho-abandonado}} — Link completo 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}} — Lista dos produtos que estavam no carrinho, um por linha na mensagem
Caminho de acesso ao carrinho → {{caminho-acesso-carrinho}} — Caminho para o checkout do carrinho abandonado (parte do link que é variável na url do carrinho, sem a parte fixa, para uso em botões de link dinâmico do WhatsApp API Oficial)
Variáveis de pesquisa
Disponíveis em campanhas que possuem pesquisa vinculada.
Link da Pesquisa → {{link-pesquisa}} — Link para a pesquisa vinculada à campanha
Variáveis por tipo de campanha
A tabela abaixo resume quais variáveis estão disponíveis para cada tipo de campanha. As variáveis gerais (cliente, loja, campanha, data) estão disponíveis em todos os tipos.
Pós-Venda e Status do Pedido
Variáveis disponíveis: Gerais + Pedido + Bônus (se configurado)
Boas-Vindas
Variáveis disponíveis: Gerais + Pedido + Bônus (se configurado)
Resgate e Recuperação de Pedidos
Variáveis disponíveis: Gerais + Pedido (incluindo link de pagamento, link de troca de pagamento, código de pagamento)
Carrinho Abandonado
Variáveis disponíveis: Gerais + Carrinho (link do carrinho abandonado, produtos do carrinho) + Bônus (se configurado)
Saudades
Variáveis disponíveis: Gerais + Bônus (se configurado)
Aniversariante do Dia, Aniversariante do Mês e Aniversário da Primeira Compra
Variáveis disponíveis: Gerais + Bônus (se configurado)
A campanha de Aniversário da Primeira Compra também tem acesso às variáveis de Pedido.
Comunicação e Comunicação com Assinantes
Variáveis disponíveis: Gerais + Bônus (se configurado)
Lembrete de Bônus e Recuperação de Bônus
Variáveis disponíveis: Gerais + Bônus
Avaliação
Variáveis disponíveis: Gerais + Pesquisa (link da pesquisa)
Como usar as pré-definiçõ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 template pela Meta, selecione o template na ação da campanha
O sistema exibirá os campos de pré-definições, onde você deve mapear cada variável numérica para o campo dinâmico desejado
Exemplo prático:
Template aprovado: "Olá, {{1}}! Seu pedido {{2}} foi enviado. Rastreie em: {{3}}"
Nas pré-definições da ação, configure:
Variável 1 → Selecione "Nome do cliente" → o sistema preencherá com o primeiro nome do cliente
Variável 2 → Selecione "Número do pedido" → o sistema preencherá com o número do pedido
Variável 3 → Selecione "Link de Rastreio do Pedido" → o sistema preencherá com o link de rastreio
Os campos disponíveis nas pré-definições são os mesmos da lista completa de variáveis descrita acima, e variam de acordo com o tipo de campanha.
Dicas de uso
Verifique a disponibilidade da variável: Antes de usar uma variável, confirme se o dado estará disponível no momento do disparo. Variáveis como código de entrega ou nome do frete só existem após o envio do pedido, e variáveis de bônus precisam da estratégia de bônus configurada.
Teste antes de ativar: Utilize a opção "Enviar mensagem de teste" para visualizar como a mensagem será exibida. Lembre-se de que os campos dinâmicos não serão preenchidos no teste, pois no teste não tem um cliente/pedido atrelado de onde obter os dados.
Use as predefinições de texto: A Martz disponibiliza textos base (predefinições) com variáveis já configuradas corretamente para cada tipo de campanha. Esses modelos 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.
Atributos customizados: Além das variáveis listadas acima, é possível utilizar campos de atributos customizados configurados na loja para personalizar ainda mais as mensagens.