# Clientes e CRM

> Documentação para vendedores da Unefesta.
> Versão HTML: https://www.unefesta.com.br/documentacao-vendedor/gerais/clientes-e-crm

Este guia explica, em linguagem de tutorial, como usar a agenda **Contatos da loja** — o CRM da Unefesta — para organizar clientes e leads, acompanhar o funil de vendas, registrar interações e (com WhatsApp Business conectado) enviar modelos e campanhas.

> No menu do painel, o atalho aparece como **Clientes - CRM**. Na tela, o título é **Contatos da loja**.

Para conectar o WhatsApp Business (Meta), custos e coexistência com o app no celular, veja [WhatsApp Business (Meta) — guia do vendedor](../integracao/whatsapp-business-meta.md).

---

## O que é e para que serve

Cada **loja** tem a própria agenda de contatos. É independente do perfil global do comprador na Unefesta: serve para **você** gerenciar relacionamento, funil e follow-up.

Com a agenda você pode:

- Cadastrar, importar e organizar contatos
- Ver quem já comprou, quem veio do WhatsApp e quem ainda está em prospecção
- Trabalhar em visão **Lista** ou **Funil** (kanban)
- Registrar notas, ligações e outras interações na linha do tempo
- Criar **listas** (automáticas por compra ou manuais) e disparar **campanhas** de modelos WhatsApp
- Acompanhar **métricas do funil** e tempo médio de primeira resposta

---

## Como acessar

1. No painel do vendedor, abra **Clientes - CRM** no menu.
2. Se você tem mais de uma loja, escolha a loja no seletor superior.
3. Use **Atualizar** quando quiser recarregar a lista e as métricas.

Atalhos úteis na mesma área:

| Ação | O que faz |
|------|-----------|
| **Novo contato** | Cadastro manual |
| **Importar planilha** | Importação em massa (CSV / planilha) |
| **Modelos WhatsApp** | Criar e acompanhar modelos na Meta |
| **Campanha marketing** | Disparo em massa (só com WhatsApp conectado) |
| **Configurar funil** | Editar etapas do kanban (no modo **Funil**) |
| **Modelo CSV** | Baixar o arquivo-modelo de importação |

---

## Lista ou Funil: duas formas de ver os mesmos contatos

No topo da página você alterna entre:

| Visão | Quando usar |
|-------|-------------|
| **Lista** | Buscar, filtrar, selecionar vários contatos, abrir o painel de detalhes |
| **Funil** | Arrastar cartões entre etapas do pipeline e ver o volume por coluna |

Na **Lista**, com contatos marcados, use **Mover para etapa…** + **Mover etapa** para corrigir vários de uma vez (útil se o funil inicial atribuiu a etapa errada). No **Funil**, continue movendo um a um pelo arraste.

Clicar em um cartão no funil abre o detalhe do contato (volta para a visão lista com o painel lateral).

---

## Como os contatos entram na agenda

### Cadastro manual

1. Clique em **Novo contato**.
2. Preencha pelo menos o **nome** e o **telefone** (com DDD).
3. Opcional: e-mail, CPF, endereço, tags e notas.
4. Salve — ou use **Criar contato e enviar convite** se quiser convidar a pessoa a criar conta na Unefesta (precisa de e-mail).

O contato nasce como **Em prospecção** e entra na etapa padrão do funil (em geral **Novos**).

### Importação por planilha

1. Clique em **Importar planilha** (ou baixe antes o **Modelo CSV**).
2. Siga os passos da tela (prévia → confirmação).
3. Contatos importados entram com status **Importado**.

Também é possível importar a partir da integração **Elo7**, quando disponível na etapa de importação.

### Compra / checkout na Unefesta

Quando alguém finaliza um pedido na sua loja, a Unefesta associa (ou cria) o contato com origem **Checkout / pedido** e status **Cliente ativo**, vinculando a conta do comprador quando existir.

### WhatsApp Business (com integração)

Com o número conectado em **Integrações das Lojas**:

- Contatos da agenda do WhatsApp Business podem ser sincronizados (conforme a **política de sincronização** escolhida).
- Quem escreve no seu WhatsApp pode aparecer como lead e gerar/atualizar contato com origem **WhatsApp**.
- A política **Sincronizar tudo** traz mais conversas e agenda; **Só contatos e pedidos Unefesta** restringe o que é guardado. Detalhes: [guia WhatsApp Business](../integracao/whatsapp-business-meta.md).

### Sem WhatsApp conectado

Você ainda usa a agenda normalmente: cadastro manual, importação, funil, listas, notas, pedidos e **Nova venda**. O que falta sem a integração é: modelos, campanhas de marketing WhatsApp, coluna de opt-in, limite Meta e auto-respostas de boas-vindas/ausência pela Unefesta.

---

## Status e funil: dois eixos diferentes

É importante não misturar os dois conceitos.

### Status (classificação do relacionamento)

Aparece como badge na lista e no detalhe. Filtro: **Todos os status**.

| Status | Significado prático |
|--------|---------------------|
| **Importado** | Veio de planilha ou da sincronização WhatsApp; ainda não “aquecceu” na conversa |
| **Em prospecção** | Cadastro manual ou lead inicial |
| **Em conversa** | Já houve interação relevante (por exemplo mensagem recebida no WhatsApp) |
| **Cliente ativo** | Conta Unefesta vinculada / compra — badge **Conta vinculada** |
| **Arquivado** | Fora de campanhas de marketing |

O status **evolui sozinho** em alguns casos (por exemplo, de importado/prospecção para **Em conversa** quando o cliente manda mensagem). **Mover o cartão no funil não altera o status** — só a etapa do funil.

### Funil (etapas comerciais)

São as colunas do modo **Funil**. Cada contato fica em **uma etapa**.

Ao criar a loja, a Unefesta já cria etapas padrão, por exemplo:

1. **Novos** (padrão para novos contatos)
2. **Em conversa**
3. **Qualificado**
4. **Cliente** (marcada como **Fechado (ganho)**)
5. **Perdido**
6. **Arquivado**

Você pode **renomear**, **reordenar** (setas para cima/baixo), mudar se a etapa é **Em aberto**, **Fechado (ganho)** ou **Perdido**, definir a etapa **padrão**, escolher cor e **adicionar etapas** em **Configurar funil**.

- Arrastar no kanban (ou escolher a etapa em **Editar contato**) atualiza o funil e registra na linha do tempo algo como **Etapa do funil**.
- Contatos em etapas “ganho” e “perdido” alimentam as métricas de fechamento (veja abaixo).

---

## Trabalhando um contato (painel de detalhes)

Na visão **Lista**, clique em uma linha. No painel lateral você vê:

| Área | O que fazer |
|------|-------------|
| Badges | Status, etapa do funil, origem, conta vinculada |
| **Nova venda** | Abre o checkout já associado a esse contato |
| **Abrir chat** | Vai para a conversa (quando existir chat vinculado) |
| **Editar** | Nome, telefone, e-mail, CPF, endereço, **etapa do funil**, notas, tags |
| **Convite** | Envia e-mail convidando a criar conta (se ainda não for cliente ativo e houver e-mail) |
| Abas | **Timeline**, **Pedidos**, **Campanhas**, **Notas** |

### Timeline

Linha do tempo unificada: interações manuais, mudanças de etapa, mensagens/chats, pedidos e envios de marketing.

Você pode **registrar** manualmente: Nota, Ligação, E-mail, Reunião ou Outro (com data opcional).

Também é possível **adicionar números extras** de telefone no contato, além do principal.

### Tags e filtros

Use tags (separadas por vírgula no cadastro) para segmentar. Na lista, filtre por **status**, **origem**, **tag**, **etapa do funil** e busque por nome, telefone ou e-mail. Marcar uma ou mais **listas** também filtra a tabela (união dos membros) e serve de audiência para campanhas.

### Origens (como o contato foi criado)

| Origem na tela | Situação típica |
|----------------|-----------------|
| **Cadastro manual** | Você criou pelo botão **Novo contato** |
| **Importação CSV** | Planilha / Elo7 |
| **WhatsApp** | Sync ou conversa WhatsApp |
| **Checkout / pedido** | Compra na Unefesta |

---

## Listas de contatos

A seção **Listas de contatos** fica acima da tabela/funil.

### Listas automáticas

Criadas pela loja com base em **pedidos pagos**:

- Comprou nos últimos 30 dias
- Comprou nos últimos 3 meses
- Comprou nos últimos 6 meses
- Comprou no mesmo mês do ano passado

Use **Atualizar** nas listas para recalcular os membros.

### Listas manuais

1. **Nova lista** → nome (e descrição, se quiser).
2. Na tabela, marque contatos e use **Adicionar à lista…** (ou **Mover para etapa…** para mudar o funil em massa).
3. Na engrenagem da lista, **Gerenciar lista** para remover membros.

Listas manuais servem bem para campanhas pontuais (ex.: “Orçamento festa junina”).

### Filtrar pela lista

Marque o checkbox da lista para **filtrar** os contatos exibidos. Dá para marcar várias (mostra a união), desmarcar, ou usar **Limpar seleção de listas** / **Limpar filtros**. A mesma seleção alimenta a **Campanha marketing**.

---

## WhatsApp: modelos, opt-in e campanhas

Requer integração **WhatsApp Business (Meta)** conectada e conta pronta para enviar (pagamento na Meta ok). Veja o [guia completo](../integracao/whatsapp-business-meta.md).

### Modelos

Em **Modelos WhatsApp**, crie modelos e aguarde **aprovação da Meta**. Só modelos **aprovados** aparecem para envio.

No detalhe do contato: **Enviar modelo WhatsApp** (envio unitário).

### Autorização de marketing (opt-in)

Modelos de **marketing** exigem que o contato tenha autorizado promoções.

- No **envio unitário**, se ainda não houver autorização, a Unefesta pode enviar um pedido com botões **Sim** / **Não** no WhatsApp.
- Em **campanha em massa**, quem ainda **não** autorizou é **ignorado** na prévia (a campanha não dispara o pedido de opt-in para todo mundo de uma vez).

Na lista (com WhatsApp conectado) aparece a coluna **Opt-in marketing**.

### Campanha marketing

1. Marque **listas** e/ou **contatos** na página.
2. Clique em **Campanha marketing**.
3. Escolha um modelo de marketing aprovado.
4. **Pré-visualizar** — veja elegíveis e motivos de quem será ignorado.
5. **Disparar campanha**.

Motivos comuns de exclusão na prévia:

- Contato arquivado
- Sem telefone
- Marketing não autorizado / recusado / aguardando Sim ou Não
- Sem interação recente no WhatsApp (em geral **30 dias** desde a última mensagem do cliente)
- Marketing enviado há pouco tempo (em geral **7 dias**)
- Já houve marketing sem nova interação ou compra depois
- Limite de envios da Meta nas **últimas 24 horas**