Cómo exportar limpiamente desde Pipedrive: negocios, contactos e historial de actividades

Un fundador migró 8.000 negocios de Pipedrive a un nuevo CRM. La importación salió limpia. Los recuentos de filas coincidieron. Luego, seis meses después, un miembro de la junta pidió un informe de velocidad del Pipeline que mostrara cuánto tiempo habían pasado los negocios en cada etapa durante los dos años anteriores. Los datos no estaban. El historial de etapas de los negocios de Pipedrive (el registro de cuándo cada negocio pasó de una etapa a otra) no se incluye en la exportación estándar. Requiere la API o una herramienta de terceros, y nadie había sabido que debía solicitarlo.

El historial de etapas había desaparecido. El informe no podía construirse. Dos años de datos de patrones del Pipeline desaparecieron en el momento de la exportación.

Esta guía cubre qué exporta limpiamente Pipedrive, qué omite en silencio y cómo obtener un conjunto de datos completo y listo para la migración antes de salir.

---

El modelo de datos de Pipedrive

Pipedrive está construido alrededor del Negocio. Todo lo demás es secundario.

En la mayoría de los CRM (Salesforce, HubSpot, la mayoría de las herramientas modernas), los Contactos y las Cuentas son los objetos principales. Los Negocios (u Oportunidades) se vinculan a ellos. En Pipedrive, el Negocio es el registro principal. Las Personas (contactos) y las Organizaciones (empresas) existen principalmente como campos en los Negocios. La documentación para desarrolladores de la API de Pipedrive documenta el modelo de objetos completo y los endpoints disponibles para la recuperación del flujo de negocios y el historial de etapas.

Objetos principales de Pipedrive:

La implicación estructural: en Pipedrive, el historial de relaciones de un vendedor vive en el Negocio. En la mayoría de los CRM de destino, el historial de relaciones vive en el Contacto. Esta discrepancia es el desafío central de cada migración de Pipedrive y debe resolverse antes o durante el paso de limpieza, no después de la importación. El mapeo de campos entre sistemas heredados y nuevos es donde se formaliza esta traducción estructural antes de que comience la limpieza.

Las Actividades en Pipedrive también se comportan de forma diferente. En Salesforce o HubSpot, las actividades se registran contra un Contacto. En Pipedrive, las actividades se registran contra un Negocio. Al pasar a un CRM centrado en contactos, cada actividad debe reasociarse con un Contacto, no solo dejarse vinculada al Negocio.

---

Paso 1: exportar cada objeto por separado

La herramienta de exportación de Pipedrive está en Configuración > Exportación de datos. Usted exporta un objeto a la vez.

Ruta de exportación: Configuración > Exportación de datos > [Elegir objeto]

Qué exportar y en qué orden:

1. Organizaciones: exporte primero (equivalente a Cuentas; las Personas las referencian)
2. Personas: exporte segundo (Contactos; referencian Organizaciones)
3. Negocios: exporte tercero (el objeto principal; referencia ambos)
4. Actividades: exporte cuarto (referencian Negocios, Personas y Organizaciones)
5. Notas: exporte quinto (pueden referenciar cualquier objeto)

Para cada exportación:

• Formato CSV: elija CSV sobre Excel. Excel introduce inconsistencias de formato de fecha y problemas de codificación que generan dolores de cabeza en la limpieza.
• Incluir todos los campos: Pipedrive exporta por defecto un subconjunto de campos. Use el selector de columnas para incluir cada campo que desee. No confíe en la selección predeterminada.
• Incluir campos personalizados: Pipedrive lista los campos estándar y personalizados juntos en el selector. Asegúrese de que los campos personalizados estén seleccionados.

Qué contiene cada exportación:

Las exportaciones de Pipedrive le entregan archivos CSV planos con cada campo seleccionado como columna. Las exportaciones de Negocios incluyen el nombre de la Persona y el nombre de la Organización como columnas (las relaciones están desnormalizadas). Pero usan nombres, no IDs, para esas referencias, lo que genera desafíos de coincidencia durante la importación si sus datos tienen nombres duplicados.

---

Paso 2: exportar el historial de etapas de los negocios

Esto es lo que la exportación estándar omite. El historial de etapas de los negocios (el registro de cuándo cada negocio pasó de una etapa del Pipeline a otra) vive en el registro de actividad de Pipedrive, no en el registro del Negocio en sí. El registro del Negocio solo almacena la etapa actual.

Por qué importa:

El historial de etapas es la base para el análisis de velocidad del Pipeline (tiempo promedio en cada etapa), informes de tasa de conversión por etapa y cualquier análisis de patrones históricos. Sin él, su nuevo CRM comienza sin datos de referencia del Pipeline. Según Harvard Business Review, las empresas que analizan sistemáticamente los datos de etapas del Pipeline son significativamente más precisas en la previsión de ingresos; la progresión histórica de etapas suele ser el dato más accionable para mejorar las tasas de cierre futuras.

Opciones para capturar el historial de etapas:

Opción A: API de Pipedrive

La API de Pipedrive proporciona un endpoint de flujo de negocios que devuelve los eventos de cambio de etapa para cada negocio:

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

Esto devuelve un registro de todas las actualizaciones del negocio, incluyendo los cambios de etapa con marcas de tiempo. Para organizaciones grandes (miles de negocios), esto requiere llamadas a la API mediante scripts que recorren los IDs de los negocios. Si cuenta con un recurso técnico, este es el enfoque más completo.

Opción B: herramientas de exportación de terceros

Herramientas como Coupler.io y Hevo Data tienen conectores de Pipedrive que extraen el historial de etapas de los negocios como parte de su sincronización. La configuración tarda unas horas y no requiere programación con API. Los costos varían, pero generalmente son inferiores a 100 USD al mes para un uso de migración de una sola vez.

Opción C: documentar y omitir

Si el historial de etapas no es operativamente importante en el CRM de destino (y para muchos equipos pequeños no lo es), documente la decisión explícitamente, establezca la fecha de exportación como línea de base histórica y continúe. No permita que esto sea un bloqueo si la necesidad de negocio no lo justifica. Los registros que decida no migrar pertenecen a un archivo planificado; el archivado a largo plazo de los datos del CRM heredado cubre las opciones de retención que no requieren mantener Pipedrive con licencia indefinidamente.

---

Paso 3: exportar los campos personalizados correctamente

Los campos personalizados de Pipedrive se exportan con IDs de campo internos como encabezados de columna, no con las etiquetas que ve en la interfaz. Una columna de exportación puede aparecer como abcdef123456 en lugar de "Valor del contrato". Esta es una característica conocida de muchas herramientas de exportación de CRM. El artículo de Wikipedia sobre diccionario de datos describe la práctica de documentación para mantener mapeos de nombre de campo a ID, que es exactamente lo que necesita construir antes de ejecutar las exportaciones de Pipedrive.

Cómo obtener el mapeo de etiquetas antes de exportar:

Configuración > Campos de datos > Campos personalizados. Para cada objeto (Negocios, Personas, Organizaciones), Pipedrive muestra el nombre del campo y su clave interna. Exporte o tome capturas de pantalla de este mapeo antes de ejecutar sus exportaciones: lo necesitará durante el mapeo de campos y la limpieza.

Alternativamente, si usa Data Loader o exportación por API, las etiquetas de campo están disponibles a través de:

GET /api/v1/dealFields: devuelve todos los campos de negocios incluyendo nombres y claves GET /api/v1/personFields: lo mismo para campos de Personas GET /api/v1/organizationFields: lo mismo para campos de Organizaciones

Escriba el mapeo de etiquetas en una hoja de cálculo de referencia separada. Consérvela junto a sus archivos de exportación.

---

Paso 4: reconstruir la jerarquía Cuenta-Contacto-Negocio

Este es el paso de traducción estructural. El modelo Persona/Organización/Negocio de Pipedrive debe reformatearse al modelo Contacto/Cuenta/Oportunidad que usa la mayoría de los CRM de destino.

El mapeo:

Los casos límite:

Personas no vinculadas a Organizaciones. Pipedrive permite que existan Personas sin un vínculo de Organización. En un CRM de destino con asociación de Cuenta obligatoria en los Contactos, estas Personas fallarán en la importación a menos que cree Cuentas de marcador de posición o elimine temporalmente la asociación obligatoria durante la importación. Identifique estos registros antes de que comience la limpieza.

Negocios vinculados a Personas pero no a Organizaciones. Esto es frecuente en Pipelines transaccionales o de pequeñas empresas. En un modelo centrado en Contactos, estos se convierten en Oportunidades vinculadas a un Contacto pero sin Cuenta. Decida de antemano si crear una Cuenta para cada una de estas Personas o aceptar Oportunidades con solo Contacto; el CRM de destino puede manejar esto de forma diferente.

Múltiples Personas en un Negocio. Pipedrive admite añadir múltiples contactos a un Negocio. En la mayoría de los CSV de exportación, solo se exporta la Persona principal. Para capturar todas las asociaciones de contactos, use la API o verifique si la configuración de exportación de Pipedrive incluye participantes secundarios. Estos registros de negocios con múltiples contactos son un caso específico donde la gestión de actividades históricas, notas y correos electrónicos se intersecta con la traducción estructural: cada Contacto en el negocio puede tener su propio contexto de actividad que vale la pena migrar.

Tabla de referencia para el mapeo de objetos:

---

Paso 5: validar la exportación

Ejecute estas verificaciones antes de pasar al paso de limpieza.

Validación del recuento de filas:

Abra los Informes o las vistas de lista de Pipedrive para obtener el recuento de registros canónico:

Las discrepancias grandes (más del 2-3 %) indican problemas de filtrado en la exportación. Causas comunes: la exportación predeterminada a "mis registros" en lugar de todos los registros, o filtros de activo/inactivo.

Integridad de campos personalizados:

Tome su referencia de mapeo de etiquetas (del Paso 3) y verifique que cada campo personalizado tenga una columna correspondiente en el CSV de exportación. Las columnas faltantes significan que esos campos no se seleccionaron durante la exportación.

Vinculación de actividades a negocios:

Seleccione 20 Negocios al azar. Para cada uno, verifique que su exportación de Actividades contenga al menos una fila donde el nombre del negocio (o el ID del negocio) coincida. Si los Negocios tienen actividades en la interfaz de Pipedrive pero nada aparece en la exportación, su exportación de Actividades tiene un problema de filtrado u opciones de exportación.

Personas no vinculadas a Organizaciones:

Use una fórmula en la hoja de cálculo para contar las filas de Personas donde la columna Organización está en blanco. Esto le indica cuántas Cuentas de marcador de posición deberá crear (o cuántas decisiones deberá tomar) antes de la importación.

---

Lista de verificación de exportación de Pipedrive

• Organizaciones exportadas primero
• Personas exportadas (incluye columna con nombre de Organización)
• Negocios exportados (incluye columnas con nombre de Persona y nombre de Organización)
• Actividades exportadas (incluye columna con nombre del Negocio)
• Notas exportadas para todos los tipos de objetos
• Mapeo de etiquetas de campos personalizados documentado junto a los archivos de exportación
• Historial de etapas de los negocios capturado (por API, herramienta de terceros, o documentado como fuera de alcance)
• Recuentos de filas validados contra las vistas de lista de Pipedrive para todos los objetos
• Personas sin vínculo de Organización identificadas y contadas
• Vinculación de actividades a negocios verificada en muestra de 20 negocios al azar

---

Errores comunes

Perder los motivos de negocios ganados/perdidos. Pipedrive almacena los motivos de ganado/perdido como un campo separado que no siempre aparece en las columnas de exportación estándar. Agregue "Motivo de ganado/perdido" explícitamente a la selección de campos de exportación de Negocios. Está disponible; solo que no está seleccionado por defecto.

No capturar las notas adjuntas a Actividades frente a Negocios. Las notas en Pipedrive pueden adjuntarse de forma independiente a Negocios, Personas o Actividades. Su exportación de Notas debe incluir una columna "tipo de vínculo" y "ID de vínculo" para que pueda reconstruir a qué notas pertenecen dónde después de la importación.

Olvidar el historial de la integración de correo electrónico. Si su equipo usó la función de sincronización de correo de Pipedrive, esos correos viven en el historial del Negocio pero pueden no exportarse mediante las herramientas estándar. Verifique el endpoint de flujo del negocio de la API si el historial de correos importa para la migración.

Duplicados de Personas para el mismo contacto. Pipedrive no impone la unicidad del correo electrónico en las Personas de forma predeterminada. Los equipos que añaden Personas manualmente a lo largo de los años acumulan duplicados con nombres ligeramente distintos o el mismo correo. La investigación de Deloitte sobre gestión de la calidad de los datos identifica los registros duplicados como el problema de calidad de datos más frecuente y costoso en los sistemas CRM, con costos de resolución que se multiplican de forma significativa cuanto más tiempo permanecen sin resolver los duplicados. Ejecute un proceso de deduplicación en el correo electrónico de las Personas antes de limpiar. El proceso completo de deduplicación está cubierto en limpieza de datos: deduplicación, normalización y enriquecimiento.

---

Qué hacer a continuación

Su exportación de Pipedrive le entrega los datos en bruto. Pero el modelo de datos necesita traducirse (de Persona/Organización a Contacto/Cuenta) antes de estar listo para limpiar e importar.

El siguiente paso es el mapeo de campos entre sistemas heredados y nuevos. Allí se formaliza el mapa de campos de Pipedrive al CRM de destino y se gestiona la traducción estructural del modelo centrado en negocios al centrado en cuentas.

Antes de que comience la limpieza, también prepare sus datos antes de migrar cualquier cosa si aún no ha definido su alcance, tipos de registros y estándares de calidad de datos.

Luego, limpieza de datos: deduplicación, normalización y enriquecimiento cubre el trabajo real de limpieza una vez que la exportación y el mapeo son sólidos.

---

Más información

• Preparar sus datos antes de migrar cualquier cosa
• Mapeo de campos entre sistemas heredados y nuevos
• Limpieza de datos: deduplicación, normalización, enriquecimiento
• Gestión de actividades históricas, notas y correos electrónicos
• Etapas del Pipeline que coinciden con su movimiento real de ventas
• Rework vs. Pipedrive: comparación de CRM para equipos de ventas en crecimiento