As variáveis de pedido (order.*) são o conjunto que você mais usa em loja: ID, valor, status, dados do comprador no contexto do pedido, endereço de entrega, código de rastreio, forma de pagamento. Tudo que descreve um pedido específico.
Quando estão disponíveis
Em todos os gatilhos relacionados a pedido:
- Pedido pago (
order_paid) - Pedido novo (
new_order) - Status do pedido alterado (
order_status_changed) - Pedido atualizado (
order_updated) - Pedido avaliado (
order_reviewed)
Em qualquer um desses, você acessa todos os caminhos abaixo no editor de variáveis.
Lista completa
Identificação do pedido
| Caminho | Descrição | Exemplo |
|---|---|---|
order.id |
ID interno do pedido no Rishi | 1842 |
order.external_id |
ID externo (número que aparece pro cliente) | #10231 |
Use order.external_id em mensagens pro cliente quando ele precisar identificar o pedido (na loja, no painel, no atendimento). É o número que ele vê. order.id é interno e raramente faz sentido mostrar.
Dados do comprador
| Caminho | Descrição | Exemplo |
|---|---|---|
order.first_name |
Primeiro nome do comprador | João |
order.last_name |
Sobrenome do comprador | Silva |
order.email |
E-mail do comprador | joao@exemplo.com |
order.phone |
Telefone do comprador | 11999998888 |
Esses dados vêm do pedido (snapshot do que ele preencheu no checkout). Para os dados do cliente com histórico longo (que pode ter atualizado depois), veja Variáveis de cliente.
Valores e status
| Caminho | Descrição | Exemplo |
|---|---|---|
order.total |
Valor total do pedido formatado | R$ 199,90 |
order.status |
Status atual | processing |
order.payment_method |
Método de pagamento | pix |
order.coupon_code |
Cupom usado no pedido | PROMO10 |
Rastreio
| Caminho | Descrição | Exemplo |
|---|---|---|
order.tracking_code |
Código de rastreio | BR123456789 |
Disponível depois que o pedido foi postado e o código foi registrado. Em pedidos sem rastreio (digital, retirada na loja), vem vazio.
Endereço de entrega
| Caminho | Descrição | Exemplo |
|---|---|---|
order.address.city |
Cidade | São Paulo |
order.address.state |
Estado (UF) | SP |
order.address.postcode |
CEP | 01310-100 |
Exemplos práticos
Confirmação de pedido novo
Recebemos seu pedido, {{1}}!
Pedido {{2}}
Total: {{3}}
Em instantes você recebe a confirmação do pagamento.
Mapeamento:
{{1}}→order.first_name{{2}}→order.external_id{{3}}→order.total
Confirmação de pagamento Pix
Pagamento confirmado, {{1}}! ✅
Pedido {{2}} já está sendo separado.
Endereço de entrega:
{{3}} - {{4}}/{{5}}
Mapeamento:
{{1}}→order.first_name{{2}}→order.external_id{{3}}→order.address.city{{4}}→order.address.city{{5}}→order.address.state
Postado com rastreio
Seu pedido {{1}} saiu pra entrega! 🚚
Código de rastreio: {{2}}
Mapeamento:
{{1}}→order.external_id{{2}}→order.tracking_code
Considerações
Valor formatado vs numérico — order.total já vem formatado em BRL (ex: R$ 199,90). Você não precisa adicionar "R$" no template. Se adicionar, vai sair "R$ R$ 199,90".
Status em inglês — order.status vem com o nome técnico do WooCommerce (processing, completed, pending, on-hold). Se você quer mostrar pro cliente, use texto fixo no template ("Pedido em separação") em vez da variável. A variável faz mais sentido em filtros internos ou logs.
Pedidos via webhook externo — se você está disparando via webhook genérico, os campos order.* não estão disponíveis automaticamente. Você precisa montar o payload com os nomes que você definiu na mensagem (ex: order_id, customer_name).
Próximos passos
- Pra ver dados do cliente além do que veio no pedido, veja Variáveis de cliente.
- Pra incluir cupom de desconto na mensagem, veja Variáveis de cupom.
- Pra um overview de qual conjunto de variáveis cada gatilho expõe, veja Quais variáveis usar em cada tipo de gatilho.