Exportando Corretamente do Pipedrive: Negócios, Contatos e Histórico de Atividades

Um fundador migrou 8.000 negócios do Pipedrive para um novo CRM. A importação terminou limpa. As contagens de linhas correspondiam. Então, seis meses depois, um membro do conselho pediu um relatório de velocidade do Pipeline mostrando quanto tempo os negócios passaram em cada estágio nos últimos dois anos. Os dados não estavam lá. O histórico de estágios dos negócios no Pipedrive, o registro de quando cada negócio passou de um estágio para outro, não está incluído no export padrão. Exige a API ou uma ferramenta de terceiros, e ninguém havia pensado em solicitar.

O histórico de estágios havia desaparecido. O relatório não pôde ser construído. Dois anos de dados de padrões de Pipeline se perderam no momento do export.

Este guia cobre o que o Pipedrive exporta de forma limpa, o que ele deixa de fora silenciosamente e como obter um conjunto de dados completo e pronto para migração antes de sair.

---

Entendendo o Modelo de Dados do Pipedrive

O Pipedrive é construído em torno do Negócio. Todo o resto é secundário.

Na maioria dos CRMs (Salesforce, HubSpot, a maioria das ferramentas modernas), Contatos e Contas são os objetos primários. Negócios (ou Oportunidades) se ligam a eles. No Pipedrive, o Negócio é o registro principal. Pessoas (contatos) e Organizações (empresas) existem principalmente como campos em Negócios. A documentação de API para desenvolvedores do Pipedrive documenta o modelo de objetos completo e os endpoints disponíveis para recuperação do fluxo de negócios e histórico de estágios.

Objetos principais do Pipedrive:

A implicação estrutural: no Pipedrive, o histórico do relacionamento de um vendedor fica no Negócio. Na maioria dos CRMs de destino, o histórico do relacionamento fica no Contato. Essa incompatibilidade é o desafio central de toda migração do Pipedrive e precisa ser resolvida antes ou durante a etapa de limpeza, não após a importação. Mapeamento de campos entre sistemas legados e novos é onde você formaliza essa tradução estrutural antes de começar a limpar.

As Atividades no Pipedrive também se comportam de forma diferente. No Salesforce ou no HubSpot, as atividades são registradas contra um Contato. No Pipedrive, as atividades são registradas contra um Negócio. Quando você migra para um CRM centrado em contatos, cada atividade precisa ser reassociada a um Contato, não apenas deixada vinculada ao Negócio.

---

Etapa 1: Exportar Cada Objeto Separadamente

A ferramenta de export do Pipedrive fica em Configurações > Exportação de dados. Você exporta um objeto por vez.

Caminho de export: Configurações > Exportação de dados > [Escolher objeto]

O que exportar e em qual ordem:

1. Organizações: exporte primeiro (equivalente a Contas; Pessoas fazem referência a elas)
2. Pessoas: exporte em segundo (Contatos; fazem referência a Organizações)
3. Negócios: exporte em terceiro (o objeto primário; faz referência a ambos)
4. Atividades: exporte em quarto (fazem referência a Negócios, Pessoas e Organizações)
5. Notas: exporte em quinto (podem fazer referência a qualquer objeto)

Para cada export:

• Formato CSV: escolha CSV em vez de Excel. O Excel introduz inconsistências de formatação de datas e problemas de codificação que criam dores de cabeça na limpeza.
• Incluir todos os campos: o Pipedrive exporta por padrão um subconjunto de campos. Use o seletor de colunas para incluir todos os campos que você quer. Não confie na seleção padrão.
• Incluir campos personalizados: o Pipedrive lista campos padrão e personalizados juntos no seletor. Certifique-se de que os campos personalizados estejam marcados.

O que cada export contém:

Os exports do Pipedrive fornecem CSVs planos com cada campo selecionado como uma coluna. Exports de Negócios incluem o nome da Pessoa e o nome da Organização como colunas (os relacionamentos são desnormalizados). Mas eles usam nomes, não IDs, para essas referências, o que cria desafios de correspondência durante a importação se os dados tiverem nomes duplicados.

---

Etapa 2: Exportar o Histórico de Estágios dos Negócios

É isso que o export padrão deixa de fora. O histórico de estágios dos negócios, o registro de quando cada negócio passou de um estágio para outro, fica no log de atividades do Pipedrive, não no próprio registro do Negócio. O registro do Negócio armazena apenas o estágio atual.

Por que isso importa:

O histórico de estágios é a base para análise de velocidade do Pipeline (tempo médio em cada estágio), relatórios de taxa de conversão por estágio e qualquer análise histórica de padrões. Sem ele, seu novo CRM começa sem nenhum dado de referência do Pipeline. De acordo com a Harvard Business Review, empresas que analisam sistematicamente os dados de estágios do Pipeline são significativamente mais precisas na previsão de receita. A progressão histórica de estágios costuma ser o dado mais acionável para melhorar as taxas de ganho futuras.

Opções para capturar o histórico de estágios:

Opção A: API do Pipedrive

A API do Pipedrive fornece um endpoint de fluxo de negócios que retorna eventos de mudança de estágio para cada negócio:

GET /api/v1/deals/{id}/flow

Isso retorna um log de todas as atualizações do negócio, incluindo mudanças de estágio com timestamps. Para organizações grandes (milhares de negócios), isso exige chamadas de API scriptadas que percorrem os IDs dos negócios. Se você tiver um recurso técnico disponível, esta é a abordagem mais completa.

Opção B: ferramentas de export de terceiros

Ferramentas como Coupler.io e Hevo Data têm conectores Pipedrive que extraem o histórico de estágios como parte da sincronização. A configuração leva algumas horas e não exige programação de API. Os custos variam, mas geralmente ficam abaixo de US$100/mês para uso em uma migração pontual.

Opção C: documentar e ignorar

Se o histórico de estágios não for operacionalmente importante no CRM de destino, e para muitas equipes pequenas não é, documente a decisão explicitamente, defina a data do export como a linha de base histórica e siga em frente. Não transforme isso em um bloqueio se a necessidade de negócio não justificar. Os registros que você optar por não migrar devem ser colocados em um arquivo planejado: arquivamento de longo prazo de dados legados do CRM cobre as opções de retenção que não exigem manter o Pipedrive licenciado indefinidamente.

---

Etapa 3: Exportar Campos Personalizados Corretamente

Os campos personalizados do Pipedrive são exportados com IDs internos de campo como cabeçalhos de coluna, não os rótulos que você vê na interface. Uma coluna de export pode aparecer como abcdef123456 em vez de "Valor do Contrato". Essa é uma característica conhecida de muitas ferramentas de export de CRM. O artigo da Wikipedia sobre dicionário de dados descreve a prática de documentação de mapeamentos de nome para ID de campos, que é exatamente o que você precisa construir antes de rodar os exports do Pipedrive.

Como obter o mapeamento de rótulos antes do export:

Configurações > Campos de dados > Campos personalizados. Para cada objeto (Negócios, Pessoas, Organizações), o Pipedrive mostra o nome do campo e sua chave interna. Exporte ou faça um screenshot desse mapeamento antes de rodar seus exports: você vai precisar dele durante o mapeamento de campos e a limpeza.

Alternativamente, se você estiver usando Data Loader ou export via API, os rótulos dos campos estão disponíveis via:

GET /api/v1/dealFields: retorna todos os campos de negócio, incluindo nomes e chaves GET /api/v1/personFields: o mesmo para campos de Pessoa GET /api/v1/organizationFields: o mesmo para campos de Organização

Registre o mapeamento de rótulos em uma planilha de referência separada. Mantenha-a junto com seus arquivos de export.

---

Etapa 4: Reconstruir a Hierarquia Conta-Contato-Negócio

Esta é a etapa de tradução estrutural. O modelo Pessoa/Organização/Negócio do Pipedrive precisa ser reformatado no modelo Contato/Conta/Oportunidade usado pela maioria dos CRMs de destino.

O mapeamento:

Os casos de borda:

Pessoas não vinculadas a Organizações. O Pipedrive permite que Pessoas existam sem um vínculo de Organização. Em um CRM de destino com associação de Conta obrigatória em Contatos, essas Pessoas falharão na importação a menos que você crie Contas de substituição ou remova temporariamente a associação obrigatória durante a importação. Identifique esses registros antes de começar a limpeza.

Negócios vinculados a Pessoas mas não a Organizações. Isso é comum em Pipelines transacionais ou de pequenas empresas. Em um modelo centrado em contatos, esses viram Oportunidades vinculadas a um Contato mas sem Conta. Decida com antecedência se vai criar uma Conta para cada uma dessas Pessoas ou aceitar Oportunidades somente com Contato: o CRM de destino pode lidar com isso de forma diferente.

Múltiplas Pessoas em um único Negócio. O Pipedrive suporta adicionar múltiplos contatos a um Negócio. Na maioria dos CSVs de export, apenas a Pessoa principal é exportada. Para capturar todas as associações de contatos, use a API ou verifique se as configurações de export do Pipedrive incluem participantes secundários. Esses registros de negócio com múltiplos contatos são um caso específico onde lidando com atividades históricas, notas e e-mails se cruza com a tradução estrutural: cada Contato no negócio pode ter seu próprio contexto de atividade que vale migrar.

Tabela de referência para mapeamento de objetos:

---

Etapa 5: Validar o Export

Execute essas verificações antes de avançar para a etapa de limpeza.

Validação da contagem de linhas:

Abra os Insights ou as visualizações de lista do Pipedrive para obter a contagem canônica de registros:

Grandes discrepâncias (mais de 2 a 3%) indicam problemas de filtro no export. Causas comuns: export padrão para "meus registros" em vez de todos os registros, ou filtros de ativo/inativo.

Completude dos campos personalizados:

Pegue sua planilha de referência de mapeamento de rótulos (da Etapa 3) e verifique se cada campo personalizado tem uma coluna correspondente no CSV exportado. Colunas ausentes significam que esses campos não foram selecionados durante o export.

Vinculação de Atividade com Negócio:

Escolha 20 Negócios aleatórios. Para cada um, verifique se o export de Atividades contém pelo menos uma linha onde o nome (ou ID) do negócio corresponde. Se Negócios têm atividades na interface do Pipedrive mas nada aparece no export, o export de Atividades tem um problema de filtragem ou de opção de export.

Pessoas não vinculadas a Organizações:

Use uma fórmula de planilha para contar as linhas de Pessoa onde a coluna Organização está em branco. Isso indica quantas Contas de substituição você precisará criar (ou decisões que precisará tomar) antes da importação.

---

O Checklist de Export do Pipedrive

• Organizações exportadas primeiro
• Pessoas exportadas (inclui coluna com nome da Organização)
• Negócios exportados (inclui colunas com nome da Pessoa e nome da Organização)
• Atividades exportadas (inclui coluna com nome do Negócio)
• Notas exportadas para todos os tipos de objeto
• Mapeamento de rótulos dos campos personalizados documentado junto com os arquivos de export
• Histórico de estágios dos negócios capturado (via API, ferramenta de terceiros ou documentado como fora do escopo)
• Contagens de linhas validadas contra as visualizações de lista do Pipedrive para todos os objetos
• Pessoas sem vínculos de Organização identificadas e contadas
• Vinculação Atividade-Negócio verificada em amostra de 20 negócios aleatórios

---

Armadilhas Comuns

Perder os motivos de ganho/perda dos negócios. O Pipedrive armazena os motivos de ganho/perda como um campo separado que nem sempre aparece nas colunas de export padrão. Adicione "Motivo de ganho/perda" explicitamente à seleção de campos do export de Negócios. Ele está lá, apenas não selecionado por padrão.

Notas perdidas vinculadas a Atividades versus Negócios. As Notas no Pipedrive podem estar vinculadas a Negócios, Pessoas ou Atividades de forma independente. O export de Notas deve incluir uma coluna de "tipo vinculado" e uma coluna de "ID vinculado" para que você possa reconstruir a quais objetos as notas pertencem após a importação.

Esquecer o histórico de integração de e-mail. Se sua equipe usou o recurso de sincronização de e-mail do Pipedrive, esses e-mails ficam na timeline do Negócio mas podem não ser exportados pelas ferramentas padrão. Verifique o endpoint de fluxo de negócios da API se o histórico de e-mails for importante para a migração.

Pessoas duplicadas para o mesmo contato. O Pipedrive não impõe unicidade de e-mail em Pessoas por padrão. Equipes que adicionam Pessoas manualmente ao longo dos anos acumulam duplicatas com nomes ligeiramente diferentes ou o mesmo e-mail. A pesquisa da Deloitte sobre gestão de qualidade de dados identifica registros duplicados como o problema de qualidade de dados mais comum e custoso em sistemas de CRM, com custos de resolução que crescem significativamente quanto mais tempo as duplicatas ficam sem tratamento. Rode uma deduplicação nos e-mails de Pessoas antes de limpar. O processo completo de deduplicação está em limpeza de dados: deduplicação, normalização e enriquecimento.

---

O Que Fazer a Seguir

Seu export do Pipedrive fornece os dados brutos. Mas o modelo de dados precisa ser traduzido: Pessoa/Organização para Contato/Conta: antes de estar pronto para limpar e importar.

O próximo passo é mapeamento de campos entre sistemas legados e novos. É onde você formaliza o mapa de campos Pipedrive para CRM de destino e lida com a tradução estrutural de centrado em negócios para centrado em contas.

Antes de começar a limpeza, também prepare seus dados antes de migrar qualquer coisa se você ainda não definiu seu escopo, tipos de registros e padrões de qualidade de dados.

Em seguida, limpeza de dados: deduplicação, normalização e enriquecimento cobre o trabalho real de limpeza depois que o export e o mapeamento estiverem sólidos.

---

Saiba Mais

• Preparando seus dados antes de migrar qualquer coisa
• Mapeamento de campos entre sistemas legados e novos
• Limpeza de dados: deduplicação, normalização, enriquecimento
• Lidando com atividades históricas, notas e e-mails
• Estágios do Pipeline que correspondem ao seu processo real de vendas
• Rework vs. Pipedrive: comparação de CRM para equipes de vendas em crescimento