Nota: Este contenido se tradujo a través de un software y es posible que no haya sido revisado.

Configurar los archivos de importación

Última actualización: marzo 6, 2025

Disponible con cualquiera de las siguientes suscripciones, a no ser que se indique de otro modo:

Antes de importar datos a HubSpot, revisa los siguientes límites y requisitos. También puedes acceder a archivos de muestra o generar archivos de ejemplo para empezar.

Más información sobre la herramienta de importación, consulta este artículo. Si tu archivo está listo, aprende a importarlo.

Requisitos técnicos y límites

Todos los archivos que se importan a HubSpot deben cumplir estos requisitos:

Ser un archivo .csv, .xlsx o .xls.
Tener solo una hoja.
Incluir una fila de encabezados en la que cada encabezado de columna corresponda a una propiedad de HubSpot. Los encabezados de las columnas pueden organizarse en cualquier orden sin que ello afecte a la importación. También puedes confirmar si ya hay una propiedad predeterminada que coincida con cada encabezado o bien crear una propiedad personalizada antes de importar. Más información sobre los requisitos de propiedades.

Contener menos de 1000 columnas.
Tener codificación UTF-8 si se incluyen caracteres de idiomas extranjeros.
Si vas a importar un archivo Excel, el archivo debe:
- Contener datos que permanecen por debajo de los límites máximos de hojas de cálculo y libros de Excel.
- Contener celdas en formato Número al importar propiedades del selector de fecha y hora.

Existen límites técnicos adicionales para la herramienta de importación en función de tu suscripción a HubSpot. Estos límites incluyen los límites de tamaño y filas de un archivo de importación, así como el número de archivos y filas que puede importar al día.

Si utilizas las herramientas gratuitas de HubSpot, puedes:
- Importar archivos de hasta 20 MB.
- Realizar hasta 50 importaciones al día.
- Importar hasta 500.000 filas al día. Si importas un archivo con más de 500.000 filas, tardará varios días en completarse.
Si tu cuenta tiene una suscripción Starter, Pro o Enterprise, puedes:
- Importar archivos de hasta 512 MB.
- Realizar hasta 500 importaciones al día.
- Importar hasta 10.000.000 de filas al día, con un límite de 1.048.576 filas por archivo. Si utilizas la API de importaciones, puedes importar hasta 80.000.000 filas por día.

Estos límites se aplican a un período de 24 horas y no se restablecen en un momento específico del día. Más información sobre tu suscripción de HubSpot y sus limitaciones.

Formato de los valores

Para cada fila de tu archivo de importación, puedes agregar valores para las columnas de propiedades. El formato de un valor depende del tipo de campo de propiedad y de la meta de la importación.

Formatear valores en función del tipo de campo de propiedad

Según el tipo de campo de la propiedad, hay que cumplir requisitos de formato específicos:

Tipo de campo	Requisitos
Selector de fechas Selector de fecha y hora	Los meses pueden ser un número, tres letras o un nombre completo (10, OCT, Oct, OCTUBRE, octubre), los años pueden tener dos dígitos o cuatro (2023, 23) y los separadores pueden ser una barra oblicua, un guion o un punto (28/10/2023, 28/10-2023, 28/10.2023). Los formatos de fecha válidos son día mes año (por ejemplo, 28/10/2023), mes día año (por ejemplo, 10-28-23) o año mes día (por ejemplo, 2023.OCT.28). Si has establecido reglas de validación, los valores importados deben seguir las reglas o no se importarán.
Selector de fecha y hora	Las marcas de tiempo se pueden agregar como hh:mm (28/10/2020 14:30) en todos los tipos de archivo o como una marca de tiempo UNIX en milisegundos en archivos CSV o un archivo Excel con celdas en formato de número de texto. Si no se incluye una marca de tiempo, la hora se establece por opción predeterminada en la medianoche.
Duración	Para las propiedades que contienen una duración, como la propiedad Duración de llamada, sus valores deben formatearse como una marca de tiempo UNIX en milisegundos. Más información sobre cómo dar formato a los valores de las marcas de tiempo y cómo convertir una fecha a formato UNIX.
Enumeración	Los valores de tu archivo de importación deben coincidir con la etiqueta o con el valor interno de las opciones definidas de la propiedad. Para las propiedades de enumeración predeterminadas de HubSpot (por ejemplo, Etapa del ciclo de vida, Industria), los valores deben coincidir con el valor interno o la etiqueta en inglés.
Archivo	Para agregar archivos existentes a una propiedad de archivo, incluya el ID de Archivo como valor. Puedes encontrar el ID de un archivo en la sección General de los detalles de un archivo.
Múltiples casillas de comprobación	Para importar varios valores, agrega un punto y coma entre cada valor sin espacios (valor 1;valor 2). Estas opciones de propiedad deben crearse antes de la importación. Para agregar o anexar valores, agrega un punto y coma antes del primer valor (;valor 3;valor 4). Esto agregará el valor en lugar de sobrescribir el valor existente de la propiedad.
Number	Formatea el valor en función del tipo de propiedad numérica creada: Divisa: para las propiedades que contengan una cantidad de divisa o un precio, debes utilizar una de las divisas aceptadas por HubSpot. En la pestaña Moneda de la configuración predeterminada de tu cuenta, puedes consultar la lista de las monedas aceptadas y sus códigos de moneda. Para el USD, los datos de divisa deben formatearse utilizando decimales (por ejemplo, 123,45) Porcentaje: formatee sus valores con un signo de porcentaje % o como decimal. Por ejemplo, para importar el 25%, la celda debe contener 25% o .25. Número de teléfono: para las propiedades del contacto Número de teléfono y Número de teléfono móvil, para importar y formatear automáticamente el número de teléfono basado en el código de país, se formatea como +[código de país][número]. Si hay una extensión, agrega ext[número]. Por ejemplo, un número de teléfono con el código de Estados Unidos sería similar a +11234567890 ext123. Si has establecido reglas de validación, los valores importados deben seguir las reglas o no se importarán.
Casilla de verificación única	Crea una columna para el campo de casilla de verificación única y establece el valor de cada línea Verdadero o Sí para mostrarlo como Sí o marcado en HubSpot o Falso o No para mostrarlo como No o no marcado en HubSpot.
Propiedades a término	La propiedad Elemento de pedido Término debe agregarse en los formatos de período ISO-8601 de PnYnMnD o PnW. Por ejemplo, P12M o P24M para plazos anuales. Si se deja en blanco, se establecerán los términos predeterminados.
Texto	Si has establecido reglas de validación, los valores importados deben seguir las reglas o no se importarán.
Usuario (Propietario)	Para asignar un propietario a un registro o actividad durante la importación: Para los objetos, incluye un encabezado Propietario [Objeto]. Para las actividades, incluye un encabezado Actividad asignada a. Agrega el nombre del usuario, la dirección de correo electrónico o el valor interno de la propiedad Propietario a cada fila de esa columna. Si en tu cuenta hay más de un usuario con el mismo nombre, se recomienda utilizar en su lugar la dirección de correo electrónico o el valor interno de la propiedad Propietario. Los usuarios asignados como propietarios mediante importación no recibirán una notificación de que se les ha asignado un nuevo registro/actividad.

Otros correos electrónicos de contacto o dominios de empresa

Si estás importando contactos con más de una dirección de correo electrónico, incluye una columna Direcciones de correo electrónico adicionales con sus correos electrónicos secundarios. Si vas a importar empresas con más de un nombre de dominio, incluye una columna Dominios adicionales con sus dominios secundarios. Para incluir varios correos electrónicos o dominios en una celda, separe los valores con punto y coma (por ejemplo, email@email.com; emailtwo@email.com).

Si estás importando para crear contactos o empresas, no puedes establecer Correo electrónico de un nuevo contacto o Nombre de dominio de la empresa de una nueva empresa en un correo electrónico o dominio que sea un correo electrónico o dominio adicional existente para otro registro.

Celdas en blanco

La herramienta de importación ignora las celdas en blanco en una hoja de cálculo, así que cuando importes nuevos datos de propiedades, deja las celdas en blanco para los registros sin un valor para la propiedad. Si un registro existente ya tiene un valor para la propiedad dentro de HubSpot, las celdas en blanco no borrarán el valor de la propiedad existente. Para borrar valores de propiedad existentes en masa, puedes editar manualmente los valores o utilizar la acción de workflow Borrar valor de propiedad.

Colaboradores de Negocio

Si estás agregando colaboradores a un negocio mediante importación, incluye un encabezado Colaborador de negocio. Para cada celda, debes incluir dos o más usuarios, separados por punto y coma (por ejemplo, user1@example.com;user2@example.com).

Plazos y frecuencias de facturación de los productos

Si quieres importar un valor de propiedad Término, el formato del valor de la columna Término debe ser un número en meses (por ejemplo, 10 para 10 meses), como PXM, donde X es el número de meses (por ejemplo, P6M para un plazo de 6 meses) o PXY, donde X es el número de años (por ejemplo, P1Y para un plazo de 1 año).

Para importar productos con el valor de propiedad Frecuencia de facturación, usa mensualmente, anualmente o trimestralmente si el producto tiene un tipo de precio recurrente. Deja la celda en blanco si el producto tiene un precio único.

Propiedades obligatorias

Dependiendo de los objetos o actividades que esté importando, las siguientes propiedades son necesarias para crear registros, y deben incluirse como encabezados de columna en tus archivos. Si estás actualizando registros, debes incluir un identificador único (por ejemplo, ID de registro, Correo electrónico, Nombre de dominio de la empresa).

Aunque no es obligatorio, puedes importar propiedades adicionales para cada objeto, incluyendo propiedades personalizadas y predeterminadas. Consulta las propiedades de forma predeterminada para contactos, empresas, negocios, tickets, llamadas, correos electrónicos, reuniones, notas y tareas. También puedes ver todas las propiedades y sus valores en configuración de las propiedades.

Contactos: al menos uno de Nombre, Apellidos o Correo electrónico.
Empresas: al menos una de Nombre o dominio de la empresa.
Negocios: si está creando nuevos negocios, Nombre del negocio, Pipeline y Etapa del negocio.
Tickets: si estás creando nuevos tickets, Nombre del ticket, Pipeline y Estado del ticket.
Citas: Inicio de la cita. El inicio de la cita debe formatearse como una propiedad de fecha-hora.
Cursos: Nombre del curso.
Listados: Nombre.
Servicios: Name, Pipeline y Etapa de pipeline.
Productos: si estás creando productos, Precio unitario y Nombre.
Pedidos: Nombre, Pipeline y Etapa de pipeline.
Carritos: Nombre.

Elementos de pedido: Nombre, Cantidad y Precio, así como el ID de registro o el Nombre del negocio asociados al negocio en cuestión. Si también vas a asociar elementos de línea específicos con productos concretos, incluye el ID de producto, que se asignará como una propiedad de elemento de pedido durante la importación.

Nota: al importar elementos de pedido con negocios, la importación no actualizará la cantidad del negocio. Para actualizar la cantidad del negocio asociada, puedes editar manualmente los elementos de pedido o asociar los elementos de pedido a un negocio en HubSpot.

Llamadas: Notas de llamada. Al importar nuevas llamadas, también se recomienda incluir Fecha de actividad.
Correos electrónicos: Cuerpo del correo y Dirección del correo electrónico.
Reuniones: Descripción de la reunión , Hora de inicio de la reunión y Hora de finalización de la reunión. Al importar nuevas reuniones, también se recomienda incluir Fecha de actividad. Los valores de hora de inicio, hora de finalización y fecha de la actividad deben tener el formato propiedades de fecha-hora.
Notas: Cuerpo de la nota.
Tareas: Título de la tarea y Fecha de vencimiento. La fecha de vencimiento debe formatearse como una propiedad de fecha-hora.

Nota: aunque no es obligatorio, se recomienda incluir Fecha de actividad al importar nuevas actividades para especificar la fecha y hora en que se produjo una actividad. Si no incluyes esta propiedad, los valores de Fecha de actividad se establecen automáticamente en la fecha y hora de la importación.

Requisitos para actualizar los registros existentes o evitar duplicados

Para actualizar los registros existentes y evitar registros duplicados, sus archivos deben incluir una propiedad de identificador único para cada objeto. Para todos los objetos, puedes exportar registros existentes y usar el ID del registro como identificador único o usar una propiedad personalizada que requiera valores únicos. Para los contactos, también puedes utilizar Correo electrónico. Para empresas, también puedes usar el Nombre de dominio de la empresa.

Si importas varios objetos e incluyes el ID de registro, te recomendamos que diferencies los encabezados de las columnas del archivo de forma que el ID coincida con el objeto correcto (por ejemplo, que una columna se llame ID de registro - Contactos y otra se llame ID de registro - Empresas).

Nota: el siguiente comportamiento se aplica si en el archivo se incluye el correo electrónico o el Nombre de dominio de la empresa:

Si utilizas una propiedad de valor único personalizada para desduplicar los contactos, la propiedad Correo electrónico seguirá necesitando valores únicos.
Si estás utilizando una propiedad de valor único personalizada para desduplicar empresas, la propiedad Nombre de dominio de la empresa no requerirá valores únicos. Esto significa que puedes importar dominios de empresa duplicados. Si no deseas tener varias empresas con el mismo dominio, debes eliminar los dominios duplicados de tu archivo antes de importar, o utilizar Nombre de dominio de la empresa como identificador único en su lugar.
Puedes usar un correo electrónico secundario como el identificador único de contactos existentes que tengan una dirección de correo electrónico secundaria en HubSpot. Si usas un correo electrónico secundario y no incluyes la columna ID de registro en el archivo, el correo electrónico secundario no reemplazará el correo electrónico principal. Sin embargo, si incluyes tanto el correo electrónico secundario como el ID de registro como columnas en el archivo, el correo electrónico secundario reemplazará el correo electrónico principal.

Requisitos para asociar registros

Importar asociaciones en un solo archivo

En un archivo, puede asociar dos o más registros por fila. Incluye información sobre los registros y/o actividades asociados en la misma fila e incluye un identificador único para cada objeto. Para asociar un registro con varios registros o actividades de otro objeto, incluye el identificador único del registro en varias filas por cada registro que quieras asociar.

En el ejemplo de abajo, Luke Danes es gerente de Luke's Diner, pero contratista de The Dragonfly Inn. Para asociarlo con ambas empresas, tendrías que incluir por cada empresa dos filas para Luke Danes con las columnas Correo electrónico (o ID de registro) y Nombre de dominio de la empresa (o ID de registro).

Nota: sino incluyes identificadores únicos (por ejemplo, Correo electrónico, Nombre de dominio de la empresa, o ID de registro), la importación creará registros duplicados en lugar de asociar cada uno al mismo registro.

Si estás importando las mismas asociaciones de objetos, existen requisitos adicionales.

Importar asociaciones en dos archivos

Para asociar registros de dos objetos en dos archivos, utiliza una columna común para conectar los registros de cada archivo. Si necesitas más ayuda para importar y asociar registros, consulta los archivos de ejemplo.

Mismas asociaciones de objetos

Puedes importar un archivo para asociar registros del mismo objeto en bloque. Durante el proceso de importación, deberás seleccionar una casilla de verificación para incluir las mismas asociaciones de objetos.

Cuando configures tu archivo, incluye información sobre los registros asociados en la misma fila e incluye un identificador único para cada registro. Los siguientes requisitos adicionales son específicos de las importaciones de objetos iguales:

Al menos un registro en un par de registros ya debe existir en HubSpot antes de la importación. Por ejemplo, puedes importar un nuevo contacto y asociarlo a un contacto existente, pero no puedes importar para crear y asociar dos nuevos contactos.
Al asociar contactos/empresas existentes, sólo puedes utilizar el correo electrónico/dominio de la empresa principal como identificador único. Los correos o dominios secundarios no son admitidos.
Si asocias varios registros a uno, separa los valores del identificador único de los registros con un punto y coma en la misma celda (por ejemplo, luke@lukesdiner.com; rory@yale.edu; sookie@dragonfly.com).

En el archivo de ejemplo siguiente, Rory y Jackson son nuevos contactos a los que se asocian etiquetas únicas a contactos existentes, utilizando sus valores de Correo electrónico como identificador único. Sookie es un contacto existente que se asocia a dos contactos existentes con la misma etiqueta. En la primera fila, la etiqueta de asociación forma parte de un par de etiquetas, lo que significa que una vez finalizada la importación, el registro asociado tendrá la etiqueta Principal y Rory tendrá la etiqueta emparejada, Secundaria.

Asociaciones de matriz/subsidiaria

Para crear asociaciones de empresas secundarias a través de la importación, obtén más información sobre la importación de empresas secundarias.

Etiquetas de asociación personalizadas(soloPro y Enterprise)

Para importar etiquetas de asociación, incluye una columna Etiqueta de asociación. Esta columna sólo debe agregarse si deseas agregar etiquetas para describir las asociaciones. Si no necesitas etiquetar asociaciones, la columna no es necesaria.

Las etiquetas de asociación deben crearse en HubSpot antes de la importación.
Para establecer una asociación de empresa como primaria, incluye el valor Primaria en la columna Etiqueta de asociación para esa fila.

Para definir varias etiquetas de forma que describan la relación entre dos registros, puedes incluir varios valores de etiquetas de asociación en una celda, separados por punto y coma (por ejemplo, Mánager; Contacto de facturación).

Si importas etiquetas de asociación en una importación de varios archivos, debes incluir la columna Etiqueta de asociación y un identificador único para el objeto que estás asociando en el mismo archivo.
Si vas a importar etiquetas emparejadas:
- Para las asociaciones multiobjeto, incluya sólo una de las etiquetas en la columna Etiqueta de asociación. Las etiquetas se asignarán al objeto correcto durante el proceso de importación.
- Para las mismas asociaciones de objetos, el registro de la columna Asociado [identificador único] recibirá la etiqueta agregada en el proceso de importación o incluida en la columna de etiquetas del archivo. El otro registro de la fila recibirá la otra etiqueta del par.

Archivos de ejemplo

Al principio del proceso de importación, puedes generar un archivo de ejemplo con las propiedades necesarias para los objetos y actividades seleccionados. Si deseas ver más ejemplos con propiedades adicionales, consulta este artículo con archivos de ejemplo.

¿Te resultó útil este artículo? Si No

Este formulario se utiliza solo para recibir comentarios a la documentación. Cómo recibir ayuda con HubSpot.