flows
Variables

📦 Variáveis Disponíveis no Flow Builder

Essa é a lista completa de variáveis disponíveis para Pedido, cliente e cupons.

Esta documentação descreve todas as variáveis que podem ser usadas em mensagens, condições e ações dentro do Flow Builder.

As variáveis disponíveis dependem do contexto de execução do flow (Pedido, Cliente e/ou Cupom).


🧩 Contexto de Pedido (order.*)

Quando um pedido está presente no contexto, todos os nós subsequentes terão acesso às variáveis abaixo.

⚠️ Observação: Se o trigger do flow for Cliente, as variáveis order.* não estarão disponíveis.

Variáveis do Pedido

VariávelDescrição
order.idID interno do pedido na plataforma
order.first_namePrimeiro nome do cliente no pedido
order.last_nameSobrenome do cliente no pedido
order.external_idID do pedido no sistema externo (ex: WooCommerce)
order.statusStatus atual do pedido (ex: pending, processing, completed)
order.totalValor total do pedido
order.emailE-mail informado no pedido
order.phoneTelefone informado no pedido
order.coupon_codeCódigo do cupom aplicado no pedido
order.tracking_codeCódigo de rastreio da entrega (restrições aplicam-se)
order.payment_methodMétodo de pagamento utilizado
order.shipping_methodIdentificador do método de envio
order.shipping_method_labelNome amigável do método de envio

👤 Contexto de Cliente (customer.*)

Quando um cliente está presente no contexto, todos os nós subsequentes podem acessar as variáveis abaixo.

✅ Todo pedido sempre tem um cliente ❌ Flows iniciados por cliente não possuem order.*

Variáveis do Cliente

VariávelDescrição
customer.first_namePrimeiro nome do cliente
customer.last_nameSobrenome do cliente
customer.nameNome completo do cliente
customer.emailE-mail do cliente
customer.phoneTelefone do cliente
customer.ltvLifetime Value do cliente no site atual

🎟️ Contexto de Cupom (coupon.*)

Quando um cupom está presente no contexto, todos os nós subsequentes terão acesso às variáveis abaixo.

Variáveis do Cupom

VariávelDescrição
coupon.codeCódigo do cupom
coupon.coupon_typeTipo do cupom (ex: standard, giftback)
coupon.amountValor do cupom formatado em moeda
coupon.minimum_amountValor mínimo do pedido formatado em moeda
coupon.expires_in_daysQuantidade de dias até o vencimento
coupon.expires_dateData de expiração do cupom (DD/MM/YYYY)

✍️ Exemplo de Uso em Mensagem

Olá {{ customer.first_name }}

Seu pedido #{{ order.external_id }} no valor de {{ order.total }} já foi confirmado.

Use o cupom {{ coupon.code }} e ganhe {{ coupon.amount }} na sua próxima compra.
Válido até {{ coupon.expires_date }}.