Importar contactos de Excel a HubSpot sin duplicar registros
Decide si crear o actualizar, conserva identificadores y prueba contactos y empresas antes de importar toda la hoja. Cuándo usar el importador y cuándo un script.
Para importar contactos de Excel a HubSpot, decide primero si necesitas crear registros nuevos, actualizar los existentes o realizar ambas operaciones. La prevención de duplicados depende de los identificadores y de la calidad del archivo, no de que la carga se haga mediante un script.
El importador puede ser suficiente para una carga puntual bien preparada. Un proceso recurrente con transformaciones y varias fuentes puede necesitar automatización adicional. Esta guía ayuda a elegir y preparar ambos recorridos.
1. Separar creación y actualización
Conserva una copia del archivo original y describe qué cambio debe producir cada fila. Si actualizas contactos existentes, prepara una exportación con sus identificadores y relaciona cada fila antes de cargarla.
La documentación de HubSpot explica el uso de identificadores como correo y Record ID según el objeto y la operación. Un identificador de otro CRM no es automáticamente un Record ID de HubSpot. Consérvalo como referencia de origen y crea una correspondencia.
Los contactos sin coincidencia clara deben quedar en revisión. No los vincules únicamente por nombre, porque personas distintas pueden compartirlo y una misma persona puede aparecer escrita de varias maneras.
2. Preparar columnas y tipos
Usa encabezados estables y una fila por registro según el formato elegido. Revisa fechas, teléfonos, códigos y valores de listas. Trata identificadores largos como texto para evitar redondeos de Excel.
Comprueba espacios, correos repetidos y filas vacías antes de exportar. Una limpieza de formato no autoriza a fusionar contactos: esa decisión necesita reglas de identidad y revisión de conflictos.
Si necesitas organizar primero la hoja, consulta cómo preparar Excel para importar datos. Aquí el paso adicional es relacionar sus columnas con propiedades reales de HubSpot.
3. Crear un mapa de propiedades
Para cada columna, anota propiedad de destino, tipo, valores permitidos y acción cuando falta información. Confirma si esa propiedad ya existe o si debes crearla y quién podrá mantenerla.
HubSpot documenta que las celdas vacías de una importación no eliminan automáticamente los valores ya existentes. No utilices una columna vacía como procedimiento de borrado: comprueba el mecanismo adecuado para esa operación.
Mantén separadas notas de trabajo, campos comerciales y permisos de comunicación. Tener una dirección en Excel no convierte a la persona en destinataria de campañas; preserva las restricciones de comunicación de los registros existentes.
4. Resolver asociaciones con empresas
Si la carga incluye empresas o negocios, define sus identificadores y el formato de asociación compatible con la importación seleccionada. El nombre escrito en una columna no demuestra por sí solo que el contacto quedó asociado a la empresa correcta.
Prueba empresas con nombres parecidos, compradores de una misma empresa y contactos con correo genérico. Conserva la relación esperada para poder compararla después de la carga.
5. Importar una muestra representativa
Incluye un contacto nuevo, uno existente, una fila inválida y un caso asociado a empresa. Comprueba antes qué registros deberían crearse, cuáles actualizarse y cuáles rechazarse.
Después de importar, revisa el resultado y los errores de fila. Un archivo aceptado no implica que todos los campos hayan terminado como esperabas. Compara una muestra en la interfaz y descarga la información necesaria para reconciliarla.
6. Decidir si hace falta un script
Un script tiene sentido cuando debes repetir el proceso, combinar fuentes o aplicar transformaciones que no conviene hacer manualmente. Debe validar entradas, respetar límites de API y guardar correspondencias y errores.
No escribas un script de creación masiva antes de decidir cómo actualizar contactos. Si una petición se repite, el proceso debe saber si ese registro ya existe. La API añade posibilidades, pero también credenciales, mantenimiento y supervisión.
Qué conservar al terminar
Guarda archivo de origen, mapeo, fecha de carga, registros aceptados, errores pendientes y correspondencia de identificadores. Para deshacer un cambio, distingue los registros creados de las propiedades actualizadas: borrar todo el lote no restaura los valores anteriores.
Podemos preparar una integración de CRM, el procesamiento y validación de datos o una conexión recurrente mediante API. Si cambias de plataforma y necesitas conservar historial, consulta la guía general de migración de datos entre CRM.