Cómo exportar limpiamente desde HubSpot: lo que la exportación nativa omite

Un equipo de RevOps ejecutó una migración de manual. Cuarenta mil contactos exportados limpiamente, empresas emparejadas, etapas de negocios mapeadas correctamente. En el primer día en el nuevo CRM, los representantes abrieron sus registros de negocios y no encontraron ningún contacto adjunto. Ni un solo vínculo entre negocio y contacto había sobrevivido a la migración.

El culpable fue la exportación nativa de HubSpot. Esta exporta Contactos. Exporta Empresas. Exporta Negocios. Pero no exporta las asociaciones entre ellos. Estas viven en una capa de datos separada que la herramienta de exportación estándar no toca. El equipo de ventas perdió el contexto del Pipeline desde el primer día porque nadie sabía que debía preguntar sobre las asociaciones.

Esta guía cubre todo lo que la exportación desde la interfaz deja atrás y cómo obtenerlo antes de migrar.

---

Cómo está organizada la información en HubSpot

HubSpot organiza los datos en objetos y asociaciones. Comprender ambos es lo que diferencia una exportación completa de una defectuosa.

Objetos:

• Contactos: personas individuales
• Empresas: organizaciones (el equivalente de Cuentas en HubSpot)
• Negocios: oportunidades de ventas en un Pipeline
• Tickets: registros de soporte o servicio
• Objetos personalizados: cualquier cosa que su portal haya construido más allá de los cuatro estándar

Las asociaciones son una capa de datos separada. Un Contacto puede estar asociado simultáneamente con una Empresa, un Negocio y un Ticket. Pero ninguno de esos vínculos vive dentro del propio registro de Contacto. Se almacenan en el grafo de asociaciones de HubSpot. Cuando exporta un Contacto a CSV, las asociaciones no se incluyen. La documentación de la API de Asociaciones de HubSpot CRM explica el modelo completo del objeto de asociaciones y cómo recuperar los datos de relaciones de forma programática.

Los eventos del historial son el registro de actividad. Cada correo enviado, llamada registrada, reunión agendada y envío de formulario vive en el historial de actividades de un contacto. Estos también son independientes del registro de Contacto y requieren métodos de exportación diferentes.

Conocer esta arquitectura de antemano le indica por qué un proceso de exportación en tres pasos es necesario, no opcional. Y determina cómo abordar el mapeo de campos entre HubSpot y su sistema de destino: las asociaciones representan un desafío de mapeo separado al de las propiedades de los objetos.

---

Paso 1: exportación nativa, qué cubre y cuándo usarla

La exportación nativa de HubSpot (Contactos > Exportar, Negocios > Exportar, etc.) le entrega archivos CSV planos de sus registros de objetos. Es confiable para recuentos de registros y propiedades principales. Es el punto de partida correcto.

Qué cubre bien la exportación nativa:

• Todas las propiedades de contactos (estándar y personalizadas)
• Todas las propiedades de empresas
• Todas las propiedades de negocios, incluyendo Pipeline y etapa
• Todas las propiedades de tickets
• Valores de propiedades personalizadas en cualquier objeto

Qué incluir en cada exportación:

Cuando HubSpot le pida seleccionar las propiedades a exportar, no acepte la selección predeterminada. Elija "Todas las propiedades" o seleccione manualmente cada propiedad que desee. Las exportaciones estándar suelen omitir las propiedades personalizadas a menos que las incluya explícitamente.

Qué no cubre la exportación nativa:

• Asociaciones Contacto-Empresa
• Asociaciones Contacto-Negocio
• Asociaciones Negocio-Empresa
• Asociaciones de múltiples objetos (un Negocio asociado con múltiples Contactos)
• Registros de interacciones (llamadas, correos, reuniones, notas)
• Registros de objetos personalizados

Use la exportación nativa para obtener sus archivos de registros base. Luego gestione las asociaciones y el historial de interacciones por separado. Antes de comenzar, confirme su alcance con la orientación en preparar sus datos antes de migrar cualquier cosa: las decisiones que tome allí determinan qué propiedades de HubSpot importan realmente.

Comparación de métodos de exportación:

---

Paso 2: exportar las asociaciones por separado

Los datos de asociaciones de HubSpot requieren la API o una configuración deliberada en la exportación. Aquí se presentan ambas opciones.

Opción A: usar la exportación de Asociaciones dentro de HubSpot

Al exportar Contactos, busque la opción "Incluir registros asociados" en el cuadro de diálogo de exportación. En algunas versiones del portal, HubSpot permite incluir el nombre de la Empresa y el nombre del Negocio asociados en la exportación de Contactos. Verifique si su versión del portal admite esto. Si lo hace, evita una llamada a la API.

Pero tenga en cuenta que "incluir nombres asociados" no es lo mismo que exportar el grafo de asociaciones completo. Obtendrá Empresa.Nombre y Negocio.Nombre en la fila del Contacto, pero no obtendrá un mapeo adecuado de muchos-a-muchos que muestre qué Contactos están en qué Negocios.

Opción B: obtener las asociaciones a través de la API de HubSpot

La API de Asociaciones devuelve todos los pares de asociaciones para un tipo de objeto dado. Un miembro técnico del equipo (o una persona de RevOps que se sienta cómoda con herramientas de API como Postman) puede obtener esto de forma programática.

Los endpoints clave:

• GET /crm/v4/associations/contacts/companies/batch/read: pares Contacto-Empresa
• GET /crm/v4/associations/contacts/deals/batch/read: pares Contacto-Negocio
• GET /crm/v4/associations/deals/companies/batch/read: pares Negocio-Empresa

Exporte estos como archivos separados y trátelos como tablas de unión. En su CRM de destino, los usará para restablecer las relaciones después de importar los registros base.

Si no cuenta con recursos de desarrollo:

Herramientas como Coupler.io, Supermetrics y la propia función de sincronización de datos de HubSpot pueden producir exportaciones estructuradas que incluyen datos de asociaciones sin necesidad de trabajo con API. Son más lentas y a veces tienen costo adicional, pero son genuinamente útiles para equipos no técnicos. Una vez que tenga los datos de asociaciones, probar la migración con una importación paralela es la forma de verificar que las asociaciones están intactas antes de comprometerse con el traslado completo.

---

Paso 3: exportar el historial de interacciones y actividades

HubSpot llama "interacciones" a la actividad registrada y la almacena en un historial separado del registro de contacto. Estos datos no se pueden exportar a través de la exportación estándar de la interfaz. Requieren la API.

Qué cuenta como datos de interacciones:

• Llamadas registradas (con notas/resultado)
• Correos registrados
• Reuniones agendadas y completadas
• Notas añadidas manualmente por los representantes
• Tareas con datos de finalización
• Envíos de formularios

Qué también contiene el historial (generalmente omítalo):

• Eventos de apertura y clic de correos (registrados automáticamente por el seguimiento de HubSpot)
• Eventos de visitas a páginas
• Historial de inscripción en Workflows

La primera categoría son datos ingresados por los representantes: contexto real de ventas. La segunda categoría son datos de eventos generados por el sistema. En la mayoría de las migraciones, conviene incluir la primera y omitir la segunda. Migrar cientos de miles de eventos de visitas a páginas genera ruido en el CRM de destino sin ningún valor de negocio.

Endpoint de la API:

GET /crm/v3/objects/engagements devuelve registros de interacciones con su tipo (CALL, EMAIL, MEETING, NOTE, TASK), los IDs de contacto/empresa/negocio asociados y el contenido del cuerpo de la interacción.

Alternativa práctica para equipos no técnicos:

Si no puede acceder a la API, documente la decisión explícitamente: no migrará el historial de interacciones, y el portal de HubSpot de origen permanecerá accesible en modo read-only durante 90 días después de la migración para quien necesite contexto histórico. Un informe de investigación de Forrester sobre migración de datos de CRM señala que la integridad del historial de interacciones está entre los cinco principales factores que determinan la velocidad de adopción por parte de los representantes tras un cambio de CRM. Esa es una decisión de negocio legítima. No toda migración necesita llevar el historial completo de interacciones. Lo fundamental es tomar la decisión de forma intencional, en lugar de descubrir la brecha después del go-live. Para todo lo que decida no migrar, el archivado a largo plazo de los datos del CRM heredado cubre cómo mantenerlo accesible sin pagar licencias completas de HubSpot indefinidamente.

---

Paso 4: gestionar los objetos personalizados

Si su portal de HubSpot tiene objetos personalizados (frecuente en portales que han sido personalizados para Workflows de industrias específicas), esos objetos requieren su propio proceso de exportación.

Cómo verificar si su portal tiene objetos personalizados:

Configuración > Objetos > Objetos personalizados. Si no hay nada aquí, omita esta sección.

Exportar objetos personalizados:

Los objetos personalizados en HubSpot no se pueden exportar a través de la exportación estándar de la interfaz. Las opciones son:

1. API de HubSpot: mismo patrón que los objetos estándar. Use GET /crm/v3/objects/{customObjectType} con el nombre interno del objeto personalizado.
2. HubSpot Data Sync: la herramienta de sincronización nativa de HubSpot puede exportar a hojas de cálculo o bases de datos, incluyendo objetos personalizados.
3. Conectores de terceros: herramientas como Airbyte o Fivetran tienen conectores de HubSpot que gestionan objetos personalizados de forma nativa.

Para la mayoría de los equipos sin un ingeniero de datos dedicado, un conector de terceros es el enfoque más confiable para exportar objetos personalizados.

---

Paso 5: validar la integridad antes de salir de HubSpot

No empiece a limpiar ni a importar hasta haber verificado que la exportación cubre todo lo que debe. Una validación de 30 minutos ahora evita semanas de reconciliación después.

Lista de verificación de validación:

• El recuento de contactos en el CSV coincide con el total de contactos en HubSpot (Configuración > Valores predeterminados de cuenta > Contactos)
• El recuento de empresas en el CSV coincide con el total de empresas en HubSpot
• El recuento de negocios en el CSV coincide con el total de negocios en HubSpot (verifique por Pipeline si existen múltiples)
• Existen archivos de exportación de asociaciones para: Contacto-Empresa, Contacto-Negocio, Negocio-Empresa
• Las definiciones de propiedades personalizadas fueron exportadas (Configuración > Propiedades, exporte la lista de propiedades por separado)
• La exportación de interacciones cubre los tipos clave: llamadas, correos, reuniones, notas
• Los campos de GDPR/exclusión voluntaria están incluidos en la exportación de Contactos (busque los campos "Exclusión de correo", "Base legal para el procesamiento", "Consentimiento GDPR")
• El campo de etapa del ciclo de vida está incluido en la exportación de Contactos

Verificación de muestra de asociaciones:

Seleccione 10 Negocios de su exportación. Para cada Negocio, verifique:

1. Los IDs de Contacto en su archivo de asociaciones coinciden con los contactos en su exportación de Contactos
2. Los IDs de Empresa coinciden con las empresas en su exportación de Empresas
3. Cuente la cantidad de Contactos por Negocio: ¿parece correcto en comparación con la interfaz de HubSpot?

Las inconsistencias aquí significan que su exportación de asociaciones está incompleta. Corríjala antes de limpiar.

Integridad de propiedades personalizadas:

Exporte sus definiciones de propiedades (Configuración > Propiedades > Descargar) y compare los nombres de las propiedades con los encabezados de columna de su CSV. Las columnas faltantes indican propiedades que no se incluyeron en la exportación. Vuelva a ejecutarla con esas propiedades añadidas.

---

Errores comunes

Exportar contactos sin empresas. Si los registros de Empresas no están en su exportación, cada Contacto pierde su asociación con la empresa. Exporte las Empresas primero y luego los Contactos con Empresa.Nombre incluido.

Perder el historial de etapas del ciclo de vida. El campo de Etapa del ciclo de vida se actualiza con el tiempo, pero HubSpot solo almacena el valor actual, no el historial de cuándo cambió. Si la progresión de la etapa del ciclo de vida importa para la configuración de su CRM de destino, documente los valores del estado actual al momento de la exportación. No puede recuperar el historial.

No exportar las definiciones de propiedades personalizadas. Al importar en el CRM de destino, deberá recrear todas sus propiedades personalizadas. HubSpot le permite exportar la lista de definiciones de propiedades (no solo los valores). Descárguela; le ahorrará horas durante el mapeo de campos.

Olvidar los indicadores de consentimiento GDPR. Si su portal registra el consentimiento de correo electrónico o la base legal del GDPR, esos campos deben estar en su exportación. No están en las columnas de exportación predeterminadas. Agréguelos explícitamente. Perder los registros de consentimiento puede generar problemas de cumplimiento en el sistema de destino. La descripción general de la GDPR en Wikipedia cubre las categorías de base legal y las obligaciones de derecho al olvido que aplican a los datos de contactos en CRM.

No considerar los registros eliminados. HubSpot no tiene una papelera de reciclaje fácilmente accesible a través de la exportación. Si ha eliminado registros que deben incluirse en la migración, deberá trabajar con el soporte de HubSpot o usar el endpoint de registros archivados de la API.

---

Qué hacer a continuación

Una exportación de HubSpot validada significa que tiene archivos de registros base más datos de asociaciones e interacciones. Pero nada de eso está listo para importar aún.

El siguiente paso es la limpieza de datos: deduplicación, normalización y enriquecimiento. Las organizaciones de HubSpot acumulan duplicados, valores de propiedades inconsistentes y problemas de formato a lo largo de años de uso. Limpie antes de importar. Según los datos del mercado de CRM de Statista, más del 91 % de las empresas con más de 11 empleados usa software de CRM, y los desafíos de calidad de datos que se acumulan en instancias de CRM de larga data son consistentes independientemente del proveedor.

Si va a llevar el historial de interacciones hacia adelante, gestión de actividades históricas, notas y correos electrónicos cubre el marco de decisión sobre qué migrar realmente frente a qué archivar.

Y si aún no ha completado el inventario previo a la migración, preparar sus datos antes de migrar cualquier cosa es donde se toman esas decisiones antes de que comience la exportación.

---

Más información

• Limpieza de datos: deduplicación, normalización, enriquecimiento
• Gestión de actividades históricas, notas y correos electrónicos
• Preparar sus datos antes de migrar cualquier cosa
• Mapeo de campos entre sistemas heredados y nuevos
• Lanzamiento y adopción del CRM: cómo lograr que su equipo realmente lo use
• Modelo de madurez de RevOps: dónde está su equipo y qué sigue