Visão geral
Quem usa: Administrador, Supervisor e Atendente. O que é: o diretório central de clientes da plataforma: um CRM integrado que permite armazenar, segmentar e gerenciar toda a base de contatos, do cadastro manual à importação massiva, passando pela organização por carteiras e etiquetas. No menu lateral esquerdo, clique em Atendimento e selecione Contatos para acessar a tela.Barra de ferramentas
Na barra de ferramentas superior você encontra:Pesquisando e filtrando
Use os filtros e colunas disponíveis para refinar a lista:- Localize: busca global por nome, e-mail ou telefone.
- Tags: filtra contatos por uma ou várias etiquetas ao mesmo tempo, escolhendo se o contato precisa ter todas as etiquetas selecionadas ou qualquer uma delas.
- Filtrar por carteira: filtra contatos da carteira de um atendente. Quem não vê todas as carteiras só encontra a própria carteira nessa lista.
- Filtrar por fila: filtra contatos vinculados a uma fila.
- Filtro por Endereço: o botão com ícone de mapa abre um filtro por Bairro, Cidade e UF do cadastro, estreitando a lista aos contatos com esse endereço cadastrado.
- Colunas: escolha quais informações aparecem na tabela (ex.: CPF, Cidade, CEP, Rua, Bairro, UF, Fila, LID, Bloqueado). Nas colunas Bloqueado e Bl. Chatbot, a chave liga ou desliga na hora o bloqueio do contato e o bloqueio do chatbot para ele. O ícone de informação ao lado de Bl. Chatbot explica: O fluxo e o agente de IA deixam de responder este contato. Se o agente estiver atendendo agora, ele é desligado na hora. Desbloquear não religa: o agente volta só num atendimento novo.
Ações por contato
Para cada contato na tabela, use os ícones de ação:Criando um contato manualmente
Abra o formulário
Preencha os dados obrigatórios
5511999999999). Com Validar Contato ligado em Configurações → Gerais → Geral (seção Organização e Distribuição), o número é conferido no WhatsApp pela conexão padrão: se não estiver no WhatsApp, a tela avisa Este número não está no WhatsApp. Confira o DDD e o nono dígito., e se a conexão não conseguir conferir, Não foi possível validar o número no canal conectado. Tente novamente em instantes. Com Validar Contato desligado, nenhuma conexão é consultada e a janela avisa A validação de contatos está desligada (Configurações Gerais › Validar Contato): o número é salvo como foi digitado, sem conferir se tem WhatsApp em nenhuma conexão.Complemente o cadastro
Preencha o endereço, se quiser
Crie campos personalizados, se precisar
Salve
Importando contatos em massa
Abra o assistente
Envie o arquivo (etapa Origem)
Confira a estrutura (etapa Estrutura)
Mapeie as colunas (etapa Identificação)
Escolha como atualizar quem já existe
Ajuste os padrões e os vínculos
- Código do país padrão e Código de área padrão: só são acrescentados ao número que ainda não começa com eles. Número com
+ou00na frente é mantido como está. Deixe em branco para não aplicar. O código do país já vem preenchido com o da sua empresa. - Etiquetas (opcional): aplicadas a todos os contatos do arquivo. Ao escolher etiquetas, aparece a opção Adicionar as etiquetas as existentes (sem substituir).
- Carteira (opcional): a carteira dos contatos importados (Sem carteira por padrão).
- Fila (opcional): os contatos ficam vinculados à fila, e novos atendimentos deles entram nela automaticamente (quando isso está ativado nas Configurações).
- Validar contatos no WhatsApp: confere os números e exige conexão ativa. A tela avisa que a validação pode bloquear ou banir o número pelo WhatsApp. Com Validar Contato desligado em Configurações Gerais, essa opção não aparece e a tela avisa A validação de contatos está desligada (Configurações Gerais › Validar Contato): a importação não confere nenhum número no WhatsApp.
Importe
Iniciando um atendimento pela lista
Localize o contato
Clique no ícone de balão
Confirme os dados do atendimento
Converse
Convidando o contato para o Telegram
Quem usa: Administrador, Supervisor e Atendente. No Perfil Personalizado, é preciso ter a permissão Editar contatos. Usuário Restrito não vê esta ação. Se a sua empresa tem um canal do tipo Telegram conectado, você pode ligar o Telegram de um contato que já existe (por exemplo, um cliente do WhatsApp) ao cadastro dele. Assim, o cliente passa a poder falar com você também pelo Telegram, sem criar um segundo cadastro.Abra o convite
Escolha o bot
Gere o link
Envie à pessoa
A pessoa toca em Iniciar
Avisos que você pode ver
Navegadores do WebChat ligados ao contato
Quando a sua empresa usa o link de convite do WebChat (veja Webchat), o cliente que abre o link continua a conversa no WebChat como este mesmo contato. Ao editar o contato (lápis), logo abaixo de Mais campos e IDs de canais, a linha WebChat mostra quantos navegadores estão ligados (por exemplo, 1 navegador ligado). No atendimento, a mesma linha aparece no painel de informações do contato. A linha só aparece quando há pelo menos um navegador ligado.Desligue os navegadores
Mande um link novo, se for o caso
Utilitários de manutenção da base
O Problema da Duplicidade por LID
Às vezes um contato já salvo passa a aparecer com um número de código longo no lugar do telefone (algo como123456789012345), e quando essa pessoa escreve de novo o sistema entende que é alguém novo, criando um segundo cadastro e um segundo ticket para a mesma pessoa.
Na maioria das vezes, isso não é um cadastro errado: o WhatsApp criou um identificador de privacidade chamado LID, e em canais de API não oficial (Baileys, Meow/WuzAPI, Evolution, ZAPO, WebJS, Z-API, Uazapi) a mensagem às vezes chega identificada por esse LID em vez do número real. Canais de API Oficial (WABA) não sofrem com isso.
Como resolver, do mais simples ao mais completo:
Caso pontual
Em massa
Casos que não resolvem com os anteriores
Conversa dividida em dois atendimentos depois de escrever pelo celular (conexões Meow)
Numa conexão Meow, quando a primeira mensagem para uma pessoa é enviada pelo celular da conexão (e não pelo painel), o sistema ainda não conhece o telefone dela e cria um cadastro com o código no lugar do número e com o nome da própria conexão como nome de perfil. Quando a pessoa responde, a resposta vai para o cadastro com o telefone, e a conversa fica dividida: o que sai do celular num atendimento, o que a pessoa manda no outro. Para juntar, use a Mesclagem manual de par (veja Configurações Gerais): o cadastro com o telefone é o que fica e o cadastro com o código é o duplicado.Página do Contato (Linha do tempo e Relacionamento)
Quem usa: Administrador, Supervisor e Atendente (uso diário). O Administrador vê todos os contatos; os demais veem os contatos da própria carteira, os sem carteira e os de um atendimento que conseguem abrir. O Usuário Restrito não acessa esta página. O que é: o Perfil do contato, uma página própria para cada contato que reúne em um só lugar tudo que já aconteceu com aquele cliente, além de um espaço para a equipe registrar o relacionamento comercial fora das conversas de chat.O que a página reúne
- Aba Perfil (Resumo do cliente): Atendimentos (total e quantos estão em aberto agora), Cliente desde, Vendas, Valor perdido, Oportunidades em aberto, Oportunidades, Avaliação do cliente (estrelas que indicam a taxa de conversão, oportunidades ganhas sobre as fechadas, exibidas a partir de 2 oportunidades fechadas), Etiquetas e Carteira.
- Aba Linha do tempo: o histórico do contato em ordem cronológica, com filtros por grupo: Atendimentos, Funil, Etiquetas e cadastro, Campanhas, Notas, Chamadas e Relacionamento. Cada evento mostra quem fez e por onde (tela, API, chatbot, IA, automação, campanha ou mensagem do cliente).
- Aba Relacionamento: onde a equipe registra ações que não acontecem dentro do chat, como ligações, propostas e visitas, com anexos, e acompanha as Tarefas do contato.
Como usar
Abra o Perfil do contato
/contatos/12345) é o ID do contato, pedido na Mesclagem manual de par. No topo da página, o botão Abrir em… abre um sistema da empresa já neste contato, quando a empresa tem um aplicativo com Contato marcado que você pode ver (veja Aplicativos).Confira o resumo
Revise o histórico
Registre uma ação
Configure categorias e retenção (Administrador)
Relatórios ligados a este recurso
Os registros da aba Relacionamento alimentam quatro relatórios (em Gestão Comercial → Relatórios): Relacionamento por tipo, Tarefas por atendente, Funil por atendente e Ações até a venda. Benefícios e quando usar: é a ferramenta certa quando o relacionamento com o cliente vai além da conversa de WhatsApp: uma venda B2B com visitas e propostas, um pós-venda que envolve ligações de acompanhamento, ou qualquer operação que precise provar, mais tarde, tudo que foi feito por aquele cliente específico. A Linha do tempo evita ter que reconstruir esse histórico manualmente, abrindo um ticket fechado atrás do outro.Restrição de Acesso a Contatos
Quem usa: Administrador (configura); o efeito recai sobre o Atendente marcado como “Usuário Restrito”. O que é: uma camada de segurança e privacidade para a gestão de dados de contato, criada para atender a conformidade com a LGPD. Permite limitar o que um usuário específico pode ver e fazer com os dados dos clientes.Acesse Usuários
Localize o usuário
Habilite a restrição
Salve
Efeitos da restrição, uma vez ativada para o usuário
Na navegação geral:- O menu Contatos fica oculto: o usuário não consegue visualizar nem exportar a lista completa de contatos.
- O botão “Iniciar Conversa Avulsa” na tela de Atendimentos fica oculto.
- O nome do contato aparece parcialmente (só os 5 primeiros caracteres).
- A foto do perfil recebe um forte efeito de desfoque (blur).
- Dados sensíveis (telefone, e-mail, CPF etc.) ficam ocultos no painel de detalhes do contato.
- O botão de editar contato (lápis) fica oculto.
- As opções de telefonia ficam desabilitadas.
- As ações de Encaminhar e Marcar mensagem ficam desabilitadas, para impedir vazamento de dados.

