Nó Cupom: gerando descontos automáticos
O nó Cupom cria um cupom de desconto único na sua loja WooCommerce e disponibiliza o código na variável {{coupon_code}} pra usar em mensagens subsequentes.
A combinação típica é Cupom → Mensagem: gera o código e já manda pro cliente.
Tipos de cupom
| Tipo | O que faz |
|---|---|
| Padrão (Standard) | Cupom avulso com valor fixo ou percentual e pedido mínimo configurável |
| Giftback | Cupom calculado como % do valor do pedido que disparou o fluxo. Exige gatilho de pedido. Útil pra retornar parte do gasto como crédito |
Configurando
Campos comuns
| Campo | Descrição |
|---|---|
| Tipo de cupom | Padrão ou Giftback |
| Tipo de desconto | % (percentual) ou R$ (valor fixo) |
| Valor do desconto | Número (% ou R$ conforme o tipo escolhido) |
| Gerar código automaticamente | Se ligado, gera código aleatório. Se desligado, você define no campo Código |
| Prefixo do código | Até 11 caracteres maiúsculos (ex: WIN, VIP, BLACK) |
| Validade (dias) | Quantos dias o cupom dura. 0 = sem expiração |
| Limite de usos | Quantas vezes o cupom pode ser usado (padrão: 1) |
| Restringir ao e-mail do cliente | Só o e-mail do cliente do fluxo pode usar o cupom |
| Uso individual | Não pode ser combinado com outros cupons |
| Frete grátis | Concede frete grátis junto com o desconto |
Campos específicos do tipo Padrão
- Pedido mínimo (R$) — valor mínimo pra usar o cupom
Campos específicos do tipo Giftback
- Percentual máximo do próximo pedido — limite de quanto o cupom pode representar do próximo pedido (ex: cupom de R$ 50 com max 10% só funciona em pedidos de R$ 500+)
Geração do código
Automática
Quando Gerar código automaticamente está ligado, o sistema cria:
{PREFIXO}{6_chars_aleatorios}
Exemplos:
WIN3F9KZP
VIPB7N2Q1
BLACKX4M9LR
Se o código gerado já existir na loja WooCommerce, o sistema gera novo código e tenta até 3 vezes.
Fixa
Quando você desliga Gerar código automaticamente, define o código exato no campo Código. O sistema usa esse valor literal — útil pra cupons compartilhados ou nomes memoráveis.
Códigos fixos com limite de 1 uso falham depois do primeiro uso. Se você usa código fixo em fluxo automatizado, configure Limite de usos maior ou retire o limite.
Onde o cupom é criado
O cupom é criado direto no WooCommerce via API REST. Pra isso funcionar:
- O site do fluxo precisa estar com provider WooCommerce.
- As credenciais OAuth (consumer key/secret) precisam estar configuradas no site.
Além disso, o cupom é salvo localmente na tabela coupons do Rishi com referência ao fluxo, à execução e ao cliente — você consegue rastrear exatamente quem recebeu o quê e quando.
Variáveis disponíveis após o nó Cupom
Depois que o nó Cupom roda, as variáveis abaixo ficam disponíveis pros próximos nós:
| Variável | Conteúdo |
|---|---|
{{coupon_code}} |
Código do cupom (ex: WIN3F9KZP) |
{{coupon.code}} |
Mesma coisa que {{coupon_code}} |
{{coupon.amount}} |
Valor do desconto formatado em BRL (ex: R$ 50,00) |
{{coupon.expires_date}} |
Data de expiração no formato dd/mm/YYYY |
Use no nó Mensagem que vem depois:
Olá {{customer.first_name}}!
Aqui vai um cupom de boas-vindas pra sua próxima compra:
🎁 {{coupon_code}}
Desconto de {{coupon.amount}}, válido até {{coupon.expires_date}}.
É só usar no checkout!
Sempre coloque o nó Cupom ANTES do nó Mensagem que usa {{coupon_code}}. Se a ordem estiver invertida, a variável fica vazia.
Exemplo: cupom de boas-vindas
[Início: Pedido pago]
↓
[Aguardar: 7 dias]
↓
[Cupom: 10%, prefixo VOLTA, validade 30 dias, restringe ao e-mail]
↓
[Mensagem: "Olá {{customer.first_name}}, sua próxima compra tem 10% off com {{coupon_code}}. Válido até {{coupon.expires_date}}."]
Exemplo: giftback
[Início: Pedido pago]
↓
[Cupom: Giftback 5%, prefixo CASHBACK, max 20% do próximo pedido]
↓
[Mensagem: "Você ganhou {{coupon.amount}} de cashback! Use {{coupon_code}} na sua próxima compra (até {{coupon.expires_date}})."]
Aqui, se o cliente comprou R$ 200, o cupom vira R$ 10 (5% de 200) e fica válido para pedidos a partir de R$ 50 (10/0.20 = 50).
Multi-site: criar cupom em outro site
Se sua conta tem compartilhamento de audiência ativo entre sites, você pode criar o cupom em um site diferente do site do fluxo. Configure o campo Site destino do cupom no Inspector.
Útil pra cenários como "comprou na loja A, recebe cupom pra loja B".
Modo "copiar de cupom existente"
O modo Copiar de cupom existente te permite usar as configurações de um cupom já criado na loja como template. O sistema busca o cupom pelo código que você informa e replica todas as configurações (valor, validade, restrições, etc.) gerando apenas um código novo.
Útil pra manter consistência quando você cria cupons via fluxo e via admin do WooCommerce. Exige que o site tenha cupons de gift grátis habilitados.
Casos de borda
- Giftback sem pedido no contexto (gatilho que não envolve pedido) → o nó lança exception e para o fluxo. Use Giftback só com gatilhos de pedido (Novo pedido, Pedido pago, etc.).
- Site sem credenciais WooCommerce → exception. Configure as credenciais OAuth do site primeiro.
- Cliente não encontrado no contexto → exception.
- Tipo Padrão sem pedido no contexto → funciona normalmente. Cupom é criado, e o cliente pode usar quando voltar à loja.
Próximos passos
- Nó Mensagem — pra entregar o cupom pelo WhatsApp.
- Nó Tag — marque o cliente que ganhou cupom pra evitar gerar de novo no futuro.