Fidelidade - Configuração do Programa

O que é

A página de Configuração do Programa é o ponto central onde você define como o programa de fidelidade vai funcionar para os seus clientes. Em um único formulário, divido em quatro cartões, você ajusta a identidade do programa (nome e moeda), a política de expiração de pontos, a ativação do sistema de níveis (tiers) e a ativação do programa de indicações.

O usuário costuma chegar aqui logo após ativar o módulo de fidelidade, para personalizar como o programa será apresentado aos clientes, ou sempre que precisar pausar, retomar ou ajustar uma regra geral. As configurações específicas de pontuação por compra ficam em Regras de Acúmulo e os níveis em Níveis do Programa - esta página só cuida das regras gerais.

Como usar

1. Vá em Fidelidade > Configuração do Programa no sidebar (URL /admin/fidelidade/configuracao).
2. No cartão Dados do Programa, preencha:
   • Nome do Programa - nome que aparece para o cliente final (ex.: "Clube Viajante", "Pontos Premium").
   • Status do Programa - escolha Ativo para o programa rodar normalmente ou Pausado para suspender o acúmulo (os pontos existentes continuam preservados).
   • Nome da Moeda (Plural) e Nome da Moeda (Singular) - como os pontos serão chamados na interface (ex.: "milhas" / "milha", "estrelas" / "estrela").
3. No cartão Expiração de Pontos, configure:
   • Dias para Expirar - quantidade de dias até os pontos vencerem. Deixe vazio para que os pontos nunca expirem.
   • Tipo de Expiração (só aparece quando o campo acima é preenchido):
     • Rolling (a partir da data de cada transação) - cada lote de pontos vence individualmente.
     • Fixo (todos expiram na mesma data) - todos os pontos do cliente expiram juntos.
4. No cartão Níveis (Tiers), ative o toggle Habilitar sistema de níveis se quiser que os clientes evoluam por faixas (Bronze, Prata, Ouro etc.). Ao ativar, escolha o Modo de Rebaixamento:
   • Nunca rebaixa - o cliente mantém o nível alcançado para sempre.
   • Reavaliação anual - o sistema reavalia o nível uma vez por ano.
   • Por inatividade - o cliente cai de nível depois de N dias sem atividade. Informe o número em Dias de Inatividade para Rebaixar (campo que aparece logo abaixo).
5. No cartão Programa de Indicações, ative Habilitar programa de indicações para permitir que clientes indiquem amigos. Ao ativar, preencha:
   • Pontos para Quem Indica - quantidade creditada ao indicador.
   • Pontos para Quem é Indicado - quantidade creditada ao novo cliente.
   • Limite de Indicações por Mês - teto mensal por cliente. Deixe vazio para ilimitado.
   • Validade do Link de Indicação (dias) - por quantos dias o link de indicação fica válido (padrão 30, máximo 365).
6. Clique em Salvar na barra de ações no rodapé do formulário.

Casos especiais

Atalho via Configuração Rápida

No cabeçalho da página, à direita do título, existe o botão roxo Configuração Rápida, que leva ao assistente passo a passo (/admin/fidelidade/setup) - útil para quem está montando o programa pela primeira vez e prefere um fluxo guiado em vez do formulário completo.

Pausar o programa sem perder pontos

Selecionando Pausado em Status do Programa, os clientes deixam de acumular novos pontos, mas o saldo atual e o histórico são mantidos. Basta voltar o status para Ativo para retomar o acúmulo.

Pontos que nunca expiram

Para desativar a expiração, deixe o campo Dias para Expirar em branco. Quando o valor está vazio, o campo Tipo de Expiração some automaticamente e nenhum vencimento é calculado.

Rebaixamento por inatividade

Só quando o Modo de Rebaixamento é Por inatividade é que o campo Dias de Inatividade para Rebaixar aparece. O contador considera o último movimento do cliente; sem movimentos por mais que esse número de dias, o nível cai.

Indicação só credita após check-in

O bloco informativo dentro do cartão de indicações lembra: os pontos de indicação só são creditados quando o cliente indicado faz check-in na primeira viagem. Isso evita que cadastros sem compra gerem pontos.

Erros comuns e como resolver

• "O campo nome é obrigatório." - Causa: o campo Nome do Programa ficou em branco. Solução: preencher com qualquer nome até 100 caracteres.
• "O campo nome da moeda é obrigatório." - Causa: Nome da Moeda (Plural) ou (Singular) vazio. Solução: informar os dois (até 30 caracteres cada).
• "O campo status é obrigatório." / "O status selecionado é inválido." - Causa: valor diferente de ativo ou pausado. Solução: usar o select Status do Programa sem alterar manualmente.
• "O campo dias para expirar deve estar entre 1 e 3650." - Causa: número fora do intervalo permitido (até ~10 anos). Solução: usar valor entre 1 e 3650 ou deixar vazio.
• "O tipo de expiração é obrigatório quando dias para expirar está preenchido." - Causa: definiu prazo mas não escolheu o tipo. Solução: selecionar Rolling ou Fixo em Tipo de Expiração.
• "O modo de rebaixamento é obrigatório." - Causa: nenhum modo selecionado quando os níveis estão habilitados. Solução: escolher Nunca rebaixa, Reavaliação anual ou Por inatividade.
• "A validade do link de indicação deve ser no máximo 365." - Causa: valor acima de 365 em Validade do Link de Indicação (dias). Solução: usar valor entre 1 e 365.

Onde encontrar

• URL: /admin/fidelidade/configuracao
• Caminho no menu: Fidelidade > Configuração do Programa
• Permissão necessária: ver a fidelidade para abrir, editar a fidelidade para salvar
• Módulo necessário: Fidelidade (rota protegida por addon:fidelidade)

Veja também

• Dashboard Fidelidade
• Níveis do Programa
• Regras de Acúmulo
• Recompensas
• Indicações
• Clientes no Programa
• Resgates