Como Migrar Dados para o Kommo CRM: Guia Completo de Importação Passo a Passo
Por que a migração é um ponto crítico na adoção do CRM
Implementar o Kommo é uma decisão estratégica. Mas existe um momento que determina se a adoção vai se consolidar ou fracassar: a migração dos dados. Times que conseguem mover sua base com qualidade ganham tração imediata — os vendedores encontram os contatos que já conhecem, o histórico está lá, e o CRM começa útil no dia um. Times que migram mal perdem confiança na ferramenta antes mesmo de explorar os recursos.
Na Metrik, já conduzimos dezenas de migrações para o Kommo — de planilhas de Excel, do Pipedrive, do HubSpot, do RD Station e até de sistemas de gestão proprietários. O padrão é sempre o mesmo: a qualidade da migração depende 80% da preparação dos dados e 20% da execução técnica. Quem pula a fase de limpeza e mapeamento paga o preço depois, com uma base suja que compromete toda a operação comercial.
Este guia cobre o processo completo — do diagnóstico da base atual até a validação pós-importação — para que você migre para o Kommo com segurança e sem perder o que construiu.
O que pode ser migrado para o Kommo (e o que não pode)
Antes de começar, é importante entender o escopo real de uma migração. O Kommo suporta importação nativa de:
- Contatos: nome, telefone, e-mail, empresa, cargo e campos personalizados.
- Negócios (Leads/Deals): nome do negócio, valor, etapa do pipeline, responsável, data de criação e campos personalizados.
- Empresas: razão social, CNPJ, segmento, endereço e campos personalizados.
- Tags e etiquetas: vinculadas a contatos ou negócios via campo dedicado no CSV.
O que não migra automaticamente e precisa de abordagem diferente:
- Histórico de conversas do WhatsApp: o Kommo conecta números novos. Históricos do WhatsApp Business ou BSP anterior ficam no aplicativo original.
- Notas e atividades detalhadas: a importação nativa não importa notas textuais. Para isso, é necessário usar a API do Kommo.
- Automações e templates do CRM anterior: precisam ser recriadas no Kommo.
- Arquivos e documentos anexados: devem ser movidos manualmente ou via API.
Conhecer essa distinção antes de começar evita expectativas incorretas e ajuda a planejar o que vai para o CSV e o que exige um tratamento separado.
Passo 1 — Auditar e limpar sua base antes de migrar
Esse é o passo que mais gente pula e mais gente se arrepende. Migrar uma base suja para o CRM é como mudar de casa sem jogar fora o que não presta — você só transporta o caos para um endereço novo.
Antes de exportar qualquer dado, faça uma auditoria da base atual respondendo estas perguntas:
- Existem duplicatas? O mesmo contato cadastrado com nomes ou e-mails diferentes? Use a função de remoção de duplicatas do Excel ou Google Sheets para identificar.
- Os telefones estão padronizados? O Kommo espera o formato internacional: +55 (DDD) número. Misturar formatos gera problemas na integração com WhatsApp.
- Existem contatos sem nenhuma informação útil? Leads sem nome, sem telefone e sem e-mail não têm valor comercial. Elimine-os antes da migração.
- Os campos personalizados que você usa no CRM atual existem no Kommo? Se não, crie-os antes de importar (ver Passo 5).
- Os negócios têm etapa definida? Todo negócio precisa ser vinculado a uma etapa do pipeline. Se a etapa do CRM atual não existe no Kommo, mapeie qual etapa equivalente vai receber esses negócios.
Uma dica prática da Metrik: separe a base em três grupos antes de migrar — ativos (clientes e leads dos últimos 12 meses), arquivados (leads frios com mais de 1 ano) e descartados (inválidos, sem dados suficientes). Migre primeiro os ativos. Os arquivados, só se tiver valor claro em reativar.
Passo 2 — Mapear campos e estruturar o CSV corretamente
O Kommo aceita importação via arquivo CSV. A estrutura do arquivo precisa corresponder exatamente aos campos do Kommo — nativos e personalizados. Um mapeamento incorreto é a causa de 90% das falhas de importação.
O cabeçalho do CSV de contatos geralmente segue este padrão:
- Nome | Sobrenome | Telefone | E-mail | Empresa | Cargo | Tags | [campos personalizados]
Para o CSV de negócios:
- Nome do negócio | Valor | Pipeline | Etapa | Responsável | Contato vinculado | [campos personalizados]
Ao baixar o template de importação diretamente no Kommo (Configurações → Importar → Baixar modelo), você recebe o arquivo com os cabeçalhos exatos que o sistema espera — incluindo os campos personalizados que você criou. Use sempre o template baixado do Kommo, não um CSV genérico.
Atenção especial aos campos de data: o Kommo usa o formato DD/MM/AAAA ou YYYY-MM-DD, dependendo da configuração. Verifique qual o padrão da sua conta antes de preencher. Uma coluna de datas no formato errado faz a importação ignorar esse campo silenciosamente.
Passo 3 — Importar contatos e negócios no Kommo
Com o CSV preparado e os campos personalizados criados, siga este fluxo dentro do Kommo:
- Acesse Configurações → Contatos → Importar (para contatos) ou Negócios → Importar (para deals).
- Faça o upload do arquivo CSV.
- O Kommo exibe uma tela de mapeamento de colunas: associe cada coluna do seu arquivo ao campo correspondente no Kommo. Revise com atenção — esse passo determinará a qualidade da importação.
- Defina o comportamento para duplicatas: o Kommo pode criar novos registros, mesclar com existentes pelo e-mail/telefone ou pular duplicatas. Para uma migração inicial, a opção "Mesclar pelo e-mail" costuma ser a mais segura.
- Confirme a importação e acompanhe o progresso. O Kommo envia um relatório por e-mail ao concluir, informando quantos registros foram importados com sucesso e quais geraram erros.
Importante: para bases com mais de 10.000 registros, divida o CSV em arquivos menores (blocos de 5.000 a 8.000 linhas). Isso facilita a identificação de erros e reduz o tempo de processamento por lote.
Passo 4 — Validar os dados após a importação
A importação concluída não significa que os dados estão corretos. Reserve um tempo para validação antes de liberar o CRM para o time. Checklist básico:
- Amostragem manual: selecione 20 a 30 contatos aleatórios e compare com a planilha original. Campos críticos como telefone e e-mail estão corretos?
- Contagem total: o número de registros importados bate com o total do CSV (descontando os erros informados pelo relatório)?
- Campos personalizados: os valores dos campos personalizados aparecem corretamente no card de cada contato?
- Negócios vinculados aos contatos: os deals aparecem associados ao contato correto?
- Distribuição de etapas do pipeline: os negócios estão nas etapas corretas?
Se encontrar inconsistências, identifique o padrão do erro (campo específico, linha específica) e corrija na origem — no CSV — antes de reimportar o lote com problema. Nunca corrija manualmente registro por registro dentro do CRM se forem mais de 50 itens: vai levar horas e ainda corre risco de inconsistência.
Migrando de CRMs específicos: HubSpot, Pipedrive e RD Station
Cada CRM exporta os dados em formato diferente. Veja os pontos de atenção para os mais comuns:
HubSpot
O HubSpot exporta bem para CSV com muitos campos. O problema é que ele usa nomes de propriedades em inglês (ex: "First Name", "Last Name") que precisam ser renomeados para bater com o template do Kommo. Use o Excel ou Google Sheets para renomear as colunas. Atenção especial ao campo de telefone: o HubSpot armazena o número sem o código de país, exigindo um tratamento em massa para adicionar o +55.
Pipedrive
O Pipedrive exporta contatos e negócios em arquivos separados — o que facilita. Mas o campo "Organização" do Pipedrive vira "Empresa" no Kommo: renomeie o cabeçalho. Se você usa campos personalizados no Pipedrive, verifique se eles foram incluídos na exportação (é necessário selecionar manualmente em "Configurações de exportação").
RD Station
O RD Station exporta contatos com muitos campos de qualificação e comportamento (pontuação de lead, origem, etc.). Mapeie apenas os campos que têm equivalência no Kommo — tentar importar tudo vai gerar um CSV com dezenas de colunas desnecessárias, complicando o mapeamento. Filtre para: nome, telefone, e-mail, empresa, cargo e campos personalizados relevantes.
Configurando campos personalizados antes de importar
Um erro comum é tentar importar dados para campos que ainda não existem no Kommo. O sistema simplesmente ignora esses dados — sem aviso. Antes de fazer o upload do CSV, crie todos os campos personalizados necessários em Configurações → Campos → Adicionar campo.
Tipos de campo suportados no Kommo:
- Texto: para informações livres como observações, setor, referência.
- Número: para valores numéricos como CNPJ, quantidade de funcionários.
- Seleção única / múltipla: para segmentações como tipo de cliente, segmento, origem.
- Data: para campos como data de vencimento do contrato, data de último contato.
- Sim/Não (booleano): para flags como "cliente indicado", "em contrato", "bloqueado para desconto".
Uma vez criados os campos, eles aparecem automaticamente no template de importação quando você o baixa novamente. Essa é a confirmação de que o sistema está pronto para receber os dados.
Erros mais comuns e como evitar
Com base nas migrações que conduzimos na Metrik, esses são os erros que mais aparecem:
- Telefones sem código de país: sem +55, a integração com WhatsApp não funciona. Use uma fórmula no Sheets/Excel para adicionar o prefixo em massa: ="+55"&A2.
- Codificação de caracteres incorreta: o CSV precisa ser salvo em UTF-8 para que acentos e caracteres especiais do português apareçam corretamente. No Excel, use "Salvar como → CSV UTF-8 (com BOM)".
- Vírgulas dentro de campos de texto: um campo de texto com vírgula quebra a estrutura do CSV. Coloque aspas duplas em volta do conteúdo de campos de texto que possam conter vírgulas.
- Nomes de etapas escritos diferente: se o nome da etapa no CSV não for idêntico ao nome da etapa no Kommo (incluindo maiúsculas e acentos), o sistema não associa o negócio corretamente.
- Importar sem criar campos personalizados antes: como mencionado, os dados vão simplesmente desaparecer. Sempre crie os campos antes.
Um processo de migração bem conduzido leva de 1 a 3 dias de trabalho, dependendo do volume e da qualidade da base de origem. Apressar esse processo é a principal causa de retrabalho — e de times que precisam reimportar tudo do zero depois de descobrir problemas que poderiam ter sido evitados com uma hora a mais de preparação.
Conclusão: migração bem feita é a base de um CRM de alta performance
O Kommo é uma ferramenta poderosa, mas só entrega seu potencial quando a base de dados é confiável. Uma migração bem executada significa que no primeiro dia útil após o lançamento, o time já encontra seus contatos, seus negócios ativos e as informações necessárias para trabalhar sem atrito.
Se você quer fazer a migração com apoio técnico — incluindo limpeza de base, configuração de campos personalizados e validação pós-importação — a Metrik oferece implementação completa do Kommo. Veja como configuramos o Kommo do zero para operações comerciais.
Perguntas frequentes
Posso importar o histórico de conversas do WhatsApp para o Kommo?+
Não diretamente pela importação nativa. O histórico de conversas fica armazenado no aplicativo ou BSP anterior. O que você pode fazer é importar o contato com uma nota resumindo as interações anteriores — via CSV de contatos com o campo de observações preenchido, ou adicionando notas manualmente ou via API após a importação.
Qual é o limite de registros para importar de uma vez no Kommo?+
O Kommo não publica um limite fixo, mas na prática recomendamos lotes de até 8.000 registros por importação. Para bases maiores, divida o CSV em múltiplos arquivos. Isso facilita a identificação de erros no relatório de importação e evita timeout durante o processamento.
Como migrar negócios (deals) além de contatos?+
Contatos e negócios são importados por CSVs separados no Kommo. Primeiro importe os contatos, depois os negócios — usando o e-mail ou telefone do contato como campo de vínculo. Certifique-se de que os nomes das etapas do pipeline no CSV são idênticos aos cadastrados no Kommo, incluindo acentuação.
O que acontece se eu importar dados duplicados?+
O Kommo oferece três opções para lidar com duplicatas durante a importação: criar novo registro, mesclar com o existente pelo e-mail ou pelo telefone, ou pular o registro duplicado. Para migrações iniciais, recomendamos mesclar pelo e-mail. Para atualizações parciais de base, pular duplicatas é mais seguro para evitar sobrescrever dados já editados manualmente.
Posso automatizar a importação via API do Kommo?+
Sim. A API do Kommo permite criar e atualizar contatos, negócios e empresas em massa via requisições POST. Isso é especialmente útil para sincronizar bases de dados externas continuamente ou para migrar histórico detalhado (como notas e atividades) que o CSV nativo não suporta. A documentação completa está disponível em developers.kommo.com.
Quanto tempo leva uma migração completa para o Kommo?+
Depende do volume e da qualidade dos dados de origem. Uma base limpa de até 5.000 contatos pode ser migrada em 1 dia de trabalho focado. Bases maiores ou com muita inconsistência (duplicatas, formatos misturados, campos faltantes) podem exigir 2 a 5 dias apenas de preparação do CSV, mais 1 dia para execução e validação.
Trilha completa de Kommo CRM
Guias organizados do fundamento à implementação.
Quer dominar o Kommo CRM na prática?
Conheça a Kommo Academy Brasil: curso de Kommo CRM, aulas ao vivo de segunda a sexta e suporte para implementar no seu projeto real.
Conhecer a Kommo Academy Brasil