> For the complete documentation index, see [llms.txt](https://ajuda.digitalsac.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.digitalsac.io/digicrm/operacao-uso-do-sistema/contatos.md). # Contatos A tela **Contatos** centraliza o cadastro de pessoas e empresas atendidas: criar, editar, filtrar, importar/exportar e iniciar atendimento por canal. **Caminho:** menu lateral → **Contatos** Também pode ser aberta de dentro do **Atendimento** (modo contatos do chat). \[\[FOTO]] *** ### Três visões: Dashboard, Lista e Notas No topo da tela há um seletor com três visões: | Visão | O que mostra | | ------------- | ---------------------------------------------------------------------------- | | **Dashboard** | Painel analítico da base de contatos (números, faixas de recência, gráficos) | | **Lista** | Tabela de contatos com busca, filtros e ações rápidas | | **Notas** | Página de notas registradas nos contatos | Os **filtros são compartilhados** entre Dashboard e Lista: aplicar um filtro em um lugar reflete no outro. \[\[FOTO]] #### Dashboard O Dashboard traz uma leitura rápida da saúde da base: * **Total da base** e **novos contatos no período** selecionado * **Faixas de recência** (tempo desde a última mensagem do cliente): **até 30, 60, 90, 180, 360 e mais de 360 dias**, além de uma faixa **"nunca interagiu"** * Gráfico de **canais de entrada** (de onde vieram os contatos) * Gráfico de **etiquetas** mais usadas * Gráfico de **estados**, calculado a partir do **DDD do telefone** * Gráfico de **consentimento de marketing** (opt-in / opt-out / desconhecido) * **Tabela por carteira**, com a distribuição dos contatos entre os atendentes/carteiras **Faixas de recência clicáveis:** clicar em uma faixa (30/60/90/180/360/+360 dias) aplica o filtro de recência correspondente e leva direto para a **Lista** já filtrada. A faixa **"nunca interagiu"** é apenas informativa — não é clicável, pois não há um recorte de lista equivalente só para esses contatos. **Exportar filtrados:** o botão **Exportar filtrados** gera um arquivo com exatamente o conjunto de contatos filtrado no momento (no Dashboard ou na Lista), incluindo nas colunas a **última interação**, as **etiquetas** e o **consentimento de marketing**, além dos demais dados cadastrais do contato. **Caso de uso:** "quero os clientes que não falam comigo há mais de 60 dias" → clique na faixa de recência **60 dias** (ou ajuste o filtro **Sem interação há**), confira o resultado no painel/lista e use **Exportar filtrados** para baixar a relação. \[\[FOTO]] *** ### O que você vê na tela * Título **Contatos** e chip de **limite do plano** (ex.: X de Y contatos, ou ilimitado) * Botões de ação no cabeçalho * Filtros (busca, carteira, notas, etiquetas, canal, país/estado) * Atalho alfabético (A–Z) * Lista em modo **tabela** ou visão de **notas** \[\[FOTO]] #### Ações do cabeçalho | Ação | Quem usa | Função | | ---------------------- | ------------- | -------------------------------------------------- | | Adicionar | Todos | Abre o modal de novo contato | | Importar | Todos | Importação CSV clássica | | Importação Inteligente | Todos | CSV/XLS/XLSX com mapeamento e análise de conflitos | | Exportar | Admin / Super | Baixa a base de contatos | | Deletar duplicados | Admin / Super | Remove registros duplicados | | Alternar visão | Todos | Troca entre Dashboard, Lista e Notas | *** ### Filtros e busca | Filtro | Descrição | | -------------------------- | -------------------------------------------------------------------------------------- | | Pesquisar Nome ou Telefone | Busca textual | | Carteira | Filtra por carteira do atendente | | Nota por palavra | Busca no conteúdo das notas | | Etiquetas | Uma ou mais tags | | Canal | WhatsApp, Instagram, Telegram, etc. | | País / Estado / Região | Filtros geográficos (quando houver dados) | | Sem interação há | Contatos sem mensagem **do cliente** há 30/60/90/180/360 dias ou período personalizado | | Letras A–Z | Atalho por inicial do nome | \[\[FOTO]] *** ### Lista de contatos Cada contato pode mostrar: * Nome (e selo de **Business verificado**, se houver) * Número / Instagram / Telegram * Status **Validado** / inválido para WhatsApp (ou WABA) * E-mail * Carteiras e etiquetas * **Última interação**: data da última mensagem enviada **pelo cliente**, em tempo relativo (ex.: "há 2 meses") com tooltip mostrando a data completa * Ações rápidas por canal para **iniciar atendimento** * Botão **Ver ficha completa** (disponível nas duas visões da lista) Um **toggle de ordenação** permite listar primeiro os contatos com interação mais recente. \[\[FOTO]] #### Iniciar atendimento a partir do contato 1. Clique no ícone do canal desejado (WhatsApp, WABA, Instagram, Facebook, Telegram, etc.). 2. Selecione o **canal/conexão** e a **fila** (quando pedido). 3. Confirme. 4. Se já existir atendimento em curso, o sistema pergunta se deseja abrir o ticket existente. *** ### Ficha completa do contato (360º) A **ficha completa** reúne tudo sobre o contato em uma única página: dados, histórico, arquivos e resumos de IA. **Como abrir:** * Botão **Ver ficha completa** na lista de Contatos (nas duas visões); * Atalho no **painel do contato** dentro do Atendimento. \[\[FOTO]] #### Cabeçalho * Foto do contato e **canais** vinculados * **Cliente desde** (data de cadastro) * KPIs: **tickets totais**, **tickets abertos** e **última interação** * Etiquetas do contato #### Aba Visão Geral * Dados cadastrais do contato * **Endereço** estruturado (ver seção abaixo) * Etiquetas, carteira e **consentimento de marketing** * Posição no **kanban** e **notas** do contato A edição dos dados continua sendo feita pelo **modal de sempre** (botão Editar). \[\[FOTO]] #### Aba Timeline Histórico unificado do contato, com **rolagem infinita**: | Evento | O que mostra | | ------------- | ---------------------------------------- | | Tickets | Abertura e resolução de atendimentos | | Notas | Notas registradas no contato | | Campanhas | Campanhas recebidas pelo contato | | Consentimento | Eventos de opt-in / opt-out de marketing | | Agendamentos | Agendamentos vinculados ao contato | Eventos de **ticket** na Timeline são clicáveis: ao clicar, a **conversa completa abre em uma janela**, sem sair da ficha — a mesma experiência usada para revisar conversas nos **relatórios**. \[\[FOTO]] #### Aba Conversas Lista todos os **atendimentos** já feitos com o contato, com: * **Status** do ticket * **Fila** * **Atendente** * **Datas** de criação e atualização * Botão **Ver conversa**, que abre a conversa completa em uma janela (mesma experiência da Timeline e dos relatórios) \[\[FOTO]] #### Aba Arquivos Todas as mídias trocadas com o contato, organizadas por tipo: **imagens, vídeos, áudios e documentos**. \[\[FOTO]] #### Aba Resumos IA * Lista os **resumos por atendimento** já gerados * Botão **Gerar resumo consolidado**: cria um resumo geral do contato usando a **IA configurada do tenant** Regras do resumo consolidado: * Limite de **1 geração a cada 10 minutos** por contato * Requer que já existam **resumos de ticket** do contato \[\[FOTO]] #### Permissões Quem **não está na carteira** do contato recebe um aviso de **sem permissão** ao tentar abrir a ficha. Os perfis **admin** e **super** são isentos dessa restrição. *** ### Endereço do contato O contato agora possui endereço com **campos estruturados**, editados na própria ficha completa: | Campo | Observação | | ----------- | ------------------------------------------- | | CEP | Com **preenchimento automático** via ViaCEP | | Estado | Preenchido pela busca do CEP | | Cidade | Preenchida pela busca do CEP | | Bairro | Preenchido pela busca do CEP | | Logradouro | Preenchido pela busca do CEP | | Número | Manual | | Complemento | Manual | Digite o CEP e os demais campos são buscados automaticamente; ajuste o que for necessário e informe número/complemento. \[\[FOTO]] *** ### Última interação e reengajamento A lista de Contatos mostra a **data da última mensagem do cliente** (não conta mensagens enviadas pela empresa). Combine com: * **Toggle de ordenação** pelos mais recentes; * Filtro **Sem interação há**: 30, 60, 90, 180, 360 dias ou período **personalizado**. O mesmo filtro **Sem interação há** está disponível nos modais **Adicionar Contatos** das campanhas (WhatsApp normal e WABA). **Caso de uso — campanha de reengajamento/recall:** uma clínica pode filtrar pacientes sem interação há 6 meses e montar uma campanha chamando-os de volta. O filtro respeita a coluna de **consentimento de marketing** já existente — contatos com opt-out continuam de fora. \[\[FOTO]] *** ### Campos personalizados do contato **Caminho:** menu lateral → **Configurações** → **Campos do contato** O administrador pode cadastrar **campos personalizados** que passam a aparecer na **ficha** e no **cadastro/edição** do contato, com o controle de entrada adequado a cada tipo. | Atributo | Descrição | | ----------- | ---------------------------------------------------------------------- | | Nome | Rótulo exibido para o campo | | Tipo | Texto, número, data, seleção (com opções), sim/não ou link | | Opções | Lista de valores, apenas para o tipo seleção | | Obrigatório | Exige preenchimento ao salvar o contato | | Ordem | Posição de exibição entre os campos | | Ativo | Campo habilitado ou desativado (sem excluir o histórico já preenchido) | Depois de cadastrado, o campo aparece automaticamente: * Na **ficha do contato** (aba Visão Geral), com o valor preenchido; * No **modal de cadastro/edição** do contato, com o controle certo para o tipo (campo de texto, número, seletor de data, combo de opções, toggle sim/não ou campo de link). **Notas e campos personalizados são coisas separadas.** As anotações livres continuam no **bloco de notas** do contato (ver Notas); os campos personalizados são estruturados, definidos pelo administrador e usados para dados padronizados (ex.: plano contratado, indicação, segmento). O que existia antes deste recurso permanece como **nota**, sem migração automática para campo. \[\[FOTO]] *** ### Adicionar ou editar contato Clique em **Adicionar** ou no ícone **Editar** do contato. O modal tem três abas: #### Geral * Foto / avatar * Nome, número (DDI + DDD + celular), e-mail * Carteira e etiquetas * Informações adicionais (pares descrição/informação) * Verificação de número WhatsApp (marcar como validado) * Atualizar nome/dados pelo WhatsApp (quando disponível) #### Pessoa / Empresa * Primeiro e último nome, nome da empresa * CPF/CNPJ (com busca de dados do CNPJ, quando aplicável) * Data de nascimento, gênero, estado civil, origem * Website, categoria #### Organização * Dados organizacionais vinculados ao contato (quando usados no tenant) Também é possível gerenciar **notas do contato** no fluxo de edição / modal de notas. \[\[FOTO]] *** ### Importar contatos #### Importação clássica (CSV) 1. Clique em **Importar**. 2. (Opcional) Baixe o **modelo** de planilha. 3. Envie o CSV com colunas de Nome e Número (e demais campos mapeados). 4. Configure verificação WhatsApp / marcar como validado, se desejado. 5. Confirme. A página atualiza ao finalizar. #### Importação Inteligente Fluxo em etapas: **Arquivo → Mapeamento → Análise → Resultado**. * Aceita **CSV, XLS ou XLSX** * Mapeia colunas da planilha para campos do contato (telefone obrigatório) * Analisa inconsistências/conflitos antes de importar \[\[FOTO]] *** ### Exportar e limpeza * **Exportar** (admin/super): gera arquivo da base conforme filtros/contexto. * **Deletar duplicados** (admin/super): remove duplicidades — ação irreversível. *** ### Excluir contato A exclusão é **permanente**: apaga o contato e o histórico vinculado (tickets e mensagens), sem recuperação. Confirme apenas se tiver certeza. \[\[FOTO]] *** ### Regras importantes * O plano pode limitar a quantidade de contatos. * Número deve seguir o padrão com DDI e DDD (ex.: celular BR com 9 dígitos após DDD). * Contato duplicado (mesmo identificador) não é criado de novo. * Contatos validados no WhatsApp entram melhor em campanhas. * Em alguns perfis, dados sensíveis podem aparecer mascarados (**Dados ocultos**). * Importação com verificação WhatsApp pode demorar. *** ### Mensagens e erros comuns | Situação | Mensagem / comportamento | | ---------------------- | -------------------------------------------- | | Contato criado/editado | Contato criado! / Contato editado! | | Duplicado | Este contato já está cadastrado! | | Número inválido | Número Invalido | | Importação ok | Contatos importados com sucesso! | | Exportação ok | Contatos exportados com sucesso! | | Exclusão | Contato deletado! / Não foi possível deletar | | Ticket em curso | Oferece abrir o atendimento existente | | Limite do plano | Chip/tooltip com uso atual vs máximo | | Falha ao carregar | Erro ao carregar Contatos | *** ### Dicas de uso * Use **etiquetas** e **carteira** para organizar a base antes das campanhas. * Prefira a **Importação Inteligente** em planilhas complexas. * Marque números como **validados** só quando tiver certeza (evita problemas em campanhas). * Inicie o atendimento pelo ícone do canal correto no card do contato. * Abra a **ficha completa** antes de atender um cliente antigo: a Timeline, a aba Conversas e os Resumos IA dão o contexto do histórico em segundos. * Use o filtro **Sem interação há** (ou as faixas de recência do **Dashboard**) para montar campanhas de reengajamento periódicas (ex.: clientes sumidos há 90 dias). * Cadastre **campos personalizados** para os dados que sua operação sempre precisa consultar, em vez de espalhá-los nas notas.