📦 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ável | Descrição |
|---|---|
| order.id | ID interno do pedido na plataforma |
| order.first_name | Primeiro nome do cliente no pedido |
| order.last_name | Sobrenome do cliente no pedido |
| order.external_id | ID do pedido no sistema externo (ex: WooCommerce) |
| order.status | Status atual do pedido (ex: pending, processing, completed) |
| order.total | Valor total do pedido |
| order.email | E-mail informado no pedido |
| order.phone | Telefone informado no pedido |
| order.coupon_code | Código do cupom aplicado no pedido |
| order.tracking_code | Código de rastreio da entrega (restrições aplicam-se) |
| order.payment_method | Método de pagamento utilizado |
| order.shipping_method | Identificador do método de envio |
| order.shipping_method_label | Nome 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ável | Descrição |
|---|---|
| customer.first_name | Primeiro nome do cliente |
| customer.last_name | Sobrenome do cliente |
| customer.name | Nome completo do cliente |
| customer.email | E-mail do cliente |
| customer.phone | Telefone do cliente |
| customer.ltv | Lifetime 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ável | Descrição |
|---|---|
| coupon.code | Código do cupom |
| coupon.coupon_type | Tipo do cupom (ex: standard, giftback) |
| coupon.amount | Valor do cupom formatado em moeda |
| coupon.minimum_amount | Valor mínimo do pedido formatado em moeda |
| coupon.expires_in_days | Quantidade de dias até o vencimento |
| coupon.expires_date | Data 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 }}.