Pular para o conteúdo principal

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:
A planilha gerada por Exportar Contatos mostra todas as etiquetas de cada contato, não apenas uma. Se um contato tiver atendimentos ou oportunidades vinculados, a exclusão pede confirmação para Deletar forçadamente, o que apaga também esses vínculos.

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: Clique no nome do contato para abrir o Perfil do contato (veja Página do Contato, abaixo).
Ao editar um contato (lápis desta tela ou Editar contato nos detalhes do contato no atendimento), o número só é conferido no WhatsApp quando você o troca: o ícone de informação ao lado de Número explica isso. Número novo sem WhatsApp é salvo mesmo assim, e a tela avisa Contato salvo, mas este número não tem WhatsApp: as mensagens pelo WhatsApp não vão chegar a ele. Com Validar Contato desligado em Configurações Gerais, nenhuma conexão é consultada e a janela de edição mostra o aviso de validação desligada. Ao editar um contato do WhatsApp oficial e gravar outro número, o vínculo com o WhatsApp oficial do número anterior (identificador e @usuário) é apagado, para as mensagens dele não caírem neste contato. Ajustar só o formato do mesmo número (como o 9º dígito) mantém o vínculo, e a tela mostra esse aviso logo abaixo do campo de número. Campos de texto do cadastro, como Nome e os Campos extras, aceitam até 255 caracteres: se passar, a tela avisa qual campo encurtar, por exemplo O campo “Nome” passou do limite de 255 caracteres. Encurte o texto e salve de novo. Se aparecer O campo ”…” tem um valor que não existe mais nesta empresa. Recarregue a tela e escolha de novo., a opção escolhida foi removida da empresa: recarregue a página e escolha outra.
Apagar o conteúdo de um campo e clicar em Salvar deixa o campo vazio, tanto no lápis desta tela quanto no botão Editar Contato dos detalhes do contato no atendimento (Primeiro Nome, Sobrenome, Email, CPF / CNPJ, Data de Nascimento, Empresa e o endereço). Há duas exceções. O Número de um contato que já tem telefone não pode ficar vazio: a tela avisa Número deve ter pelo menos 8 dígitos; o contato que chegou sem telefone salva sem ele. E, em Mais campos e IDs de canais, o LID, a chave É LID (contato de identificação do dispositivo) e os IDs dos canais só são enviados quando você mexe neles na janela aberta: o que você não mexeu fica como está gravado, e apagar o conteúdo de um ID e salvar o remove.

Criando um contato manualmente

1

Abra o formulário

Clique em + Adicionar Contato.
2

Preencha os dados obrigatórios

Preencha Nome e Número (formato obrigatório DDI + DDD + Número, ex.: 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.
3

Complemente o cadastro

Preencha, se quiser, Primeiro Nome, Sobrenome e Email. Em Mais campos e IDs de canais ficam CPF / CNPJ, Data de Nascimento, Empresa e os IDs de outros canais. Adicione Tags, vincule a uma Carteira e escolha uma Fila (novos atendimentos do contato entram automaticamente nessa fila, quando isso está ativado nas Configurações).
4

Preencha o endereço, se quiser

Na seção Endereço, digite o CEP e clique em Buscar CEP (a busca também roda sozinha ao terminar de digitar) para preencher Rua, Bairro, Cidade e UF automaticamente; complete o Nº e o Complemento à mão. Se o CEP não for encontrado, preencha os campos manualmente.
5

Crie campos personalizados, se precisar

Em Campos extras, clique em Adicionar campo para criar campos personalizados (ex.: “Data de Vencimento”).
6

Salve

Clique em Salvar.

Importando contatos em massa

1

Abra o assistente

Clique em Importação Inteligente.
2

Envie o arquivo (etapa Origem)

Arraste o arquivo para a área Arraste o arquivo aqui ou clique para selecionar (CSV, XLS, XLSX ou TXT, de até 30 MB) e clique em Próximo. A primeira linha do arquivo é lida como cabeçalho.
3

Confira a estrutura (etapa Estrutura)

A tela mostra quantas linhas foram encontradas e as primeiras linhas do arquivo, para você validar. Em arquivos CSV e TXT, o campo Divisor vem em Automático (o sistema detecta o separador das colunas); se preferir, escolha Vírgula, Ponto e vírgula, Tabulação ou Barra vertical. Clique em Próximo.
4

Mapeie as colunas (etapa Identificação)

Para cada coluna do arquivo, escolha o campo do contato (Nome, Telefone, E-mail, Primeiro nome, Sobrenome, Empresa, CPF, Data de nascimento, CEP, Rua, Nº (endereço), Complemento, Bairro, Cidade ou UF) ou Ignorar coluna. O sistema já sugere o campo pelo título da coluna. Para guardar um dado extra, escolha Novo campo personalizado, dê um nome e confirme. É preciso mapear pelo menos Nome ou Telefone: sem isso, a tela avisa Mapeie pelo menos o campo Nome ou Telefone.
5

Escolha como atualizar quem já existe

O contato que já existe é achado pelo telefone e atualizado conforme a opção de cada coluna: Sempre atualizar (a opção que já vem marcada), Nunca atualizar, Nunca se vazio no arquivo ou Apenas se vazio no sistema.
6

Ajuste os padrões e os vínculos

Ainda na etapa Identificação, preencha o que precisar:
  • 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 + ou 00 na 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.
7

Importe

Clique em Importar. A tela mostra Importando… e, ao terminar, Importação concluída! com os totais Criados, Atualizados e Falhas.
Com Sempre atualizar, uma célula vazia no arquivo apaga o dado que o contato já tem, inclusive em campo personalizado. Para não apagar, use Nunca se vazio no arquivo. Um campo personalizado só é atualizado se o nome for escrito igual ao do contato (mesmas maiúsculas e acentos); com nome diferente, o sistema cria outro campo.

Iniciando um atendimento pela lista

1

Localize o contato

Localize o contato desejado na tabela.
2

Clique no ícone de balão

Clique no ícone de balão (Iniciar atendimento) e escolha, na lista, o canal pelo qual a conversa será feita.
3

Confirme os dados do atendimento

Na janela Iniciar atendimento, confira a Conexão, escolha a Fila (opcional) e o Atendente e clique em Iniciar.
4

Converse

O sistema abre o chat deste contato na tela de Atendimentos. Se já existir um ticket aberto para ele, o sistema avisa (Atendimento existente) e oferece Abrir ticket.

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.
1

Abra o convite

Na lista de Contatos, clique no ícone de avião de papel (Convidar para o Telegram) na linha do contato. No atendimento, a mesma ação fica no painel de informações do contato, na aba Gestão, card Ações do ticket, botão Convidar para o Telegram.
2

Escolha o bot

Na janela Convite para o Telegram, o campo Bot do Telegram lista os bots conectados que você pode usar. Havendo só um, ele já vem escolhido.
3

Gere o link

Clique em Gerar link. A janela mostra o Link do convite, o botão Copiar (aparece o aviso Link copiado), a validade (Vale até a data e a hora) e um QR Code, para a pessoa ler com a câmera do celular.
4

Envie à pessoa

Em Contatos, copie o link ou use Enviar por outro canal, que abre uma nova conversa com o número, o nome e o texto do convite já preenchidos. O Enviar por outro canal não aparece para o Perfil Personalizado sem as permissões Criar atendimentos e Envio de mensagem (basta uma das duas): nesse caso, copie o link ou mostre o QR Code. Na janela do atendimento, edite o campo Mensagem, se quiser, e clique em Enviar neste atendimento (aparece o aviso Convite enviado).
5

A pessoa toca em Iniciar

Quando a pessoa abre o link no Telegram e toca em Iniciar, o Telegram dela fica ligado a este contato e o bot responde confirmando. Depois disso, o contato passa a ter o Telegram ID preenchido e a ação de convite deixa de aparecer para ele.
O link vale por 7 dias e só pode ser usado uma vez. Gerar um novo link (Gerar novo link) cancela o anterior. Quem tiver o link consegue usá-lo, então envie só para a própria pessoa. Ao fechar a janela, o link não fica guardado na tela: para ver um link de novo, gere outro.
Nos canais oficiais do WhatsApp só é possível enviar modelos aprovados, então o texto com o link não vai junto. Use um canal não oficial, o e-mail ou copie o link. Os textos que o bot responde à pessoa (convite aceito, link expirado ou já usado e Telegram já ligado a outro cadastro) podem ser personalizados em cada canal do Telegram. Se o convite resultar em uma mesclagem de contatos, ela aparece na lista Reverter mesclagens com a Origem Convite do Telegram e pode ser revertida por um Administrador.

Avisos que você pode ver

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.
1

Desligue os navegadores

Clique em Desligar e confirme em Desligar navegadores do WebChat?. Os navegadores ligados deixam de receber a conversa e os links de convite já enviados deixam de valer. A tela confirma Navegadores do WebChat desligados.
2

Mande um link novo, se for o caso

Para o cliente voltar ao WebChat, mande um link de convite novo.
O botão Desligar exige a permissão Editar contatos no Perfil Personalizado e não aparece para o Usuário Restrito. No atendimento, a linha não aparece em grupos nem para o Usuário Restrito. Na aba Linha do tempo do perfil do contato, o filtro Etiquetas e cadastro mostra os eventos Abriu o WebChat pelo link de convite e Navegadores do WebChat desligados.

Utilitários de manutenção da base

Ao sincronizar, um canal com problema não impede os demais: os outros canais continuam e o aviso mostra qual canal falhou e por quê (até 5 canais, com “e mais N” quando há mais). O aviso aparece com um destes títulos: O motivo de cada canal pode ser: Um canal que demora mais de 20 segundos continua sincronizando em segundo plano: o aviso mostra Ainda sincronizando em segundo plano: seguido dos canais, e não é preciso clicar de novo. Ao terminar Remover Duplicados, Agrupar LID ou Verificar 9° Dígito, o sistema mostra o Resumo da operação, com os grupos encontrados e os pares Mesclados, Pulados e com Erros. As mesclagens preservam todo o histórico e podem ser revertidas por um Administrador em Configurações → Gerais → Geral, na ferramenta Consolidar duplicatas LID (Reverter mesclagens). Benefícios e quando usar: é o ponto de partida de qualquer ação de relacionamento em massa: segmentar por etiqueta e carteira antes de uma campanha, por exemplo, ou simplesmente encontrar rapidamente um cliente para iniciar um atendimento avulso.
Um exemplo prático de uso combinado: para uma campanha voltada a clientes inativos há 30 dias, filtre por Etiqueta (ex.: “Inativo”) e Carteira (ex.: “Vendedor João”), depois use Exportar Contatos para gerar a lista de disparo ou inicie atendimentos individuais direto pelos ícones da tabela.

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 como 123456789012345), 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:
1

Caso pontual

Na conversa do contato, abra Informações do Contato → aba Infos → Atualizar LID. Isso sincroniza o identificador e junta contato, mensagens e ticket duplicados em um só, com o histórico completo preservado.
O mesmo Atualizar LID existe como ícone de setas circulares ao lado do campo LID, em Mais campos e IDs de canais, na janela de edição do contato (lápis em Contatos e Editar Contato no atendimento). Depois de clicar, a tela avisa LID atualizado, mas a janela aberta não recarrega o campo: ele pode seguir mostrando o valor antigo até você reabrir a janela. Salvar não reenvia esse valor antigo, porque o LID, a chave É LID (contato de identificação do dispositivo) e os IDs dos canais só são enviados quando você mesmo mexe neles.
2

Em massa

No menu Contatos → Utilitários → Agrupar LID, que faz a mesma unificação para todos os contatos afetados na base de uma vez.
3

Casos que não resolvem com os anteriores

Um Administrador encontra, em Configurações → Gerais → Geral (seção Ações do Sistema), a ferramenta Consolidar duplicatas LID, que permite Rodar auditoria (DRY_RUN) para simular antes de aplicar, mesclar pares em lote por CSV (Mesclagem em lote (CSV)) e Reverter mesclagens. Para juntar dois cadastros específicos, use a Mesclagem manual de par dessa ferramenta (veja Configurações Gerais). Por ser uma operação delicada, recomendamos falar antes com o suporte do PanÐá Zap.
Atenção ao usar o agrupamento em massa: revise o resumo antes de confirmar, principalmente se vários contatos tiverem o mesmo nome de exibição (por exemplo, o nome da própria empresa em vez do nome da pessoa), pois nesse cenário a detecção automática pode juntar contatos que não têm relação entre si.

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.
Para evitar, comece a conversa com um contato novo pelo painel (Nova Conversa) ou só escreva pelo celular depois da primeira resposta da pessoa.

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.
Esta página é diferente do painel lateral “Detalhes do Contato” descrito na tela de Atendimento: aquele é um resumo rápido dentro do chat; esta é uma página inteira, dedicada, com mais profundidade.

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

1

Abra o Perfil do contato

Clique no nome do contato na lista de Contatos, use Ver perfil completo no painel do atendimento, abra pelo card no Funil de Vendas ou pelo contato de uma tarefa em Tarefas. O número no fim do endereço da página no navegador (por exemplo, /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).
2

Confira o resumo

Na aba Perfil, confira o Resumo do cliente.
3

Revise o histórico

Use a aba Linha do tempo para revisar rapidamente tudo que já aconteceu com esse contato, sem precisar abrir ticket por ticket separadamente.
4

Registre uma ação

Na aba Relacionamento, clique em Registrar ação e preencha Categoria, Descrição, Data e hora, Responsável, Observações e, se houver, Anexos (imagens, PDF, documentos e planilhas). Em Tarefas, use Nova tarefa (Título, Data, Hora (opcional), Lembrete, Descrição e Responsável) para criar o acompanhamento; em cada tarefa, o lápis edita e os botões Concluir, Reagendar e Reabrir ajustam o andamento.
5

Configure categorias e retenção (Administrador)

As categorias de ação são cadastradas em Configurações → CRM → Tipos de relacionamento (o botão Adicionar tipos sugeridos cria uma lista inicial). Em Configurações → Gerais → Geral, o campo Retenção do histórico do contato define por quanto tempo os eventos da Linha do tempo (funil, etiquetas, carteira e cadastro) ficam guardados: Nunca apagar, 1 ano, 2 anos ou 5 anos. Atendimentos, mensagens e campanhas não são afetados.

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.
Tarefas criadas no card Tarefas do contato também aparecem normalmente na tela de Tarefas (capítulo Gestão): não é preciso abrir a página do contato para acompanhá-las no dia a dia.

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.
1

Acesse Usuários

Acesse Administração → Usuários.
2

Localize o usuário

Localize o usuário que deseja restringir e clique em Editar (ou crie um novo usuário).
3

Habilite a restrição

Habilite a opção “Usuário Restrito”.
4

Salve

Salve a alteração.

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.
Dentro de um ticket (tela de chat):
  • 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.
Benefícios e quando usar: use esta configuração para atendentes terceirizados, estagiários ou qualquer perfil que deva atender clientes sem ter acesso amplo aos dados cadastrais completos: protege os dados sensíveis dos seus clientes, limitando o acesso ao estritamente necessário para a função do atendente.
É uma configuração opcional, aplicada individualmente por usuário (não é um padrão geral da empresa).