Ajuste de los archivos de importación
Última actualización: enero 2, 2025
Disponible con cualquiera de las siguientes suscripciones, a no ser que se indique de otro modo:
Todos los productos y planes |
Antes de importar datos a HubSpot, revisa los siguientes límites y requisitos. También puede acceder a archivos de muestra o generar archivos de ejemplo para empezar.
Para obtener más información sobre la herramienta de importación, consulte este artículo. Si su archivo está listo, aprenda 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. Puedes confirmar si ya existe una propiedad predeterminada que coincida con tu cabecera o 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:
- Contiene 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 importa a través de la API de importaciones, puede importar hasta 80.000.000 de filas al 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. Obtén más información sobre tu suscripción a HubSpot y sus limitaciones.
Formato de los valores
Para cada fila de su archivo de importación, puede añadir 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
En función del tipo de campo de Propiedad, existen 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 ha ajustado 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 añadir 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 formatear valores de fecha y hora y cómo convertir una fecha a formato UNIX. |
Enumeración |
Los valores de su 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 añadir 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, añada 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:
|
Casilla de comprobación única |
Cree una columna para el campo de casilla de verificación única y ajuste el valor de cada línea a Verdadero o Sí para mostrarlo como Sí o marcado en HubSpot o Falso o No para mostrarlo como No o no marcado en HubSpot. |
Texto |
Si ha ajustado 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:
|
Otros correos electrónicos de contacto o dominios de empresa
Si importa contactos con más de una dirección de correo electrónico, incluya 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á importando para crear contactos o empresas, no puede ajustar el correo electrónico de un nuevo contacto o el nombre de dominio de una nueva empresa a un correo electrónico o dominio que sea un correo electrónico/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 bloque, puede editar manualmente los valores o utilizar la acción de workflowBorrar valor de propiedad .Colaboradores de Negocio
Si está añadiendo colaboradores a un Negocio mediante importación, incluya una cabecera de colaborador de Negocio . Para cada celda, debe 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 cabeceras de columna en sus archivos. Si está actualizando registros, debe incluir un identificador único (por ejemplo, ID de registro, correo electrónico, nombre de dominio de la empresa).
Aunqueno es obligatorio, puede importar propiedades adicionales para cada objeto, incluyendo propiedades personalizadas y por defecto. Consulte las propiedades de forma predeterminada para contactos, empresas, negocios, tickets, llamadas, correos electrónicos, reuniones, notas y tareas. También puede ver todas las propiedades y sus valores en los ajustes de su propiedad.
- 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 Pipeline Stage.
- Productos: si está creando productos, Precio unitario y 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. Incluya el ID de producto del producto si también está asociando el elemento de pedido a un 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 convocatorias, 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 la actividad. Los valores de hora de inicio, hora de fin y fecha de actividad deben formatearse como 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 la 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 los registros existentes y utilizar el ID del registro como identificador único, o utilizar una propiedad personalizada que requiera valores únicos. Para los contactos, también puede utilizar Correo electrónico. Para empresas, también puede utilizar el dominio Empresa.
Si está importando varios objetos e incluye ID de registro, se recomienda diferenciar los encabezados de columna del archivo para que el ID coincida con el objeto correcto (por ejemplo, una columna llamada ID de registro - Contactos y otra llamada ID de registro - Empresas).
Nota: el siguiente comportamiento se aplica si en el archivo se incluye el nombre de dominio de correo electrónico o de 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 utilizar un correo electrónico secundario como identificador único para los contactos existentes que tengan una dirección de correo electrónico secundaria en HubSpot. Si utiliza un correo electrónico secundario y no incluye la columna Record ID en su archivo, el correo electrónico secundario no sustituirá al principal. Sin embargo, si incluye tanto el correo electrónico secundario como el ID de registro como columnas en su archivo, el correo electrónico secundario sustituirá al principal.
Requisitos para asociar registros
Importar asociaciones en un solo archivo
En un archivo, puede asociar dos o más registros por fila. Incluya información sobre los registros y/o actividades asociados en la misma fila e incluya un identificador único para cada objeto. Para asociar un registro a varias actividades o registros de otro objeto, incluya el identificador único del registro en varias filas para cada registro que desee asociar.
Por ejemplo, Luke Danes es mánager en Luke's Diner, pero contratista en The Dragonfly Inn. Para asociarlo con ambas empresas, tendría que incluir 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) para cada empresa.
Nota: si no incluye identificadores únicos (por ejemplo, correo electrónico, dominio de empresa, ID de registro), la importación creará registros duplicados en lugar de asociar cada uno al mismo registro.
Si está importando las mismas asociaciones de objetos, existen requisitos adicionales.
Importar asociaciones en dos archivos
Para asociar registros de dos objetos en dos archivos, utilice una columna común para conectar los registros de cada archivo. Puede consultar los archivos de ejemplo para obtener más ayuda sobre la importación y asociación de registros.
Mismas asociaciones de objetos
Puedes importar un archivo para asociar registros del mismo objeto en bloque. Durante el proceso de importación, tendrás que seleccionar una casilla de verificación para incluir las mismas asociaciones de objetos.
Cuando ajuste su archivo, incluya información sobre los registros asociados en la misma fila e incluya 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, obtenga más información sobre la importación de empresas secundarias.
Etiquetas de asociación personalizadas( sóloPro y Enterprise )
Para importar etiquetas de asociación, incluya una columna Etiqueta de asociación . Debes crear las etiquetas de asociación en HubSpot antes de importar.
- 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 vas a importar etiquetas de asociación en una importación múltiple de archivos , debes incluir en el mismo archivo la etiqueta de asociación columna y un identificador único para el objeto que vas a asociar.
- 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 añadida 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, puede generar un archivo de ejemplo con las propiedades necesarias para los objetos y actividades seleccionados. Si desea ver más ejemplos con propiedades adicionales, consulte este artículo con archivos de ejemplo.