Testando a Migração com uma Importação Shadow

Uma importação shadow é a diferença entre "encontramos 3 erros de mapeamento no sandbox" e "encontramos 3 erros de mapeamento no dia do cutover com 30 reps esperando." Leva 2 a 3 horas para ser executada corretamente. Previne o tipo de problemas que atrasam o go-live em uma semana.

Uma equipe de migração pulou a importação shadow porque já havia testado em uma planilha. Verificou se o mapeamento de campos parecia correto no Excel, confirmou que os valores da lista de opções estavam alinhados e se sentiu confiante. No dia do cutover, descobriram que os campos de relacionamento entre Contatos e Negócios não resolveram — a ferramenta de importação tratou pesquisas de associação de forma diferente do que a comparação de planilha havia sugerido. Cada negócio no sistema ficou sem contatos. O cutover foi adiado por cinco dias enquanto resolviam as associações manualmente.

Uma importação shadow em um sandbox real teria identificado isso nos primeiros 10 minutos.

Este guia percorre o processo completo de importação shadow: configuração, seleção do conjunto de dados de teste, a própria execução da importação, verificação de QA e os critérios de aprovação que liberam para o cutover.

Etapa 1: Configure um Sandbox ou Ambiente de Teste

Você precisa de uma instância real do CRM de destino — não uma comparação de planilha, não uma verificação visual lado a lado. O objetivo é executar suas ferramentas de importação reais em um ambiente de CRM real e ver o que acontece.

HubSpot: As contas sandbox do HubSpot estão disponíveis nos planos Professional e Enterprise. Acesse Configurações > Gerenciamento de Conta > Sandboxes. Crie um sandbox e configure as mesmas propriedades customizadas, estágios de pipeline e definições de estágio de ciclo de vida que existem na sua conta de produção. O sandbox deve espelhar a configuração de produção — caso contrário, você está testando em uma configuração diferente da que vai usar no dia do cutover.

Salesforce: O Salesforce tem múltiplos tipos de sandbox. Para teste de migração, um sandbox Developer é suficiente — tem a mesma configuração (objetos, campos, valores de lista de opções) que a produção. Configuração > Ambientes > Sandboxes > Novo Sandbox.

Pipedrive: O Pipedrive não tem sandbox nativo. Crie uma conta de avaliação gratuita com um endereço de e-mail diferente. Configure para corresponder aos estágios de pipeline de produção e campos customizados.

Zoho CRM: O Zoho tem um ambiente sandbox disponível em Configuração > Developer Space > Sandbox.

Quando um sandbox não está disponível:

Crie uma nova conta de produção com nome de empresa de teste e e-mail de administrador dedicado
Use uma tag de importação claramente rotulada ("IMPORTAÇÃO TESTE - EXCLUIR") em todos os registros de teste
Após os testes, exclua todos os registros com essa tag antes do cutover

O sandbox deve ter:

Todos os campos customizados criados e configurados (mesmo tipo, mesmos valores de lista de opções que a produção)
Estágios de pipeline e estágios de ciclo de vida definidos para corresponder à sua configuração de destino
Contas de usuário configuradas se você estiver testando campos de atribuição de usuário
Webhooks de integração desabilitados — você não quer que importações de teste disparem notificações reais

Etapa 2: Prepare um Conjunto de Dados de Teste Representativo

O conjunto de dados de teste é onde a maioria das importações shadow fica aquém. Equipes usam 50 registros limpos e bem formatados e concluem que a migração funciona. Então o conjunto de dados completo inclui 40 registros com caracteres acentuados, 200 com campos de relacionamento nulos e 15 com notas contendo tags HTML — e a importação completa quebra de formas que o teste não previu.

Tamanho alvo: 500–1.000 registros. Grande o suficiente para expor casos extremos, mas pequeno o suficiente para verificar manualmente.

Critérios de Seleção do Conjunto de Dados de Teste

Construa seu conjunto de dados incluindo deliberadamente registros problemáticos, não apenas registros limpos:

Categoria	Contagem de registros	O que testar
Registros limpos, totalmente preenchidos	150	Linha de base — todos os campos presentes, formatação padrão
Número de telefone ausente	60	Tratamento de nulo no campo de telefone
E-mail ausente	40	Como nulos em campos obrigatórios são tratados
Caracteres incomuns em campos de nome	50	O'Brien, Müller, José, Li Wei, nomes compostos
Comprimento máximo de campo	30	Nomes de empresa de 255 caracteres, notas longas, URLs de comprimento máximo
Candidatos a duplicata (2 contatos, mesmo e-mail)	20	Como a ferramenta de importação trata duplicatas
Contatos sem associação de empresa	30	Contatos independentes sem links de Conta/Empresa
Contatos associados a múltiplos negócios	30	Registros de relacionamento com múltiplas associações
Registros com HTML em campos de notas ou descrição	20	Renderização de campo de nota no destino
Registros com as datas mais antigas no conjunto de dados	20	Casos extremos de formatação de campo de data
Registros de cada valor de estágio de ciclo de vida	1 por valor	Cobertura de mapeamento de lista de opções
Registros de cada valor de fonte de lead	1 por valor	Cobertura de mapeamento de lista de opções
Total	~500

Exporte este conjunto especificamente — não pegue apenas as primeiras 500 linhas. As primeiras 500 linhas geralmente são os registros criados mais recentemente, que tipicamente são mais limpos do que os mais antigos. Você quer a bagunça no seu conjunto de dados de teste.

Etapa 3: Execute a Importação com Suas Ferramentas Exatas

Isso é crítico: use a mesma ferramenta de importação, o mesmo arquivo de mapeamento de campos e as mesmas regras de transformação que você usará no dia do cutover. Se você usar um método diferente para a importação de teste, está testando um processo diferente.

Ferramentas de importação comuns por combinação de origem/destino:

HubSpot → Outro CRM: Exportação CSV nativa + importação CSV do CRM de destino, ou uma ferramenta de migração como o assistente de importação nativo do HubSpot para objetos planos
Salesforce → Outro CRM: Salesforce Data Loader (gratuito, ferramenta própria do Salesforce) para exportações CSV, ou uma ferramenta de migração específica
Pipedrive → Outro CRM: Exportação CSV nativa + assistente de importação do destino
Qualquer → Qualquer: Ferramentas de migração de terceiros como Trujay, Migrate.io ou Import2 lidam com a resolução de relacionamentos automaticamente

Ordem de importação (isso importa):

Empresas / Contas primeiro
Contatos em segundo (para que as associações de empresa possam ser resolvidas)
Negócios / Oportunidades em terceiro (as associações de contato devem existir)
Atividades por último (as associações de negócio e contato devem existir)

Execute a importação nesta ordem mesmo para o teste. Desviar da ordem é uma das causas mais comuns de campos de relacionamento quebrados.

Observe o log de importação em tempo real. Não se afaste e volte depois. O log mostrará erros de validação de campo, falhas de conversão de tipo e registros ignorados.

Etapa 4: Checklist de QA Pós-Importação

Após a conclusão da importação, não assuma que funcionou porque terminou sem erros. Siga este checklist sistematicamente.

Checklist de QA Pós-Importação

Verificação de contagem de registros:

Total de contatos importados corresponde à contagem esperada (linha de base menos qualquer omissão intencional)
Total de empresas importadas corresponde à contagem esperada
Total de negócios importados corresponde à contagem esperada
Contagem de erros de importação corresponde ao log de erros (sem omissões silenciosas)

Correção de tipo de campo:

Campos de data exibem como datas (não strings de texto, não Unix timestamps)
Campos de número (Receita Anual, valor do negócio) exibem como números, não texto
Campos de moeda formatam corretamente no destino
Campos de telefone exibem em formato consistente
Campos de checkbox são Verdadeiro/Falso

Mapeamento de valor de lista de opções:

Todos os valores de estágio de ciclo de vida mapeiam para valores válidos de destino (sem estágios de ciclo de vida em branco)
Valores de fonte de lead mapeiam corretamente
Valores de estágio de negócio mapeiam corretamente
Todos os campos de lista de opções customizados mapeiam corretamente

Integridade de relacionamento:

Abra 20 registros de contato e verifique se a associação de empresa está correta
Abra 10 registros de negócio e verifique se a associação de contato está correta
Verifique que pelo menos 3 registros de negócio têm o proprietário do negócio atribuído corretamente
Para qualquer registro com múltiplas associações, verifique se todas as associações estão presentes

Resultados de campos de fórmula e calculados:

Se o CRM de destino calcula campos, verifique 5 registros quanto a valores plausíveis

Verificação de gatilho de automação:

Verifique que os registros de importação de teste não dispararam fluxos de trabalho/sequências ativos

Registre cada falha. Uma verificação de QA que "funciona na maioria" não é uma aprovação — cada falha é um defeito no seu documento de mapeamento de campos que afetará a importação completa.

Etapa 5: Teste os Três Relatórios Mais Usados

A verificação em nível de campo detecta erros de registro individuais. A verificação de relatório detecta problemas de mapeamento sistêmico que só aparecem quando os dados são agregados.

Identifique seus três relatórios mais usados:

Geralmente: visão geral do pipeline por estágio, contatos por estágio de ciclo de vida e negócios criados este mês

Para cada relatório:

Execute o mesmo relatório no sistema de origem na sua amostra de 500 registros de teste
Execute o mesmo relatório (filtrado para registros importados) no destino
Compare os números

As contagens devem corresponder. Se seu sistema de origem mostra 85 contatos SQL na amostra de teste e o destino mostra 79, você tem um erro de mapeamento de estágio de ciclo de vida afetando 6 registros.

Incompatibilidades comuns em nível de relatório e suas causas:

Diferença de contagem em um estágio de ciclo de vida: Valor de lista de opções que não mapeou corretamente
Totais de receita errados: Campo de moeda importado como texto (não somando corretamente)
Filtros baseados em data retornando registros errados: Formato de data importado incorretamente
Relatórios de proprietário vazios: Atribuição de usuário não resolvida

Etapa 6: Peça para um Rep Testar Cinco Registros de Ponta a Ponta

O QA técnico encontra erros técnicos. Os reps encontram erros de usabilidade — os campos que parecem corretos no log de importação, mas se sentem errados quando você está tentando trabalhar um negócio.

Escolha um rep que conhece bem os dados de origem. Dê a eles os IDs de registro de cinco contatos e peça para eles:

Encontrar o registro no novo sistema
Verificar se as informações parecem corretas — empresa, cargo, telefone, e-mail, estágio de ciclo de vida
Verificar o histórico de atividades para esses contatos
Abrir quaisquer negócios associados e verificar as informações do negócio
Reportar qualquer coisa que pareça errada ou ausente

Não dê a eles um checklist de QA. A reação não guiada deles à qualidade dos dados é mais valiosa do que uma verificação estruturada.

Etapa 7: Documente Cada Erro e Corrija Antes do Cutover

Após o QA, você terá uma lista de erros. Cada erro tem uma de duas causas:

Um erro no documento de mapeamento de campos
Um caso extremo nos dados que o documento de mapeamento não considerou

Ambos precisam ser corrigidos no documento de mapeamento antes do cutover. Não corrija erros editando manualmente registros no destino — isso corrige 3 registros e deixa a causa raiz para os 47.000 restantes.

Para cada erro:

Identifique a causa raiz: regra de transformação errada, tratamento de tipo errado, mapeamento de lista de opções errado
Atualize o documento de mapeamento
Execute novamente os registros de teste afetados pelo processo corrigido
Verifique se a saída está correta

Checklist de Aprovação Antes de Agendar o Cutover

Não agende o cutover até que cada item desta lista esteja completo:

Verificação de dados:

Contagem de registros na importação de teste corresponde à contagem esperada dentro de 0,5%
Zero erros de tipo de campo não resolvidos no log de importação
Taxa de nulo de estágio de ciclo de vida < 1% dos registros importados
Todos os campos de relacionamento resolvem corretamente (sem contatos ou negócios sem referência)

Verificação de relatório:

Todos os três relatórios-chave correspondem às contagens do sistema de origem dentro de 2%
Totais de receita/moeda correspondem à origem dentro de 0,1%
Filtros baseados em data retornam conjuntos de registros corretos

Aprovação de stakeholders:

QA do rep concluído — pelo menos um rep testou 5+ registros e confirmou que os dados parecem corretos
A liderança de vendas viu os relatórios-chave e confirmou que parecem corretos
TI/admin verificou o acesso do usuário e a configuração de permissões

Prontidão do processo:

Documento de mapeamento de campos finalizado
Sequência de importação documentada
Plano de rollback documentado
Comunicação de cutover redigida

Não agende o cutover até que cada caixa esteja marcada.

Armadilhas Comuns

Testar com poucos registros para expor casos extremos. Um teste de 50 registros com dados limpos passará no QA e ainda falhará na importação completa quando atingir os 200 registros com HTML no campo de notas.

Não testar relacionamentos — apenas campos planos de contato. O QA de campo de contato é a parte fácil. O QA de relacionamento é onde as migrações quebram.

Pular a etapa de QA do rep. Usuários técnicos verificam se os campos estão corretos. Os reps verificam se os dados são utilizáveis. Esses são padrões diferentes.

Corrigir erros no destino em vez de no documento de mapeamento. Você encontra 5 registros com estágio de ciclo de vida em branco, os define manualmente para "SQL" no destino e segue em frente. No dia do cutover, 500 registros importam com estágios de ciclo de vida em branco. Corrija a causa raiz no documento de mapeamento.

Próximos Passos

Agende a importação shadow pelo menos 5 dias úteis antes do seu cutover planejado. Esse buffer dá tempo para corrigir erros, executar novamente a importação de teste se necessário, e obter aprovação dos stakeholders sem pressa.

Uma vez que a lista de aprovação esteja completa, você está pronto para agendar o cutover e preparar o playbook do dia da migração. Esse processo está coberto no guia de dia de cutover.

Data Migration Guide