Cupons
Cupons são códigos para mensagens, jornadas e convites de amigos. Um grupo é uma promoção: um código comum para todos (por exemplo, SUMMER10) ou um código único para cada cliente. O desconto do código é aplicado pela regra de cupons da sua loja, enquanto o OneTrace.ru gera os códigos, entrega-os aos clientes e conta os pedidos feitos com eles.
A seção fica no menu Engajamento → Cupons. Todas as funções podem ver os grupos e os códigos. Criar grupos e emitir códigos é permitido para “Gerente” e superiores.
Grupos
- Abra Cupons e clique em Criar grupo.
- Informe o Nome e a Chave para modelos: é por ela que o grupo é chamado nas mensagens. A chave é definida uma única vez.
- Escolha o Tipo: “Código comum”, e digite o código, ou “Códigos únicos”, e defina o Prefixo dos códigos e o Comprimento da parte aleatória.
- Preencha os demais campos (tabela abaixo) e clique em Salvar.
| Campo | O que significa |
|---|---|
| Desconto (texto para mensagens) | Por exemplo, “−10% no primeiro pedido”. Apenas para textos: o valor do desconto é configurado na loja |
| Início da promoção, último dia da promoção | Fora do período, os códigos não são emitidos e as mensagens com eles não são enviadas. As datas estão no fuso horário do projeto |
| Validade do código, dias | Prazo de um código único a partir da emissão, mas não além do fim da promoção |
| Códigos por cliente | Quantos códigos do grupo um mesmo cliente pode receber |
| Avisar quando restarem menos códigos que | Quando o número de códigos livres ficar abaixo desse valor, os membros com permissão para cupons recebem um e-mail |
No cartão do grupo, você vê quantos códigos estão livres e emitidos, quantos pedidos foram feitos com os códigos e o valor deles. A chave pausa o grupo. O campo de busca no topo encontra um código em todos os grupos e mostra para quem ele foi emitido e em quais pedidos foi usado.

Códigos
Clique no nome do grupo para abrir os códigos dele. Para um grupo de códigos únicos:
- Gerar: códigos com o prefixo do grupo, até 50.000 por vez. Os códigos não têm caracteres parecidos, como 0 e O;
- Enviar os seus: códigos um por linha ou um arquivo CSV ou TXT, até 100.000 por vez. Os códigos que já existem no projeto são ignorados;
- Exportar códigos (CSV): um arquivo com os códigos, os status e as validades, para carregá-los na loja sem plugin.
Mais abaixo ficam os códigos, com filtro por status (“Livre”, “Emitido”, “Usado”), e os últimos pedidos com códigos do grupo.

Emissão em mensagens e jornadas
- No modelo, insira
{{ promo_code('welcome') }}, ondewelcomeé a chave do grupo. No envio, o cliente recebe um código livre ou, se já tiver um código válido desse grupo, o mesmo código. Na pré-visualização e nos envios de teste aparece um exemplo, e nenhum código é gasto. Se não for possível emitir um código (o grupo está pausado, os códigos acabaram ou o cliente já recebeu todos os seus códigos), a mensagem não é enviada. - O nó de jornada Emitir um cupom emite um código e segue pela saída “sem código” se não for possível emiti-lo. As próximas mensagens da jornada recebem o mesmo código.
- O código para o amigo no convite é o campo Cupom de um grupo nas configurações de convites.
Cupons na loja
Para que a loja aceite o código, ele precisa ser um cupom com o desconto desejado. Os plugins OneTrace.ru criam os códigos do grupo como cupons automaticamente, a cada 5 minutos:
- WooCommerce: com base em um cupom modelo da loja (desconto, produtos, valor mínimo): nas configurações do plugin, em “Cupons”, a linha
welcome = CÓDIGO-MODELO; - Magento 2: como cupons de uma regra de carrinho com o tipo “Specific Coupon” e geração automática: a linha
welcome = ID da regra; - 1C-Bitrix: como cupons de uma regra de carrinho: a linha
welcome = ID da regranas configurações do site.
Cada código único vira um cupom de uso único com a validade do código. Crie você mesmo o código comum como cupom na loja. Os plugins enviam os cupons dos pedidos, por isso o código é marcado como usado, e o cancelamento do pedido o libera.
Os códigos únicos estão disponíveis a partir do plano “Crescimento”, dentro da cota do plano, e o grupo com código comum, em qualquer plano (planos).