Sincronizar e exportar contatos
Traga contatos do WhatsApp Web e de arquivos CSV para o Zhapio, pesquise rapidamente e exporte listas sem duplicidade.
Dicas práticas
Neste guia: Prepare uma lista de contatos atualizada para conversar, importar ou exportar.
O gerenciamento de contatos do Zhapio fica no painel Contatos da extensão do navegador, dentro do próprio WhatsApp Web — não é uma página do painel principal do Zhapio. Para ver contatos você precisa da permissão crm.contacts.view; para sincronizar, importar por CSV ou exportar, é preciso crm.contacts.manage. O recurso também depende do plano incluir o módulo Contatos.
Sincronizar contatos
O botão Sincronizar WhatsApp lê a lista de conversas que está carregada na tela do WhatsApp Web naquele momento e traz nome, telefone e foto de perfil de cada conversa para dentro do Zhapio. Isso é diferente da sincronização automática de leads (veja a seção abaixo): aqui, nada acontece até você clicar no botão.
No WhatsApp Web, abra o painel Contatos da extensão Zhapio.
Clique em Sincronizar WhatsApp.
Aguarde — a extensão espera até 5 segundos a lista de conversas carregar e então lê cada linha visível na tela (nome, telefone e foto de perfil).
Use a busca para conferir se os contatos que você esperava aparecer foram realmente importados.
Atenção
- A sincronização lê apenas as conversas que já estão carregadas na tela — o WhatsApp Web carrega a lista aos poucos conforme você rola, e não há rolagem automática durante a sincronização.
- Se você tem muitas conversas, role a lista até mais para baixo antes de clicar em Sincronizar WhatsApp; do contrário só as conversas mais recentes (as já renderizadas) entram.
- Contatos com o mesmo telefone são descartados automaticamente antes do envio, então não é preciso limpar a lista manualmente antes de sincronizar.
Sincronização automática de leads
Toda vez que o painel Contatos é aberto, a extensão dispara sozinha uma segunda sincronização, independente do botão Sincronizar WhatsApp: ela pega os leads já cadastrados no seu CRM (nos funis) e garante que cada um também exista como contato. Diferente da sincronização do WhatsApp, essa não lê nada da tela do WhatsApp Web — ela usa os dados que já estão salvos no Zhapio.
Não existe botão nem confirmação para essa sincronização: ela acontece sozinha a cada abertura do painel, em segundo plano, e se falhar, falha em silêncio — nenhum erro é mostrado na tela.
Dicas práticas
Se um lead que você sabe que existe não aparece na lista de contatos, feche e reabra o painel Contatos. Isso dispara a sincronização automática de leads de novo.
Importar contatos por CSV
O botão Importar CSV usa o mesmo caminho de sincronização do botão Sincronizar WhatsApp — a diferença é só a origem dos dados: em vez de ler a tela, a extensão lê um arquivo que você escolhe no computador.
No painel Contatos, clique em Importar CSV.
Selecione o arquivo com as colunas de nome e telefone dos seus contatos.
A extensão envia os contatos lidos do arquivo: os que já existem (mesmo telefone) são atualizados, os novos são criados como contatos.
Atenção
O importador de CSV de Contatos não reconhece automaticamente o DDI brasileiro. Se a coluna de telefone tiver um número sem o +55 na frente — por exemplo 11987654321 — ele é salvo como +11987654321 em vez do correto +5511987654321. Para evitar isso, inclua o +55 (ou 55) na frente de cada telefone no arquivo antes de importar.
Exportar lista
A exportação roda inteiramente no navegador, dentro da extensão — não existe um "exportar tudo" processado pelo servidor. Ela pega os contatos que estão carregados na tela naquele momento, ou seja, a página atual da lista, já filtrada pela busca que você aplicou, e não a base inteira de contatos.
Importante
A lista de contatos é paginada em 10, 25 ou 50 por página. Um arquivo exportado tem no máximo os contatos da página atual — no melhor caso, até 50 de uma vez. Para exportar uma base maior, ajuste a paginação para 50, exporte, avance de página e exporte de novo, repetindo até cobrir toda a lista.
Dois formatos estão disponíveis. O CSV traz só quatro colunas — Nome, Telefone, Email e Tags, com as tags separadas por ; dentro da mesma célula — pensado para abrir em planilha. O JSON traz o objeto completo de cada contato como ele existe no Zhapio: id, nome, telefone, email, foto de perfil, tags, notas, quantidade de mensagens, data da última mensagem, origem (WhatsApp, CSV ou lead), funil e lead vinculado, entre outros campos — útil se você for levar os dados para outro sistema.
No painel Contatos, filtre e pagine até deixar visível o conjunto de contatos que você quer exportar.
Escolha o formato de exportação: CSV ou JSON.
O arquivo é baixado automaticamente, com o nome contacts_AAAA-MM-DD seguido da extensão escolhida.
Qualidade dos dados
O Zhapio normaliza telefones de formas diferentes dependendo de como o contato chegou até você — e isso pode fazer a mesma pessoa virar dois contatos separados dentro da sua conta.
Atenção
- Contato criado a partir de um lead do CRM: o telefone é salvo no formato canônico com DDI — é o caminho mais confiável.
- Contato sincronizado pelo botão Sincronizar WhatsApp ou importado por CSV: o telefone é salvo exatamente como foi lido ou digitado, sem normalização — se faltar o DDI, fica salvo errado.
- Contato editado manualmente na tela de edição: também não passa por normalização; nada impede salvar sem o +55.
Na prática, um número salvo como 11987654321 pela sincronização do WhatsApp e o mesmo número salvo como 5511987654321 por um lead são tratados como dois contatos diferentes pelo Zhapio — não existe uma segunda checagem que os junte depois.
Dicas práticas
Sempre que digitar ou revisar um telefone manualmente, use o formato completo +55DDNNNNNNNNN (exemplo: +5511987654321). É o único formato compatível com todos os pontos de entrada de contatos do Zhapio.
Duplicidade de contatos
O Zhapio impede dois contatos com o mesmo telefone na mesma conta pessoal ou na mesma organização, mas a forma como isso é verificado muda dependendo da origem do contato — e nem sempre você fica sabendo se algo foi descartado.
Contatos vindos de leads passam por uma checagem mais robusta antes de gravar; se ainda assim duas gravações concorrerem pelo mesmo telefone, o sistema resolve sozinho, aproveitando o registro que venceu a corrida. Já contatos sincronizados do WhatsApp ou importados por CSV usam uma checagem mais simples, comparando apenas os contatos que você já tem carregados no momento: se o telefone bater com um contato existente, ele é atualizado; mas se a checagem não encontrar o contato por qualquer motivo, esse contato específico é simplesmente pulado, sem aparecer como erro na tela e sem entrar na contagem de contatos sincronizados.
Importante
Não existe hoje uma busca por contatos "parecidos" — nomes semelhantes ou telefones quase iguais não são detectados. A checagem de duplicidade é sempre por telefone exatamente igual, o que reforça por que manter os telefones no formato completo com DDI é o que realmente evita duplicatas.
Continue aprendendo
Escolha o próximo guia de acordo com a tarefa que você quer concluir: