Variáveis de mensagem
Variáveis são marcadores que o plugin substitui por dados reais antes de enviar a mensagem. {{first_name}} vira "Fernando", {{order_total}} vira "R$ 287,50", e por aí vai.
Esse artigo é uma referência completa das variáveis disponíveis, agrupadas por contexto. Toda variável é escrita entre chaves duplas — {{nome_da_variavel}}.
Como usar
Dentro do campo Mensagem, escreva a variável como texto comum:
Olá, {{first_name}}! Seu pedido #{{order_number}} foi confirmado e o total é {{order_total}}.
Quando a mensagem for enviada, vira:
Olá, Fernando! Seu pedido #813 foi confirmado e o total é R$ 287,50.
Variáveis que não existem no contexto ficam vazias — sem mostrar o {{...}}. Por isso é importante usar variáveis compatíveis com o gatilho escolhido (uma variável de pedido não funciona num gatilho de recuperação de senha, por exemplo).
Variáveis de pedido (cliente)
Disponíveis em todos os gatilhos baseados em pedido WooCommerce.
| Variável | O que traz |
|---|---|
{{first_name}} |
Primeiro nome do cliente |
{{last_name}} |
Sobrenome |
{{email}} |
|
{{phone_number}} |
Telefone |
{{address}} |
Endereço completo de cobrança/entrega |
Variáveis de pedido (dados)
| Variável | O que traz |
|---|---|
{{order_number}} |
Número do pedido |
{{order_id}} |
ID interno do post |
{{order_total}} |
Valor total formatado (ex: R$ 287,50) |
{{order_items_subtotal}} |
Subtotal dos produtos formatado |
{{order_items_subtotal_row}} |
Subtotal sem formatação (número puro) |
{{shipping_cost}} |
Frete formatado |
{{shipping_cost_row}} |
Frete sem formatação |
{{discounts_total}} |
Total de descontos formatado |
{{discounts_total_row}} |
Total de descontos sem formatação |
{{shipping_method}} |
Método de envio (rótulo) |
{{delivery_time}} |
Prazo de entrega em dias (se disponível) |
{{delivery_time_label}} |
"Entrega em até X dias úteis" |
{{order_date}} |
Data do pedido (DD/MM/AAAA) |
{{order_time}} |
Hora do pedido (HH:MM) |
{{payment_method}} |
Forma de pagamento (rótulo) |
{{coupon_codes}} |
Cupons usados (separados por vírgula) |
{{coupon_codes_with_amount}} |
Cupons + valor de desconto |
{{order_note_content}} |
Texto da nota pública (só pro gatilho de nota) |
Variáveis de produtos do pedido
Para listar os itens. Várias formatações disponíveis dependendo do que você precisa:
| Variável | Formato |
|---|---|
{{products_list}} |
Lista com marcadores (uma linha por item) |
{{products_list_inline}} |
Lista inline (separada por vírgula/"e") |
{{products_list_with_quantity}} |
Lista com quantidades |
{{products_list_inline_with_quantity}} |
Inline com quantidades |
{{products_list_with_url}} |
Lista com link do produto |
{{products_list_with_notes}} |
Lista com notas de compra |
{{products_list_with_quantity_and_notes}} |
Quantidades + notas |
{{products_list_with_meta}} |
Lista com todos os metadados (variações, customs) |
{{products_list_with_meta_and_quantity}} |
Metadados + quantidades |
Use {{products_list_with_quantity}} por padrão. É a versão que dá mais contexto sem encher a mensagem. Use {{products_list_with_meta}} só quando o cliente comprou variações importantes (tamanho, cor) e isso precisa aparecer.
Variáveis de pagamento
| Variável | O que traz |
|---|---|
{{pix_code}} |
Código Pix Copia e Cola (formatado) |
{{direct_payment_url}} |
Link direto pro boleto (várias gateways) |
{{pay_for_order_url}} |
Link pra pagar o pedido no checkout |
{{order_key}} |
Chave de segurança do pedido |
A variável {{pix_code}} funciona com os principais gateways Pix (Click2pay, Efi/Gerencianet, Mercado Pago e outros). Se seu gateway não está integrado, entre em contato com o suporte.
Coloque o {{pix_code}} em uma mensagem separada dentro de uma sequência. Assim o cliente consegue copiar com um único toque. Veja Sequências de mensagens.
Variáveis de produto (gatilhos de estoque)
Disponíveis nos gatilhos Baixo nível de estoque e Sem estoque.
| Variável | O que traz |
|---|---|
{{product_name}} |
Nome do produto |
{{product_sku}} |
SKU |
{{product_url}} |
Link público do produto |
{{product_id}} |
ID interno |
{{product_edit_url}} |
URL de edição no admin |
{{product_stock}} |
Quantidade em estoque |
Variáveis de rastreio
Pros gatilhos de Código de rastreio (qualquer plugin de rastreio):
| Variável | O que traz |
|---|---|
{{tracking_code}} |
Código de rastreio adicionado |
Pra montar link clicável: https://linkcorreios.com.br/{{tracking_code}}.
Pros gatilhos de Atualização na entrega (Correios Updater):
| Variável | O que traz |
|---|---|
{{correios_updater_message}} |
Status (ex: "Objeto entregue ao destinatário") |
{{correios_updater_place}} |
Local (ex: "Unidade de Distribuição. São Paulo/SP") |
{{correios_updater_date}} |
Data/hora do evento |
{{correios_updater_tracking_code}} |
Código de rastreio |
Variáveis de cupom dinâmico
Geram códigos de desconto na hora:
| Variável | O que faz |
|---|---|
{{rishi_coupon=10%}} |
Cria cupom genérico de 10% |
{{rishi_coupon=50}} |
Cria cupom genérico de R$ 50 fixo |
{{order_rishi_coupon=10%}} |
Cria cupom calculado sobre o total do pedido (10% de R$ 200 = R$ 20 fixo) |
{{order_rishi_coupon=50}} |
Cria cupom de R$ 50 fixo (versão atrelada ao pedido) |
Veja Cupons dinâmicos pra detalhes de uso.
Variáveis de campo customizado
Pra puxar qualquer metadado do pedido (campos extras, integrações):
| Variável | O que faz |
|---|---|
{{custom_meta=NOME_DO_CAMPO}} |
Pega o valor de _NOME_DO_CAMPO do pedido |
Substitua NOME_DO_CAMPO pela chave real do meta. Exemplo: {{custom_meta=cpf}} puxa o CPF se ele estiver salvo como meta _cpf no pedido.
Não sabe o nome da chave? Use o plugin WC Order Metadata Check (gratuito) pra investigar metas existentes em um pedido específico.
Variáveis de relatório (gatilhos administrativos)
Pra mensagens pro lojista nos gatilhos Monday/Friday:
| Variável | O que traz |
|---|---|
{{reports:weekly_report}} |
Resumo de vendas da semana |
{{reports:friday_report}} |
Relatório de fechamento de sexta |
Veja Relatórios automáticos pro lojista.
Variáveis específicas de gatilho
Algumas variáveis só funcionam num gatilho específico:
| Gatilho | Variável | O que traz |
|---|---|---|
| Recuperação de senha | {{reset_password_url}} |
Link pra trocar senha |
| Link de acesso direto (WC Smart Checkout) | {{checkout_direct_login}} |
Link de login passwordless |
| Nota pública adicionada | {{order_note_content}} |
Texto da nota |
Variáveis de afiliado (AffiliateWP)
Disponíveis quando o pedido tem afiliado vinculado:
| Variável | O que traz |
|---|---|
{{affiliate_name}} |
Nome do afiliado |
{{affiliate_id}} |
ID do afiliado |
{{affiliate_phone}} |
Telefone do afiliado |