Data Migration Guide
Preparando Seus Dados Antes de Migrar Qualquer Coisa
Aqui está o que ninguém conta antes de uma migração de CRM: a própria importação leva algumas horas. A preparação leva dias, às vezes semanas. E as equipes que pulam a preparação são as que estão ligando para você às 23h no dia do cutover perguntando por que 40% dos seus contatos desapareceram.
Uma equipe de RevOps em uma empresa SaaS de médio porte passou três semanas migrando 6.000 contatos do Salesforce para um novo CRM. A primeira tentativa falhou por causa de 1.200 duplicatas. A segunda falhou porque quatro formatos de data diferentes não puderam ser reconciliados. A terceira finalmente funcionou — depois de mais uma semana de limpeza. Todo o problema poderia ter sido evitado com um único dia de trabalho de auditoria pré-migração.
Este guia percorre as sete etapas de preparação que transformam uma migração caótica em uma chata. Você não vai tocar no sistema de destino até a etapa sete. Isso é intencional.
Etapa 1: Execute uma Auditoria de Qualidade de Dados no Seu Sistema de Origem
Antes de exportar uma única linha, você precisa entender o que você realmente tem. A maioria das equipes descobre seus problemas de qualidade de dados durante a migração. As equipes inteligentes os descobrem antes. Se você está nos estágios iniciais de avaliação do sistema para onde vai migrar, o checklist de compra de CRM cobre as perguntas sobre o modelo de dados que você deve fazer antes de se comprometer.
Abra seu CRM de origem e colete estes números:
Contagens de linhas por objeto:
- Total de contatos
- Total de empresas/contas
- Total de negócios/oportunidades (abertos e fechados)
- Total de atividades (ligações, e-mails, notas, tarefas)
Taxas de preenchimento de campos nos seus objetos mais usados. Para contatos, verifique: e-mail, telefone, nome da empresa, cargo, estágio de ciclo de vida, fonte do lead, país. Qualquer campo abaixo de 70% de preenchimento é um problema que vale a pena conhecer agora.
Estimativa de duplicatas. No Salesforce, execute um relatório de contatos agrupados por domínio de e-mail e procure agrupamentos óbvios. No HubSpot, use a ferramenta de Gerenciamento de Duplicatas (Contatos > Ações > Gerenciar Duplicatas). No Pipedrive, exporte para CSV e execute um CONT.SE na coluna de e-mail. Uma estimativa aproximada é suficiente — você não está fazendo merge ainda, apenas contando.
Inconsistência de formato de data. Exporte 50 registros aleatórios e observe seus campos de data. Se você vir uma mistura de MM/DD/AAAA, DD/MM/AAAA, AAAA-MM-DD e strings de texto como "T3 2024", você tem um problema de normalização que vai quebrar o mapeamento de campos mais tarde.
Checklist de Auditoria de Dados
| Verificação | O que medir | Limite aceitável |
|---|---|---|
| Contagem total de registros por objeto | Contagem de linhas | Linha de base para QA pós-migração |
| Preenchimento do campo de e-mail | % de contatos com e-mail válido | >80% |
| Preenchimento do campo de telefone | % de contatos com algum telefone | >60% |
| Preenchimento do nome da empresa | % de contatos vinculados a uma empresa | >75% |
| Preenchimento do estágio de ciclo de vida | % com um estágio definido | >85% |
| Estimativa de duplicatas | % de contatos com e-mail duplicado | <5% antes da limpeza |
| Consistência do formato de data | Contagem de formatos distintos de data | 1 (após normalização) |
| Formato do campo de país | Mistura de nomes completos vs. códigos ISO | Padronizar para um |
Anote seus números. Esta linha de base de auditoria é também o seu alvo de QA pós-migração — após a importação, você verificará se essas contagens correspondem.
Etapa 2: Defina Quais Dados Vale a Pena Migrar
Nem tudo precisa ser transferido. Esta decisão é uma das escolhas de maior alavancagem em todo o processo de migração, e a maioria das equipes nunca a faz explicitamente.
Faça estas perguntas para cada objeto e tipo de registro:
Contatos/Leads: Você precisa de registros que não tiveram nenhuma atividade em 3+ anos? Se seu ciclo de vendas é de 90 dias, um contato sem engajamento desde 2021 não é um prospect — é armazenamento de sobrecarga. Decida uma data de corte.
Atividades históricas: Logs de ligações, threads de e-mail, notas de reunião de três anos atrás. Seus reps realmente os consultam? Para a maioria das equipes, a resposta é não para qualquer coisa com mais de 18 meses. Arquive o sistema de origem em vez de migrar cada nota de 2019.
Negócios/Oportunidades: Negócios fechados-perdidos mais antigos do que seu ciclo de vendas médio × 3 raramente são reabertos. Você pode migrar o registro da empresa, mas pular o registro de negócio de 4 anos atrás.
Objetos customizados: Se você construiu um objeto customizado no Salesforce para um processo que não existe mais, não o migre.
Arquivo vs. migração — uma estrutura simples:
| Idade do registro + atividade | Decisão |
|---|---|
| Ativo ou engajado nos últimos 12 meses | Migrar |
| Sem atividade em 12–24 meses, alto valor (conta enterprise) | Migrar com flag |
| Sem atividade em 12–24 meses, baixo valor | Arquivar na origem |
| Sem atividade há 24+ meses | Arquivar ou excluir |
| Atividades históricas com >18 meses | Arquivar sistema de origem, não migrar |
Documente esta decisão. Você receberá perguntas de reps perguntando onde foram seus dados antigos. Ter uma política escrita evita que essa conversa se torne uma crise.
Etapa 3: Deduplicação Antes da Exportação
Esta é a etapa que a maioria das equipes pula, e é a razão pela qual a maioria das migrações falha. Se você exportar duplicatas, você as importa — e a deduplicação em um novo sistema desconhecido é mais difícil do que no sistema que você conhece.
No Salesforce: Use Regras de Duplicata (Configurações > Gerenciamento de Duplicatas) para executar um relatório. Para merge em massa, a ferramenta nativa lida com isso em lotes, ou use uma ferramenta de terceiros como Dedupely para conjuntos de dados acima de 5.000 contatos.
No HubSpot: Contatos > Ações > Gerenciar Duplicatas. A ferramenta do HubSpot faz a correspondência para você e apresenta pares para revisão. Para bancos de dados grandes, isso pode levar tempo — reserve uma tarde inteira para 10.000+ contatos.
No Pipedrive: A deduplicação nativa do Pipedrive é limitada. Exporte para CSV, execute a deduplicação no Google Sheets ou Excel, depois reimporte. Para correspondência mais sofisticada, execute a exportação pelo Dedupe.io antes da migração.
Estratégia de merge:
- Comece com correspondências exatas de e-mail — estas são seguras para merge automático
- Revise manualmente as correspondências fuzzy de nome + empresa (30 minutos por 1.000 registros é uma estimativa razoável)
- Não faça merge automático de registros onde o nome da empresa difere significativamente — isso geralmente são dois contatos diferentes na mesma empresa
Sempre faça backup antes de fazer merge. Exporte um CSV completo do seu estado atual antes de tocar na ferramenta de Gerenciamento de Duplicatas. Você não consegue desfazer um merge em massa de forma confiável.
Etapa 4: Normalize Campos-Chave
A normalização de campos é tediosa. É também a diferença entre uma importação limpa e 40 tickets de suporte de reps no primeiro dia.
Números de telefone: Escolha o formato E.164 (+5511923456789) como seu padrão alvo. Remova extensões do campo de telefone principal — crie um campo de extensão separado se necessário. Remova todos os caracteres de formatação (parênteses, traços, espaços) para que não quebrem a validação de tipo de campo no destino.
Campos de país: Escolha códigos ISO 3166-1 alpha-2 (BR, US, DE) ou nomes completos, não uma mistura. Se você tiver tanto "Brasil" quanto "BRA" e "BR" no campo de país, eles serão importados como três valores diferentes.
Estágios de ciclo de vida: Este é o que dói. Sistemas de origem frequentemente têm 7 nomes de estágio que precisam ser mapeados para 4 no destino. O mapeamento não pode ser automatizado — você precisa decidir para onde "Lead Qualificado pelo Marketing" e "Lead Qualificado pelo Produto" vão no novo sistema.
Valores de fonte de lead: Mesmo problema. Exporte todos os valores distintos do campo de fonte de lead e mapeie-os para a lista de opções do destino.
Tabela de Referência de Normalização
| Campo | Problemas comuns | Alvo de normalização |
|---|---|---|
| Telefone | Formatos mistos, extensões no campo principal | E.164 (+CC NNNNNNNNNNN) |
| País | Mistura de nome completo / abreviação / ISO | ISO 3166-1 alpha-2 |
| Estágio de ciclo de vida | Mais valores de origem do que de destino | Construir mapa explícito de valores |
| Fonte do lead | Entradas de texto livre vs. valores de lista de opções | Mapear para lista de opções do destino |
| Campos de data | Formatos mistos, strings de texto, nulos | ISO 8601 (AAAA-MM-DD) |
| Moeda | Formatos de localidade mistos ($1.000 vs 1000,00) | Numérico, sem formatação |
| Cargo | Capitalização inconsistente, abreviações | Capitalização de título consistente |
Construa esta tabela antes de abrir um único modelo de importação. Todo campo que não for normalizado antes da exportação se tornará um problema no destino.
Etapa 5: Documente Seu Mapeamento de Campos Antes de Tocar no Destino
O mapeamento de campos é tratado como uma decisão do dia da migração o tempo todo. Isso está errado. Decisões tomadas sob pressão, durante uma execução de importação, produzem erros que você não perceberá até que os reps os encontrem duas semanas depois.
Construa o documento de mapeamento de campos agora, antes de tocar no CRM de destino.
Modelo de Mapeamento de Campos
| Campo de origem | Tipo de origem | Objeto de origem | Campo de destino | Tipo de destino | Objeto de destino | Regra de transformação |
|---|---|---|---|---|---|---|
| Nome | Texto | Contato | Nome | Texto | Contato | Nenhuma |
| Sobrenome | Texto | Contato | Sobrenome | Texto | Contato | Nenhuma |
| Contato | Contato | Converter para minúsculas | ||||
| Telefone | Telefone | Contato | Telefone | Telefone | Contato | Converter para E.164 |
| Estágio de ciclo de vida | Lista de opções | Contato | Estágio de ciclo de vida | Lista de opções | Contato | Ver mapa de valores abaixo |
| Receita Anual | Moeda | Conta | Receita Anual | Número | Empresa | Remover símbolo de moeda |
| Data de Fechamento | Data | Oportunidade | Data de Fechamento | Data | Negócio | Converter para AAAA-MM-DD |
A coluna "Regra de transformação" é a mais importante. Se você a deixar em branco, está planejando tomar essa decisão durante a execução da importação. Não faça isso.
Etapa 6: Decida o que Fazer com Atividades Históricas
Atividades — logs de ligações, threads de e-mail, notas, tarefas — são a decisão de migração mais complicada. Elas também são a parte mais volumosa de qualquer banco de dados de CRM.
As compensações:
Migrar atividades oferece aos reps histórico completo em um só lugar. Mas também aumenta o tempo de importação, os custos de armazenamento no novo sistema e o risco de erros de mapeamento de relacionamento.
Arquivar atividades preserva o histórico sem migrá-lo. Os reps podem abrir o sistema antigo como um arquivo somente leitura por 90 dias pós-cutover se precisarem de contexto histórico.
Orientação prática:
- Migrar todas as atividades dos últimos 12 meses
- Arquivar (não migrar) atividades com mais de 12 meses
- Sempre migrar notas anexadas a negócios ativos — esse é o contexto de alto valor
- Threads de e-mail: migrar apenas os últimos 5 por contato, a menos que o negócio esteja ativo
- Tarefas e lembretes: migrar apenas tarefas abertas. Tarefas concluídas de 2022 adicionam ruído sem valor.
Verifique os custos de armazenamento por registro de atividade do seu CRM de destino antes de decidir. Em alguns sistemas, 500.000 registros de atividade significam um nível de plano significativamente maior.
Etapa 7: Construa uma Amostra de Teste de 100 Registros
Antes de executar qualquer importação — mesmo uma importação de teste — você precisa de uma amostra de teste. São 100–150 registros que representam toda a gama de problemas de qualidade de dados.
Como selecionar a amostra:
- 30 registros limpos com todos os campos preenchidos e sem problemas de formatação
- 20 registros com números de telefone ausentes
- 20 registros com caracteres incomuns nos campos de nome (acentos, hífens, apóstrofos: O'Brien, Müller)
- 15 registros no comprimento máximo de campo (nomes de empresa de 255 caracteres, cargos longos)
- 10 registros com valores de estágio de ciclo de vida ambíguos
- 5 registros que são casos extremos conhecidos no seu conjunto de dados (ex.: contatos sem empresa, negócios sem data de fechamento)
Salve esta amostra como um CSV separado. Ela se torna seu conjunto de QA para a importação shadow — você importará esta amostra de 100 registros primeiro, verificará, e só então prosseguirá para o conjunto de dados completo.
Armadilhas Comuns
Transferir seu problema de deduplicação para o novo sistema. Se você não fizer dedup antes da exportação, está apenas movendo a bagunça. As ferramentas de merge do novo sistema serão desconhecidas e os reps não confiarão no novo CRM desde o primeiro dia.
Tratar o mapeamento de campos como uma decisão do dia da migração. Cada momento de "vamos resolver durante a importação" adiciona 45 minutos de inatividade e aumenta a chance de um erro silencioso — um que importa sem travar, mas coloca os valores errados nos campos errados.
Não documentar regras de transformação. Você vai gastar 3 horas trabalhando a lógica de mapeamento de estágio de ciclo de vida, não documentar em lugar nenhum, e gastar outras 2 horas redeterminando-a três semanas depois quando alguém perguntar por que contatos "Evangelistas" foram importados sem estágio.
Migrar cada atividade histórica sem verificar custos de armazenamento. Uma equipe migrou 800.000 logs históricos de ligações para um novo CRM que cobra por armazenamento. A conta mensal ficou 3x mais alta do que o esperado por seis meses.
Pular a amostra de teste. A primeira importação terá erros. Tudo bem. Mas se a sua primeira importação for de 50.000 contatos em vez de 100 registros de teste, esses erros se multiplicam.
Próximos Passos
Conclua a auditoria de dados antes de agendar a data de migração. Agendar o cutover antes da auditoria é ao contrário — você não sabe quanto tempo a limpeza vai levar até saber o quão ruins os dados estão.
Esta semana:
- Execute o checklist de auditoria de dados e registre seus números de linha de base
- Tome a decisão de migrar vs. arquivar para registros históricos
- Exporte todos os valores distintos de lista de opções dos campos de estágio de ciclo de vida e fonte de lead
- Comece a construir o documento de mapeamento de campos
Uma vez que você tenha seus números de auditoria e o documento de mapeamento de campos iniciado, você está pronto para entrar na limpeza ativa de dados. Isso está coberto no próximo guia.
Saiba Mais

Victor Hoang
Co-Founder
On this page
- Etapa 1: Execute uma Auditoria de Qualidade de Dados no Seu Sistema de Origem
- Checklist de Auditoria de Dados
- Etapa 2: Defina Quais Dados Vale a Pena Migrar
- Etapa 3: Deduplicação Antes da Exportação
- Etapa 4: Normalize Campos-Chave
- Tabela de Referência de Normalização
- Etapa 5: Documente Seu Mapeamento de Campos Antes de Tocar no Destino
- Modelo de Mapeamento de Campos
- Etapa 6: Decida o que Fazer com Atividades Históricas
- Etapa 7: Construa uma Amostra de Teste de 100 Registros
- Armadilhas Comuns
- Próximos Passos
- Saiba Mais