A importação falhou
A importação de contatos tem quatro etapas: Upload → Mapeamento → Confirmar → Resultado. A maior parte dos problemas aparece nas duas primeiras.
Não consegue subir o arquivo
Seção intitulada “Não consegue subir o arquivo”Formatos aceitos: .xlsx, .xls e .csv. Qualquer outro é recusado com “formato não suportado”.
Os tropeços comuns:
- Arquivo do Google Sheets — baixe como XLSX ou CSV antes
- Arquivo aberto no Excel — feche antes de subir
- CSV com acento quebrado — salve como CSV UTF-8, não o CSV padrão do Excel brasileiro
- Planilha com mais de uma aba — deixe só a aba dos dados
Se der “erro ao ler arquivo”, quase sempre é uma dessas.
Trava no Mapeamento
Seção intitulada “Trava no Mapeamento”Depois do upload, você associa cada coluna do arquivo a um campo do contato. A tela mostra uma prévia de cada coluna, o que ajuda a não trocar telefone por CPF.
Os campos disponíveis: Nome, Sobrenome, E-mail, Número de telefone, Identificador, Nome da empresa, Cidade, País — mais os atributos personalizados que você já tenha criado.
”Mapeie pelo menos o campo E-mail ou Número de telefone”
Seção intitulada “”Mapeie pelo menos o campo E-mail ou Número de telefone””É a trava mais comum, e ela é proposital.
Sem e-mail nem telefone, o sistema não tem como saber se a linha é uma pessoa nova ou alguém que já existe — e importar assim duplicaria a base inteira.
Solução: mapeie pelo menos um dos dois. Se o seu arquivo não tem nenhum, ele não serve para importar contato.
Coluna que não deve entrar
Seção intitulada “Coluna que não deve entrar”Use Ignorar no seletor. Não precisa editar a planilha.
Atributo personalizado não aparece na lista
Seção intitulada “Atributo personalizado não aparece na lista”Só aparecem os atributos que já existem na conta. Crie primeiro em Config. → Atendimento → Atributos, depois volte e reimporte.
A tela de Confirmar é onde se evita o susto
Seção intitulada “A tela de Confirmar é onde se evita o susto”Antes de importar, ela mostra:
| Contatos detectados | Quantas linhas válidas |
| Novos contatos | Quantos vão ser criados |
| Serão atualizados | Quantos já existem e vão receber os dados novos |
Se “serão atualizados” vier alto e você esperava tudo novo, pare. Ou a base já tinha essas pessoas, ou o mapeamento está errado.
A deduplicação é por e-mail e telefone. Mesmo e-mail ou mesmo telefone, mesmo contato.
Terminou e “não aconteceu nada”
Seção intitulada “Terminou e “não aconteceu nada””A importação roda em segundo plano. Você recebe uma notificação quando ela termina.
Arquivo grande leva minutos. Sair da tela não cancela nada.
Se passou tempo demais, confira a contagem de contatos da conta antes de reimportar — reimportar o mesmo arquivo não duplica, mas também não ajuda a diagnosticar.
Antes de importar, vale saber
Seção intitulada “Antes de importar, vale saber”A importação sempre entra numa lista. Segmento com regra não recebe importação, porque quem entra nele é quem casa com a regra.
Telefone: o que muda o resultado
Seção intitulada “Telefone: o que muda o resultado”O número é normalizado antes da comparação, então 11 99999-0000, (11) 99999-0000 e +5511999990000 são tratados como o mesmo.
O que atrapalha:
- Sem DDD — não dá para normalizar, e vira contato separado
- Número fixo no campo de celular — entra, mas nunca vai receber WhatsApp
- Coluna formatada como número no Excel — o zero à esquerda some. Formate como texto antes de salvar
Quando falar com a gente
Seção intitulada “Quando falar com a gente”- A importação termina mas os contatos não aparecem em lugar nenhum
- A contagem de “novos” não bate com o que entrou
- O arquivo é aceito, o mapeamento passa, e o resultado dá erro desconhecido
Mande o arquivo (ou um recorte dele, com as mesmas colunas) e o horário da tentativa.