Cada regra de scoring é uma instrução do tipo "quando o evento X acontece, soma N pontos no lead". O Syncro avalia regras automaticamente conforme as ações vão ocorrendo no CRM e atualiza o score do lead em tempo real.
Você pode criar quantas regras quiser e combinar várias categorias (engajamento, pipeline, perfil). O score final do lead é a soma cumulativa de todos os pontos — limitada por um teto global opcional pra evitar leads com pontuação distorcida.
Pré-requisitos
- Permissão de admin.
- Pelo menos 1 funil criado se você quiser filtrar por funil/etapa.
Categorias de regra
Antes de criar, escolha em qual das 3 categorias a regra se encaixa:
- Engajamento — interações com a empresa (mensagens, respostas, mídias enviadas).
- Pipeline — movimentação no funil (avançou de etapa, retrocedeu, fechou venda).
- Perfil — preenchimento de dados (email completo, empresa, tags).
A categoria é só pra organização visual no painel. Não muda o comportamento técnico.
Passo a passo
- Acesse Configurações → Lead Scoring.
- Leia o subtítulo e veja a tabela de regras existentes (se for sua primeira regra, vai estar vazio com a mensagem "Nenhuma regra de scoring configurada.").
- Clique em Nova Regra no canto superior direito.
- O drawer Nova regra abre. Preencha:
- Nome da regra: identificador interno. Ex: Lead respondeu mensagem, Avançou pra Qualificado, Perfil completo.
- Categoria: escolha Engajamento, Pipeline ou Perfil.
- Evento disparador: o que faz a regra disparar. Veja Eventos disponíveis pra lista completa.
- Pontos: número inteiro entre −100 e +100. Use:
- Positivos pra somar (lead "esquentou")
- Negativos pra subtrair (lead "esfriou")
- Cooldown (horas): tempo mínimo entre disparos da mesma regra pro mesmo lead. Default
0= sem limite. Use 24h pra evitar inflar score com 50 mensagens recebidas em 1 dia. - Filtro por funil (opcional): aplica regra só pra leads daquele funil. Vazio = todos.
- Filtro por etapa (opcional): aplica só pra leads naquela etapa específica. Aparece quando você seleciona um funil.
- Válida a partir de (opcional): data de início da regra.
- Válida até (opcional): data de expiração da regra. Útil pra campanhas pontuais.
- Limite por lead (vida toda) (opcional): quantas vezes essa regra pode disparar pro mesmo lead. Vazio = sem limite. Útil pra eventos como Lead criado (faz sentido só 1x).
- Clique em Salvar.
- A regra aparece na tabela com status Ativo ✅.
Exemplos práticos
Lead que responde rápido (engajamento)
| Campo | Valor |
|---|---|
| Nome | Resposta rápida |
| Categoria | Engajamento |
| Evento | Resposta rápida (< 5 min) |
| Pontos | +10 |
| Cooldown | 0 |
Lead que avançou de etapa (pipeline)
| Campo | Valor |
|---|---|
| Nome | Avançou no funil |
| Categoria | Pipeline |
| Evento | Avançou de etapa |
| Pontos | +15 |
| Cooldown | 0 |
Lead inativo há 3 dias (decay)
| Campo | Valor |
|---|---|
| Nome | Lead frio (3 dias) |
| Categoria | Engajamento |
| Evento | Inativo há 3 dias |
| Pontos | −10 |
| Cooldown | 0 |
Veja Decay temporal pra entender o cron diário que processa esses eventos.
Templates por nicho (biblioteca)
Em vez de criar tudo do zero, você pode instalar regras prontas pra seu segmento:
- No topo da página, clique em Templates.
- Aparece uma biblioteca com regras agrupadas por nicho:
- Imobiliária
- Saúde
- E-commerce
- Educação
- Beleza
- B2B Serviços
- Agência de marketing
- SaaS / Tech
- B2C Varejo
- Clique no template desejado pra instalar. A regra é criada com nome e parâmetros pré-definidos.
- Você pode editar depois.
A instalação é idempotente: se uma regra com o mesmo nome já existe, ela não é duplicada.
Editar uma regra
- Na tabela de regras, clique no ícone de edição (lápis).
- O drawer abre com os valores atuais.
- Ajuste e clique em Salvar.
⚠️ Atenção: editar pontos ou condições não recalcula leads passados. A mudança vale só pros próximos disparos. O histórico em
lead_score_logscontinua mostrando os pontos antigos.
Ativar / desativar uma regra
Cada regra tem um toggle Ativo / Inativo na coluna Status da tabela. Desativar pausa os disparos sem perder a configuração — útil pra testar comportamentos com regras turn on/off.
Excluir uma regra
- Na tabela, clique no ícone de lixeira.
- Confirme.
- A regra some. Os logs de pontuação que ela gerou no passado continuam preservados (com
scoring_rule_id=null), mas perdem o link com a regra.
Limites globais (score_min / score_max)
Você pode definir um piso e teto global pra evitar que leads acabem com pontuação extrema (ex: -500 ou +9999):
- Na página de Lead Scoring, clique no ícone de engrenagem (⚙️) no canto.
- Define Score mínimo (default
0) e Score máximo (vazio = sem teto). - Salva.
A partir daí, o Syncro trava o score dentro desses limites quando aplica regras.
💡 Dica: pra a maioria das operações, score_min=0 e score_max=100 funciona bem. Aí você lê o score como uma porcentagem de calor do lead.
Validações no formulário
- Pontos: −100 a +100
- Cooldown: 0 a 720 horas (30 dias)
- Limite por lead: 1 a 1000 (ou vazio)
- Categoria: deve ser engagement / pipeline / profile
- Evento: deve ser um dos tipos suportados (ver Eventos disponíveis)
Permissões
A configuração de regras é restrita a admins do tenant. Managers e viewers veem o score dos leads na lista, mas não podem criar/editar/excluir regras.
Limites de plano
Não há limite de quantidade de regras por plano. Você pode criar 50, 100 regras se quiser. Pra performance, recomendamos manter abaixo de 50 regras ativas por tenant — acima disso o cálculo pode ficar mais lento em tenants com volume grande de eventos.