Base de contatos
A tela Base de contatos serve para fatiar a base com filtros, conferir quem pode receber mensagem, importar ou exportar uma lista em CSV e abrir a ficha de cada contato para editar dados e etiquetas.
Endereço no painel: /app/contatos
Como chegar: Pelo menu, ou clicando numa empresa da tela Empresas: a Base de contatos abre já filtrada por aquela empresa.
Pulso da base
Quatro números gerais da conta, que não mudam com os filtros.
- "Total na base": contatos ativos na sua base.
- "Novos hoje": contatos criados no dia.
- "Quentes agora": leads na banda Quente, prontos para abordagem.
- "Aguardando humano": conversas na fila de transbordo, com um ponto verde pulsando.
- Se a leitura falhar, o número vira um travessão em vez de zero.
Listas inteligentes
Atalhos no alto da coluna da esquerda, cada um com a contagem; passe o mouse para ver o recorte exato.
Botões e ações
- Todos os contatos
- Mostra a base inteira e desliga todos os filtros de uma vez.
- Quentes agora
- Filtra os contatos com nota BANT 75 ou mais. Clicar de novo desliga.
- Esperando nossa resposta
- Filtra quem mandou a última mensagem e ficou sem resposta além do prazo de resposta da conta, o mesmo que o Inbox cobra.
- Sem consentimento
- Filtra quem nunca manifestou consentimento. Alguns podem ter base legal declarada; o selo da ficha distingue.
- Reengajar · ‹banda› ‹n›d+
- Filtra os contatos da banda da regra de reengajamento sem interação há N dias ou mais. Banda e dias vêm da regra configurada no CRM & Graph.
- Importados hoje
- Filtra quem entrou por planilha desde a virada do dia. Quem já existia na base não conta.
Filtros por faceta
Grupos de filtros na coluna da esquerda. Cada linha tem a contagem e uma barrinha proporcional; clicar liga, clicar de novo desliga.
Campos e filtros
- Banda BANT
- Quente, Morno, Frio ou Sem score.
- Canal
- Por onde o contato entrou: WhatsApp, Web chat, Instagram, Importados por planilha, Cadastro manual, Integração e outros.
- Status
- Novo, Em conversa, Qualificado, Transferido, Descartado ou Opt-out.
- Empresa
- As empresas com mais contatos, pelo nome oficial do cadastro.
- Etiquetas
- As etiquetas mais usadas na base.
- Em telas estreitas a coluna vira um bloco recolhível chamado "Filtros e listas".
- Os filtros ficam no endereço da página: copiar o link leva a mesma lista para outra pessoa da equipe.
Barra de ferramentas
Temperatura rápida, busca, modo de exibição e as ações da base.
Campos e filtros
- Buscar contato, empresa, telefone…
- Busca livre por nome, empresa ou telefone; a lista atualiza depois de uma pausa curta na digitação.
Botões e ações
- Todos
- Desliga o filtro de temperatura.
- Quente
- Filtra a banda Quente; mostra a contagem ao lado. Clicar de novo desliga.
- Morno
- Filtra a banda Morno.
- Frio
- Filtra a banda Frio.
- Cartão
- Mostra um bloco por contato, com etiquetas e tudo à vista. A escolha fica lembrada neste navegador.
- Tabela
- Mostra uma linha por contato, ordenável por qualquer coluna. A escolha fica lembrada neste navegador.
- Importar CSVDono, Admin
- Abre o diálogo de importação de contatos por planilha.
- Exportar CSVDono, Admin
- Baixa um arquivo CSV com os contatos do recorte atual (filtros e busca aplicados).
- Novo contato
- Abre o diálogo de cadastro manual.
Lista em cartões
O modo Cartão: um bloco por contato, carregado aos poucos enquanto você rola.
Botões e ações
- Abrir ficha de ‹nome›
- Clicar no cartão (ou Enter/Espaço com o foco nele) abre a ficha lateral do contato.
- Faixa colorida à esquerda com a cor da temperatura.
- Nome, empresa e canal de origem; as etiquetas como selos.
- Selo "sem autorização" para quem não tem consentimento nem base legal; "base legal declarada" para quem tem só a base legal.
- Status, há quanto tempo está na base e a nota BANT.
Lista em tabela
O modo Tabela, para varrer e comparar muitas linhas. Clicar no cabeçalho ordena; o segundo clique inverte; o terceiro tira a ordenação.
Campos e filtros
- Contato
- Nome e empresa. Ordena de A a Z. A coluna fica fixa ao rolar a tabela para o lado.
- Nota
- Pontuação BANT de 0 a 100 e a temperatura. Ordena da maior para a menor.
- Alcançável
- Se dá para mandar mensagem: Consentimento, Base legal ou Sem autorização.
- Status
- Onde a conversa parou; ordena pela ordem do funil, não pelo alfabeto.
- Canal
- Por onde o contato entrou na base.
- Cadastrado
- Há quanto tempo o contato está na base; ordena do mais recente para o mais antigo.
- Ao ordenar, a tela carrega o resto da base sozinha e avisa "Carregando a base inteira para ordenar — ‹n› de ‹total›."
- Em base muito grande, avisa que ordenou só os primeiros e sugere estreitar os filtros para ordenar o conjunto inteiro.
- Clicar numa linha (ou Enter/Espaço) abre a ficha lateral do contato.
Ficha do contato (painel lateral)
Abre pela direita ao clicar num contato. Fecha no X ou com Esc.
- Topo com a cor da temperatura, nome, selos de autorização e "Lead de teste", e a linha com empresa (ou telefone), temperatura e score.
- Selos "Veio da integração" e "Veio do anúncio" quando a origem é conhecida.
- Qualificação: "‹n› de ‹n› sinais" do público do contato, cada sinal com barra e a frase que o comprovou, ou "ainda não capturado". Sem qualificação, a ficha diz que os sinais aparecem quando a IA qualificar o contato na conversa.
- Contato: Telefone, E-mail, Empresa e Origem.
- Veio da integração: as entradas recebidas e os dados que chegaram junto, só para quem veio por integração.
- Jornada: a linha do tempo com data e hora; o evento mais recente tem o ponto preenchido. Sem eventos, "Sem atividades ainda."
Pode receber mensagem?
O bloco da ficha que diz de onde vem a autorização para falar com o contato.
Botões e ações
- Declarar base legalDono
- Aparece só em contato sem autorização registrada. Escolha o motivo no seletor (São meus clientes, Pediram para eu entrar em contato ou Já coletei o consentimento deles) e confirme no botão de mesmo nome. A declaração fica com o seu nome e a data, e o contato passa a entrar em campanha.
- "Consentimento do titular": a pessoa respondeu no atendimento e recebeu o aviso de privacidade, ou autorizou no formulário de uma integração.
- "Base legal declarada — ‹base›": quem declarou e quando, com o artigo da LGPD. A ficha deixa claro que não é consentimento do titular.
- "Sem autorização registrada": o contato não entra em campanha até responder ou até o dono declarar a base legal.
- "Pediu para não receber mensagens": vence tudo; o contato não entra em campanha e não recebe mensagem automática.
Etiquetas
As etiquetas do contato, as mesmas do Inbox.
Campos e filtros
- Adicionar etiqueta
- Digite o nome e aperte Enter (ou saia do campo) para aplicar. Etiqueta repetida é ignorada.
Botões e ações
- Remover a etiqueta ‹nome›
- O X da etiqueta abre a confirmação "Remover esta etiqueta?".
- Remover etiqueta
- Confirma a remoção. A etiqueta sai deste contato aqui e no Inbox; os outros contatos que a usam não mudam.
- Cancelar
- Fecha a confirmação sem remover.
- Sem etiquetas, aparece "Sem etiquetas ainda."
Rodapé da ficha
As ações sobre o contato.
Botões e ações
- Continuar no WhatsAppDono
- Só para contato do chat do site que informou telefone: transforma o contato num contato de WhatsApp com aquele número, mantendo consentimento, qualificação e etiquetas, e abre a conversa no Inbox para enviar o modelo.
- Iniciar atendimento
- Abre a conversa do contato no Inbox, ou cria uma nova quando ele é alcançável por WhatsApp. Apagado, a dica diz por quê.
- Disparar
- Botão ainda desativado; a dica avisa que o envio manual chega numa fase futura.
- Editar
- Transforma o bloco Contato num formulário com Nome, Empresa e E-mail, com os botões Salvar e Cancelar.
- Salvar
- Grava as alterações de nome, empresa e e-mail. Exige o nome preenchido.
Diálogo Novo contato
Cadastro manual de um contato, fora da conversa com a IA.
Campos e filtros
- Nomeobrigatório
- Nome completo.
- Telefoneobrigatório
- Com DDD, por exemplo +55 11 91234-5678.
- Empresa
- Opcional; sugere as empresas que já existem.
- CNPJ
- Opcional. Completo, consulta a Receita e preenche a empresa, com o aviso "Preenchido pela Receita".
- Opcional.
- Etiquetas
- Opcional, separadas por vírgula.
Botões e ações
- Criar contato
- Salva o contato e abre a ficha lateral dele. Só habilita com nome e telefone.
- Telefone repetido é recusado com "Já existe um contato com este telefone."
Diálogo Importar contatos (CSV)
Três etapas: escolher o arquivo, conferir as colunas e declarar a base legal, ver o resumo.
Campos e filtros
- Telefoneobrigatório
- Qual coluna da planilha é o telefone. A tela já sugere pela palavra do cabeçalho.
- Nome
- Qual coluna é o nome (ou "— nenhuma").
- Empresa
- Qual coluna é a empresa (ou "— nenhuma").
- Qual coluna é o e-mail (ou "— nenhuma").
- Por que você pode falar com estes contatos?obrigatório
- Escolha obrigatória entre São meus clientes, Pediram para eu entrar em contato e Já coletei o consentimento deles. Fica gravada com seu nome e a data e é o que autoriza os importados a receber campanha.
Botões e ações
- Arraste o CSV aqui ou clique para escolher
- Área para soltar o arquivo .csv ou abrir o seletor do computador.
- Baixar modelo de exemplo
- Baixa um CSV de exemplo com as colunas nome, telefone, empresa e email.
- Escolher outro
- Volta para a escolha do arquivo.
- Importar contatos
- Importa a planilha. Fica travado até a coluna do telefone e a base legal serem escolhidas; a dica diz qual falta.
- Importar outro
- Depois do resumo, recomeça com outro arquivo.
- Concluir
- Fecha o diálogo.
- Na conferência, uma prévia das primeiras linhas com o nome de cada coluna.
- Aviso fixo: a declaração não é o consentimento do titular, e contatos importados não são abordados automaticamente pela IA.
- Resumo final com três números: criados, inválidos e no arquivo.
Fila de inválidos e importações recentes
As linhas recusadas de uma importação, para corrigir uma a uma.
Campos e filtros
- Telefone corrigido
- O telefone da linha recusada, editável. Cada linha mostra o número da linha e o motivo da recusa.
Botões e ações
- Recriar
- Cria o contato com o telefone corrigido e marca a linha como "Contato criado".
- Corrigir
- Em "Importações recentes", abre a fila de inválidos daquela importação (vira "Fechar").
- "Corrigir inválidos (‹n›)" aparece logo após a importação, quando houve recusas.
- "Importações recentes": cada arquivo com quantos foram criados e quantos inválidos, a data, a base legal declarada e quem declarou.
Estados da tela
- Carregando
- Faixas cinzas no formato do modo escolhido (blocos no modo Cartão, linhas no modo Tabela).
- Sem nada ainda
- "Nenhum contato neste recorte." Com filtro ligado, a tela explica que os filtros estão estreitando a lista e oferece Limpar filtros; sem filtro, convida a cadastrar o primeiro contato ou importar uma planilha.
- Se der erro
- "Não foi possível carregar os contatos." com o botão Tentar novamente.