Como preparar um arquivo CSV para importação

Um arquivo limpo deixa as etapas de mapeamento e visualização previsíveis. A maioria dos problemas de importação vem da formatação do arquivo, não do importador. O Teamopipe aceita arquivos .csv, .xls e .xlsx de até 10 MB e lê apenas a primeira planilha.

Use esta estrutura

• Um registro por linha e um campo por coluna.
• Nomes de coluna únicos na primeira linha.
• Sem linhas de título, subtotais, linhas em branco, células mescladas, gráficos ou imagens.
• Substitua as fórmulas pelos valores exibidos.
• Coloque apenas um endereço de e-mail ou número de telefone em cada célula.
• Use datas como 2026-11-15 (AAAA-MM-DD). Evite formatos ambíguos, como 11/12/26.
• Use números simples para valor e probabilidade: 9500 e 55, não R$ 9.500 e 55%.

Use os nomes de coluna do Teamopipe

Nomes exatos reduzem o mapeamento manual. Exemplos atuais:

• Contacts: First name (obrigatório), Last name, Email, Phone, Description.
• Organizations: Organization Name (obrigatório), Website, Description, Assignee Email.
• Deals: Title (obrigatório), Stage Name, Description, Deal value, Currency, Probability to win, Expected close date, Status, Linked contacts.

Os valores de etapa devem corresponder exatamente às etapas do pipeline escolhido. Use um código de moeda, como USD, EUR ou BRL, em vez de um símbolo. O jeito mais fácil de obter os nomes certos é Download template em Configurações → Importar / Exportar.

Limpe os dados

1. Remova linhas duplicadas. Cada linha cria um registro.
2. Filtre valores obrigatórios ausentes.
3. Remova espaços antes e depois de nomes e e-mails.
4. Padronize datas, moedas, números de telefone e valores de status.
5. Confira se seus campos personalizados já existem em Configurações → Campos de dados.
6. Guarde uma cópia de segurança.

Exportar do Google Sheets ou do Excel

No Google Sheets, escolha Arquivo → Fazer download → Valores separados por vírgula (.csv). Se houver várias planilhas, baixe cada uma separadamente. No Excel, você pode enviar o arquivo .xlsx diretamente, mas só a primeira planilha é lida. Se o arquivo se comportar de forma estranha, salve-o como CSV UTF-8 e abra-o em um editor de texto simples para conferir.

Teste com um lote pequeno

Importe primeiro de cinco a dez linhas. Confira os registros, corrija qualquer problema de mapeamento ou formatação e só então importe o arquivo completo. Isso é especialmente útil para campos personalizados e registros vinculados. Na visualização, uma contagem alta de campos não mapeados é um aviso para revisar o mapeamento, não uma prova de que as linhas são inválidas.

Artigos relacionados: importação e exportação de CSV — guia completo, como importar contatos de um arquivo CSV, como importar negócios de um arquivo CSV.

Se tiver problemas, use o chat no canto inferior direito ou o formulário de contato — normalmente respondemos em até 4 horas em dias úteis.