As variáveis (também chamadas de placeholders) são chaves no formato {nome} que você coloca no texto da mensagem. Antes de abrir o WhatsApp, o plugin substitui cada chave pelo dado real do pedido.
Como usar
Coloque a chave exatamente como listada abaixo (sensível a maiúsculas e ao caractere _). Se digitar errado, a chave aparece literal no texto.
Oi, {first_name}! Seu pedido #{order_number} no valor de {order_total} segue aguardando pagamento. Acesse: {payment_url}
Vira:
Oi, Maria! Seu pedido #1234 no valor de R$ 199,90 segue aguardando pagamento. Acesse: https://...
Cliente
| Variável | O que retorna |
|---|---|
{first_name} |
Primeiro nome do cliente. |
{order_number} |
ID do pedido (número exibido pelo WooCommerce). |
{order_total} |
Total do pedido formatado em moeda da loja (ex: R$ 199,90). |
{order_status} |
Status atual do pedido (ex: Aguardando pagamento). |
Produto
| Variável | O que retorna |
|---|---|
{last_product} |
Nome do primeiro item do pedido. |
{last_product_url} |
Link direto para a página do primeiro produto. Como o WhatsApp gera preview de URL, isso resulta em mensagem com imagem do produto. |
{all_products} |
Lista de todos os produtos do pedido, separada por vírgulas. |
Para um pedido de um único produto, {last_product} e {all_products} retornam o mesmo texto. Em pedidos com múltiplos itens, prefira {all_products} se o texto da mensagem fizer sentido com a lista completa, ou {last_product_url} para gerar um preview visual.
Endereço de entrega
| Variável | O que retorna |
|---|---|
{shipping_address1} |
Rua/logradouro. Cai no endereço de cobrança se o de entrega não estiver preenchido. |
{shipping_address2} |
Complemento (apto, bloco, etc). |
{shipping_number} |
Número do endereço. |
{shipping_neighborhood} |
Bairro. |
{shipping_city} |
Cidade. |
{shipping_state} |
UF/estado (ex: SP). |
{shipping_postcode} |
CEP. |
{shipping_country} |
Código do país (ex: BR). |
Pagamento e rastreio
| Variável | O que retorna |
|---|---|
{payment_url} |
Link de pagamento correto para o gateway que o cliente escolheu — boleto do PagSeguro, link do Mercado Pago, Pix do Banco Inter, e por aí. Detalhes em Gateways de pagamento suportados. |
{tracking_code} |
Código(s) de rastreamento do envio. Se o pedido já foi postado e o plugin de envio salvou o código, ele entra automático aqui. Detalhes em Códigos de rastreamento. |
O que acontece se a variável não tem dado
Se o pedido não tem o dado correspondente (cliente sem bairro, pedido sem rastreio), a variável é substituída por string vazia. Não aparece como {shipping_neighborhood} literal — fica em branco.
Cuidado com mensagens que dependem de dado opcional. Por exemplo, Seu pedido vai para {shipping_city}/{shipping_state} pode virar Seu pedido vai para / se o cliente comprou produto digital sem endereço de entrega.
Variáveis customizadas
Devs podem injetar variáveis adicionais ({store_name}, {custom_field}, etc) usando o filtro wc_whatsapp_pending_orders_placeholders. Veja Adicionar variáveis customizadas.
Resumo rápido
{first_name} {last_product} {payment_url}
{order_number} {last_product_url} {tracking_code}
{order_total} {all_products}
{order_status}
{shipping_address1} {shipping_neighborhood} {shipping_postcode}
{shipping_address2} {shipping_city} {shipping_country}
{shipping_number} {shipping_state}