Contatos (CRM)
O cadastro das pessoas que compram e que visitam. Todo comprador da loja online também vira um contato, e o portão pode criar contatos ao registrar quem entrou.
O que é e para que serve
Concentrar quem se relaciona com o parque: dados pessoais, meios de contato, histórico de compras e anotações internas. Serve para atendimento, relacionamento e para localizar rapidamente uma pessoa a partir de CPF, e-mail ou WhatsApp — inclusive dentro do PDV e do check-in.
Quem pode acessar
| Ação | Permissão |
|---|---|
| Ver a lista e o detalhe | contacts.view |
| Criar | contacts.create |
| Editar | contacts.update |
| Arquivar | contacts.delete sensível |
| Exportar a base | contacts.export sensível |
| Criar e editar etiquetas | contacts.manage_tags |
Como acessar
Menu lateral → Contatos. O submenu Etiquetas leva à gestão das etiquetas.
Visão geral da tela
Botões e ações
| Botão / ação | O que faz |
|---|---|
| Novo contato | Abre o formulário de cadastro. |
| Importar | Importação em massa a partir de um arquivo CSV. |
| Colunas | Escolhe quais colunas aparecem na tabela. |
| Filtros | Monta condições combinadas sobre qualquer campo. |
| Listas salvas | Aplica uma combinação salva de colunas, filtros e ordenação. |
| Ações em lote | No celular, uma barra inferior permite agir sobre vários contatos selecionados. |
Busca e filtros
- A busca por texto procura por nome, sobrenome e meios de contato.
- O construtor de filtros combina condições por campo, com operadores como igual a, contém, começa com, está vazio, não está vazio, maior ou igual e menor ou igual.
- As listas salvas de sistema já vêm prontas: Todos, Ativos e Inativos. Listas criadas por você podem ser globais (visíveis a toda a empresa) ou privadas.
Colunas da listagem
As colunas exibidas são configuráveis. As disponíveis cobrem os campos do cadastro: nome, sobrenome, CPF, data de nascimento, e-mail, telefone, WhatsApp, cidade, estado, status e datas de criação e atualização.
Estrutura do cadastro
A tabela completa de campos, obrigatoriedade, formatos e validações está em cadastro de contato. Em resumo, são obrigatórios nome, sobrenome, CPF e data de nascimento.
Recursos do módulo
Etiquetas
Etiquetas coloridas por empresa, criadas em Contatos → Etiquetas. Um contato pode ter várias. Servem para segmentar (por exemplo: “VIP”, “Escola”, “Convênio”) e podem ser usadas nos filtros.
Comentários
Cada contato tem uma linha do tempo de comentários internos. O autor pode editar e excluir os próprios comentários. Não é visível para o cliente.
Importação por CSV
A tela Contatos → Importar recebe um arquivo CSV e cria contatos em lote. Confira a codificação do arquivo e o mapeamento das colunas antes de confirmar.
O formato exato aceito pelo importador (nomes das colunas, separador e tratamento de duplicados) não está descrito em documentação interna. Antes de importar uma base grande, faça um teste com poucas linhas e confirme o resultado.
Avatar
O contato pode ter foto, enviada para um repositório de imagens da plataforma.
Passo a passo: cadastrar um contato
- Abra Contatos e clique em Novo contato.
- Preencha nome e sobrenome. Os dois são obrigatórios.
- Informe o CPF. O sistema valida os dígitos verificadores; CPF inválido bloqueia o salvamento.
- Informe a data de nascimento. Precisa ser uma data no passado. A idade aparece ao lado do rótulo.
- Complete os meios de contato (e-mail, telefone, WhatsApp) e a localização, se tiver.
- Observe o aviso de duplicidade. Se já existir contato com o mesmo CPF, e-mail ou WhatsApp, aparece um alerta amarelo com o nome do contato existente — ele avisa, mas não bloqueia.
- Salve. O contato passa a aparecer na listagem e fica disponível para venda, cortesia e check-in.
Regras de negócio
- CPF é único por empresa. Duas pessoas com o mesmo CPF não coexistem no mesmo tenant.
- Nome, sobrenome, CPF e data de nascimento são obrigatórios.
- Arquivamento em vez de exclusão. O contato sai da listagem, mas o histórico de vendas continua íntegro.
- Auditoria automática. Criação, alteração e arquivamento registram autor e data.
Um CPF de contato arquivado não é encontrado pelas buscas automáticas da loja e do portão. Isso pode gerar erro na hora de vincular a pessoa a um ingresso. Prefira marcar o contato como Inativo quando quiser apenas tirá-lo do fluxo comercial.
Status possíveis
| Status | Efeito |
|---|---|
| Ativo | Aparece normalmente em buscas e seleções. |
| Inativo | Continua no cadastro, sinalizado como fora do relacionamento ativo. |
| Arquivado | Sai da listagem principal; só aparece com o filtro de arquivados. |
Dependências com outros módulos
- Vendas — toda venda aponta para um contato (o comprador).
- Vouchers — o voucher guarda o comprador e, separadamente, o ingressante.
- Loja online — o comprador é localizado por CPF, e-mail ou WhatsApp; se não existir, é criado.
- PDV e Cortesias — a busca de contato é feita por nome, CPF ou telefone.
- Pré-check-in — se o CPF já existe, o contato é reaproveitado e não é editado.
Erros e dúvidas comuns
| Mensagem | Significado | Como resolver |
|---|---|---|
| CPF inválido. | Os dígitos verificadores não conferem | Conferir o número digitado |
| Data de nascimento obrigatória. | Campo em branco | Preencher a data |
| Data de nascimento deve ser no passado. | Data futura ou de hoje | Corrigir a data |
| Email inválido. | Formato incorreto | Usar o formato nome@dominio.com |
| WhatsApp inválido. | Menos de 10 ou mais de 11 dígitos | Informar DDD + número |
| Já existe contato com mesmo CPF, email ou WhatsApp | Aviso de possível duplicata | Abrir o contato existente em vez de criar outro |
Boas práticas
- Antes de criar, busque pelo CPF: o duplicado atrapalha o histórico e a comunicação.
- Use etiquetas em vez de escrever categorias no campo de observações — etiqueta é filtrável.
- Registre negociações e ocorrências de atendimento nos comentários, para o time todo enxergar.
- Prefira Inativo a arquivar, salvo quando o objetivo for remover a pessoa do dia a dia.