A segmentação de cupons por lista de e-mails permite restringir o uso de um cupom de desconto apenas para clientes específicos da base da loja.
Com essa funcionalidade, o lojista pode direcionar campanhas promocionais para públicos determinados, como clientes VIP, parceiros, colaboradores ou ações de recuperação de clientes.
O controle é feito por meio do e-mail do cliente, como um identificador para validar se ele está autorizado a utilizar o cupom.
Essa segmentação funciona como uma regra adicional dentro da configuração do cupom e pode ser utilizada em conjunto com outras regras comerciais, como valor mínimo de compra, restrições por produto ou limite de uso.
Ao criar ou editar um cupom de desconto, o lojista pode definir que ele seja válido apenas para uma lista específica de e-mails.
Nesse cenário, o cupom passa a considerar um critério adicional para validação: o cliente que estiver realizando a compra precisa ter um e-mail incluído na lista configurada.
Quando o cliente tenta aplicar o cupom no carrinho ou no checkout, o sistema verifica duas condições principais:
O cupom só é aplicado quando todas as regras configuradas forem satisfeitas. Caso o e-mail do cliente não esteja incluído na lista, o cupom é considerado inválido para aquele usuário, mesmo que as demais condições sejam atendidas.
Essa validação acontece sempre com base no cliente autenticado no momento da compra.
A segmentação por lista de e-mails não substitui as regras já existentes dos cupons. Todas as condições configuradas continuam sendo aplicadas normalmente.
Se um cupom possuir mais de uma regra de segmentação, todas elas devem ser atendidas para que o desconto seja aplicado.
Por exemplo, um cupom pode estar configurado para:
Nesse caso, o cupom só será aplicado quando todas essas condições forem atendidas simultaneamente.
Importante: a verificação da lista de e-mails é realizada considerando o cliente que está logado no momento da compra.
A comparação de e-mails é feita de forma case insensitive, ou seja, diferenças entre letras maiúsculas e minúsculas não interferem na validação.
Clientes que não possuam um e-mail válido associado ao cadastro não poderão utilizar cupons configurados com essa segmentação.
A segmentação por lista de e-mails é configurada durante a criação ou edição de um cupom no painel administrativo.
Dentro da configuração do cupom, o lojista pode incluir uma lista de e-mails que estarão autorizados a utilizar o desconto.
Esses e-mails representam clientes específicos da base da loja. O sistema utiliza o e-mail apenas como identificador para validar se o cliente que está realizando a compra pertence ao público definido para o cupom.
Dependendo da estrutura utilizada na loja, a lista de e-mails pode ser gerenciada diretamente na configuração do cupom ou por meio de segmentos de clientes reutilizáveis.
Quando segmentos reutilizáveis são utilizados, o cupom passa a referenciar um grupo de clientes previamente definido. Esse modelo permite utilizar o mesmo segmento em diferentes campanhas ou funcionalidades da plataforma.
A segmentação de cupons por lista de e-mails deve ser configurada por meio da API v2 da Uappi, permitindo que sistemas externos ou integrações criem cupons direcionados para clientes específicos da base da loja.
Nesse modelo, a lista de e-mails autorizados a utilizar o cupom é enviada no momento da criação ou edição do cupom via API.
Segmentar um cupom por cliente significa definir que apenas determinados clientes, identificados pelo e-mail cadastrado, poderão utilizá-lo.
Na prática:
Se o cliente estiver incluído na lista e todas as demais regras do cupom forem atendidas, o desconto é aplicado normalmente. Caso contrário, o cupom é recusado.
Quando o cliente não está na lista de e-mails permitidos, o checkout exibe uma mensagem informando que o cupom não está disponível para o cadastro utilizado.
Importante: essa verificação funciona como um critério adicional dentro do motor de regras do cupom, sem alterar o funcionamento das demais configurações.
A criação e manutenção de cupons via API v2 utiliza os seguintes endpoints:
A lista de e-mails autorizados é definida dentro do campo segmentacao.clientes.emails.
Os principais campos envolvidos na configuração são:
Quando segmentacao.todosClientes está configurado como false, a validação por lista de e-mails passa a ser obrigatória.
Os e-mails informados precisam corresponder a clientes já cadastrados na base da loja.
Importante: e-mails duplicados são ignorados automaticamente e e-mails que não correspondam a clientes existentes geram erro de validação na API.
Abaixo está um exemplo simplificado de criação de um cupom restrito por lista de e-mails utilizando a API v2:
POST /v2/promotional/coupons
{
“titulo”: “Cupom por e-mail”,
“hash”: “cupomEmail”,
“tipo”: “m”,
“valorMinimoCompra”: 100,
“limitePorCliente”: 1,
“desc”: {
“aplicacao”: “total”,
“tipo”: “s”,
“unidade”: “porcentagem”,
“valor”: 10
},
“segmentacao”: {
“todosClientes”: false,
“clientes”: {
“emails”: [
“cliente1@exemplo.com.br”,
“cliente2@exemplo.com.br”
]
}
},
“ativo”: true
}
Nesse exemplo:
Quando a API recebe a lista de e-mails enviada na segmentação:
O cupom só é criado ou atualizado quando todos os e-mails informados são considerados válidos.
Ao editar um cupom já existente via API, a lista de e-mails enviada substitui completamente a lista anterior.
Isso significa que, para remover ou adicionar e-mails, é necessário enviar novamente a lista completa com os clientes que devem continuar autorizados a utilizar o cupom.
A segmentação por cliente via e-mail é um recurso configurado exclusivamente por API.
No painel administrativo da plataforma não existem campos para cadastrar ou editar essa lista de e-mails diretamente.
Em vez disso, a interface apresenta uma mensagem informando que a funcionalidade está disponível apenas via API e direciona para a documentação técnica da plataforma.
Importante: o painel continua permitindo visualizar as informações gerais do cupom, mas a gestão da lista de e-mails é realizada apenas por integração.
No momento da compra, o sistema verifica automaticamente se o cliente logado pode utilizar o cupom.
Quando o cliente pertence à lista de e-mails configurada e todas as demais regras do cupom são atendidas, o desconto é aplicado normalmente ao pedido.
Caso o cliente não faça parte da lista permitida, o cupom não é aplicado e o checkout exibe uma mensagem informando que o cupom não está disponível para aquele cadastro.
Esse comportamento impede que cupons direcionados sejam utilizados por clientes fora do público definido, mesmo que o código do cupom seja conhecido.
A aplicação do cupom segue o fluxo normal de validação já existente na plataforma.
Quando o cliente aplica o cupom no carrinho, o sistema realiza uma verificação inicial das regras configuradas.
Caso o cliente ainda não esteja autenticado, o cupom pode ser temporariamente aceito no carrinho. Ao avançar para o checkout e realizar o login, o sistema valida novamente se o cliente atende às regras configuradas, incluindo a verificação do e-mail.
Se o cliente não estiver presente na lista de e-mails permitidos, o cupom é removido automaticamente durante o processo de checkout.
Quando o cliente já estiver autenticado antes da aplicação do cupom, essa validação ocorre imediatamente.
A validação da segmentação é feita com base no cliente autenticado no momento da compra e no e-mail associado ao seu cadastro.
Alterações futuras na lista de e-mails de um segmento ou cupom não alteram o histórico de pedidos já realizados com o desconto aplicado.
Caso o cliente altere o e-mail em seu cadastro, o comportamento do cupom dependerá da correspondência entre o novo e-mail e as listas configuradas.
Em cenários em que o checkout permite compra sem login, a validação do cupom pode ocorrer apenas no momento em que o cliente informa seus dados ou realiza a autenticação.
A segmentação por lista de e-mails atua como mais um critério dentro do motor de regras dos cupons, complementando as demais segmentações disponíveis sem alterar o comportamento das regras já existentes.
Acesse nosso Help Center para encontrar mais informações e conteúdos sobre a plataforma Uappi!
EN 
PT_BR 
Leave a Reply