Blog UzzAIContatos
Importar Contatos via Planilha (CSV)
Importe centenas ou milhares de contatos de uma só vez usando uma planilha CSV. Veja o formato correto e como mapear os campos.
05/03/2026•5 min•Por Equipe Uzz.Ai
Role para descobrir a jornada completa
SUMÁRIO10 seções
Se você já tem uma base de clientes em uma planilha (Excel, Google Sheets ou qualquer outra), pode importá-la diretamente para o UzzApp em formato CSV. O processo é simples e leva menos de 2 minutos para bases de até 10.000 contatos.
Passo 1 — Preparar a Planilha
- A planilha deve estar no formato CSV (valores separados por vírgula).
- A primeira linha deve ser o cabeçalho com os nomes das colunas.
- Colunas obrigatórias: nome e telefone.
- Colunas opcionais: origem, tags, observacoes.
- O número de telefone deve conter o DDI (ex: 5551999887766).
- Tags múltiplas devem ser separadas por ponto-e-vírgula: "cliente;vip;2026".
Modelo de planilha CSV
nome,telefone,origem,tags,observacoes
João Silva,5551999887766,indicação,cliente;vip,Cliente desde 2024
Maria Oliveira,5511988776655,site,,Interesse em produto X
João Silva,5551999887766,indicação,cliente;vip,Cliente desde 2024
Maria Oliveira,5511988776655,site,,Interesse em produto X
Passo 2 — Iniciar a Importação
- 1Acesse Dashboard → Contatos.
- 2Clique no botão "Importar" (ícone de upload) no canto superior direito.
- 3Selecione o arquivo CSV do seu computador (máximo 50MB por arquivo).
- 4O sistema exibirá uma prévia das primeiras 5 linhas para validação.
Passo 3 — Mapear os Campos
- 1Na tela de mapeamento, associe cada coluna do CSV ao campo correspondente no UzzApp.
- 2O sistema tenta mapear automaticamente por nomes similares.
- 3Corrija os mapeamentos incorretos clicando no campo e selecionando o destino correto.
- 4Se uma coluna não tem campo correspondente, selecione "Ignorar".
- 5Clique em "Confirmar Importação".
Passo 4 — Acompanhar o Processamento
- 1Uma barra de progresso mostra o andamento da importação.
- 2Ao final, um relatório indica: contatos importados com sucesso, duplicados ignorados e erros.
- 3Contatos com número de telefone inválido são listados no relatório de erros.
- 4Contatos duplicados (mesmo número já cadastrado) são ignorados por padrão.
Números inválidos
O sistema valida o formato do número durante a importação. Números sem DDI, com letras ou formatação incorreta são rejeitados e listados no relatório de erros. Corrija-os na planilha e reimporte apenas os inválidos.
Duplicatas na importação
Se um número já existe na base, o contato é atualizado com os novos dados (nome, tags, observações) e não é duplicado. Isso permite usar a importação para atualizar dados em massa.
Contatos importados — e agora?
Aprenda a segmentar e exportar sua base de contatos.
Exportar e Gerenciar Listas →