Programa de fidelidade
O programa de fidelidade concede pontos aos clientes por pedidos e outras ações. Com os pontos, é possível pagar parte dos próximos pedidos diretamente no checkout da loja. Os níveis aumentam o percentual de acúmulo dos clientes frequentes, e os convites trazem novos clientes: o amigo ganha um presente, e quem convidou ganha pontos pelo primeiro pedido dele.
A seção fica no menu Engajamento → Fidelidade. Todas as funções podem ver o programa e os membros. Alterar configurações, regras e pontos é permitido para “Gerente” e superiores.
Criar o programa
- Abra Fidelidade e clique em Criar programa. O programa é criado pausado.
- Na aba Configurações, confira os campos (tabela abaixo) e clique em Salvar.
- Mude o status do programa para “Ativo”. Os pontos são concedidos pelos pedidos a partir desse momento; pedidos anteriores não contam.
| Campo | O que significa |
|---|---|
| Percentual de acúmulo | Qual percentual do valor do pedido volta em pontos. Os níveis têm seu próprio percentual |
| Valor do ponto | Quanto vale um ponto na moeda do projeto ao pagar |
| Pagamento com pontos, no máximo | Qual parte do pedido pode ser paga com pontos |
| Carência, dias | Os pontos de um pedido ficam disponíveis após o prazo de devolução. Até o fim do prazo, um reembolso do pedido os cancela |
| Validade dos pontos, dias | Quantos dias após a concessão os pontos expiram. Também é possível deixá-los sem validade |
| Adesão | “Automática”: todo cliente se torna membro com o primeiro pedido; “Por solicitação”: só quem aderiu no site ou pela API |
| Evento de compra, propriedade do valor, eventos de reembolso e cancelamento | Por padrão, order_completed com o valor amount, order_refunded e order_cancelled, como os plugins de loja os enviam |
O reembolso de um pedido cancela os pontos dele na mesma proporção; o cancelamento, por inteiro. Os pontos que o cliente resgatou nesse pedido voltam para a conta dele.

Visão geral
A aba Visão geral mostra, para o período escolhido, quantos pontos foram ganhos, resgatados em pedidos, ajustados manualmente, devolvidos e expirados, e quantos membros o programa tem. Passivo de pontos são os pontos disponíveis e pendentes convertidos em dinheiro: é o quanto a loja pode conceder em descontos. Os dias são contados no fuso horário do projeto.

Níveis
O nível depende do valor das compras do cliente dentro da janela (campo Janela dos níveis, dias, por padrão 365), descontados os reembolsos. Cada nível tem seu próprio limite e percentual de acúmulo.
- Na aba Níveis, clique em Adicionar nível.
- Informe o nome, o limite de valor e o percentual de acúmulo. É possível definir até 10 níveis.
- Clique em Salvar.
O nível é recalculado após cada pedido, reembolso e cancelamento e uma vez por dia, quando compras antigas saem da janela. O novo percentual vale a partir do próximo pedido. Os níveis estão disponíveis a partir do plano “Crescimento” (planos).

Regras de acúmulo
As regras concedem pontos por outras ações: cadastro, avaliação, inscrição ou aniversário. Clique em Adicionar regra na aba Regras e defina:
- o evento: qualquer evento do projeto ou “Aniversário” (pelo atributo
birthday, uma vez por ano); - as condições sobre as propriedades do evento, como nos filtros de segmentos;
- a fórmula: “Pontos fixos”, “Percentual do valor” ou “Multiplicador do pedido”, por exemplo “pontos em dobro” nos fins de semana para o evento de compra;
- os limites: “Vezes por membro”, “No máximo a cada N dias”, “Máximo de pontos por vez”;
- o período da promoção: o primeiro e o último dia no fuso horário do projeto.
A chave na linha da regra a pausa. Ao lado, você vê quantos pontos a regra concedeu em 30 dias. As regras estão disponíveis a partir do plano “Crescimento”.

Membros
A aba Membros traz a lista ordenada pelo saldo, do maior para o menor, com busca por e-mail, telefone, ID do usuário ou número do perfil e filtro por nível. Clique em um membro para abrir a conta dele: saldo, pontos pendentes, nível, pontos que vão expirar em breve, amigos convidados e histórico de movimentações.
O Ajuste manual adiciona (número positivo) ou deduz (número negativo) pontos, com motivo obrigatório. O motivo aparece no histórico do membro e no registro de ações. A conta do cliente também aparece no cartão do perfil dele.

Convites de amigos
Cada membro tem seu próprio código de convite e link: uma página da loja com o parâmetro ?ref=. O rastreador guarda o código por 30 dias, e os plugins de loja o enviam no cadastro.
- Na aba Convites, ative Convites ativados e informe a Página da loja para o link.
- No bloco Para o amigo, defina os Pontos ao aderir e, se necessário, o Cupom de um grupo (cupons).
- No bloco Para quem convidou, defina os Pontos pelo primeiro pedido do amigo, o valor mínimo do pedido, o prazo do primeiro pedido e o limite de recompensas por membro.
- Clique em Salvar.
O convite só conta para um cliente novo: sem pedidos e que não seja o próprio membro. O amigo recebe o presente ao aderir ao programa, e os pontos dele já podem ser resgatados no primeiro pedido. Quem convidou recebe os pontos após o prazo de devolução do pedido do amigo; o cancelamento ou o reembolso total desse pedido cancela a recompensa. Nas mensagens, o link e o código são as variáveis loyalty.referral_url e loyalty.referral_code. Os convites estão disponíveis a partir do plano “Crescimento”.

Pontos na loja
Os plugins OneTrace.ru para WooCommerce, Magento 2 e 1C-Bitrix mostram ao cliente logado no site o saldo no carrinho e no checkout. O cliente informa quantos pontos quer resgatar: os pontos ficam reservados por 30 minutos e são confirmados com o número do pedido. Na área do cliente da loja aparecem o saldo, o histórico, o link de convite e os cupons. Uma loja própria se conecta às mesmas operações pela API.
Jornadas e mensagens
- O gatilho Programa de fidelidade inicia uma jornada na adesão, no ganho, no resgate e na expiração de pontos, no aviso de expiração próxima (30, 7 ou 1 dia antes), na mudança de nível e nos convites.
- O nó Conceder pontos dá pontos ao participante da jornada, e o nó Emitir um cupom entrega um código de um grupo.
- Nos modelos, há as variáveis
loyalty.*: saldo, nível, pontos a expirar e a data, link de convite. - Na galeria de modelos de jornada, na categoria “Fidelidade”, há jornadas prontas: “Pontos prestes a expirar”, “Novo nível”, “Pontos de boas-vindas” e “Convide um amigo”.