## Visão geral

O **Engagement & Lead Score** mede o quão engajado está cada **contato** e calcula uma **pontuação de
lead** configurável. Cada interação relevante vira um evento em uma **linha do tempo** (timeline)
ligada ao contato — e essa linha **sobrevive** mesmo que a conversa ou o negócio de origem sejam
excluídos, porque os eventos são guardados de forma independente.

Você define um **catálogo de eventos** (uma espécie de "pixel" de comportamento), organiza os eventos
em **grupos de pontos** e atribui **pesos** a cada um. Eventos reais do produto — mensagens,
negócios, follow-ups, pagamentos, agendamentos, vendas do catálogo, e-mails — são mapeados para esse
catálogo e somam (ou não) pontos conforme o peso. Com isso, sua equipe prioriza os leads mais quentes.

Esse módulo é o **eixo do lead** (o contato), complementar ao módulo de Vendas, que é o **eixo do
ator** (o vendedor). Quando faz sentido, um mesmo evento pode dar **crédito duplo**: pontos de
engajamento para o contato e, se o ator for um vendedor, XP para o vendedor no módulo de Vendas.

## Pré-requisitos

- Módulo **Engagement & Lead Score** habilitado na conta (recurso opcional, ativado por um
  administrador/operador).
- Permissão de **gestão de engajamento** para configurar o catálogo de eventos, grupos e pesos.
- Eventos reais fluindo na plataforma (conversas, mensagens, CRM, pagamentos, agenda, follow-ups,
  catálogo) para alimentar a pontuação.
- Para o crédito duplo de XP do vendedor, o módulo de **Vendas & Gamificação** também precisa estar
  habilitado.

## Passo a passo

1. **Monte o catálogo de eventos.** Cadastre os eventos que você quer acompanhar (cada um com nome,
   grupo, ícone e pontos padrão).
2. **Defina os grupos de pontos.** Agrupe eventos por tema (por exemplo, atendimento, compra,
   marketing).
3. **Ajuste os pesos.** Dê mais pontos aos eventos mais importantes; use **peso 0** para apenas
   registrar (acompanhar) sem pontuar.
4. **Escolha a política de deduplicação** por evento: contar sempre, uma vez por contato, ou com
   intervalo (cooldown).
5. **Acompanhe a timeline.** No painel do contato, veja a linha do tempo de engajamento e o **lead
   score**.
6. **Priorize e segmente.** Ordene listas pelo score e crie segmentos dos leads mais quentes.
7. **(Opcional) Rastreie eventos externos.** Use o rastreador (pixel) com token para registrar eventos
   fora da plataforma.

## Configurações & opções

- **Catálogo de eventos (definições)**: chave, nome, grupo, ícone, pontos padrão e se está ativo.
- **Grupos de pontos**: contadores nomeados que somam pontos por tema.
- **Pesos**: pontuação por evento (incluindo **0** para registrar sem pontuar).
- **Deduplicação**: contar sempre, uma vez por contato, ou com cooldown (intervalo configurável).
- **Lead score**: pontuação geral e por grupo, exibida no contato e usável para ordenar/segmentar.
- **Crédito duplo**: o mesmo evento pode pontuar o contato (engajamento) e o vendedor (XP em Vendas).
- **Rastreador (pixel)**: endpoint público com token para eventos externos.
- **Retenção**: período opcional de retenção dos eventos da timeline (sem decaimento de pontos na v1).

## Casos de uso

- Priorizar a fila de leads pelos contatos com maior score.
- Criar um segmento de "leads quentes" para uma ação de vendas direcionada.
- Acompanhar a jornada de um contato em uma única linha do tempo, mesmo após arquivar conversas.
- Registrar comportamentos fora da plataforma (visita a uma página, abertura de e-mail) via pixel.

## Dicas, limites e boas práticas

- Comece com poucos eventos de alto valor; refine os pesos com o tempo.
- Use peso 0 para experimentar um evento novo antes de decidir quanto ele vale.
- Combine a política de deduplicação certa para evitar inflar o score (ex.: "uma vez por contato"
  para cadastros).
- Lembre-se: na v1 não há decaimento de pontos — o score é cumulativo.

## Solução de problemas

- **O lead score não muda**: confirme que o evento está ativo no catálogo, com peso maior que 0, e
  que os eventos reais estão ocorrendo.
- **Um evento contou demais**: revise a política de deduplicação (talvez precise de "uma vez por
  contato" ou um cooldown).
- **A timeline sumiu após excluir uma conversa**: ela não some — os eventos de engajamento são
  preservados de forma independente da origem.
- **O pixel externo não registra**: verifique o token do rastreador e os limites de requisição.

## Veja também

- [Visão geral de Vendas e Gamificação](/hc/ajuda/articles/sales-gamification-overview-pt-br)
- [Gestão de vendas: carteira, isolamento por vendedor e metas](/hc/ajuda/articles/sales-gamification-gestao-de-vendas-carteira-metas-pt-br)
- [Gamificação, leaderboard, recompensas e comissões](/hc/ajuda/articles/sales-gamification-gamificacao-leaderboard-recompensas-comissoes-pt-br)
- [TELÃO (wallboard) em tempo real](/hc/ajuda/articles/sales-gamification-telao-wallboard-pt-br)