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:
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
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
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
Clique no ícone do canal desejado (WhatsApp, WABA, Instagram, Facebook, Telegram, etc.).
Selecione o canal/conexão e a fila (quando pedido).
Confirme.
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:
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:
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.
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)
Clique em Importar.
(Opcional) Baixe o modelo de planilha.
Envie o CSV com colunas de Nome e Número (e demais campos mapeados).
Configure verificação WhatsApp / marcar como validado, se desejado.
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
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.
Atualizado