CSV

Formato de archivo CSV para importar contactos y oportunidades

Contactos
October 09, 2025•4 min read

Beneficios clave de preparar su archivo CSV

Tomarse el tiempo para formatear correctamente su archivo CSV antes de importarlo garantiza que sus datos de contacto estén limpios, completos y asignados con precisión.

  • Reduce la posibilidad de errores de importación o fallas de carga.

  • Ayuda a HighLevel a mapear automáticamente los campos durante la importación

  • Permite la deduplicación de contactos y actualizaciones precisas

  • Admite campos personalizados y segmentación avanzada

  • Ahorra tiempo al evitar la limpieza posterior a la importación

  • Aumenta el éxito con cargas masivas de contactos/oportunidades

¿Qué es un formato de archivo CSV?

CSV significa "Valores Separados por Comas". Es un formato de archivo simple que se utiliza para almacenar datos tabulares, como hojas de cálculo o bases de datos. Cada línea de un archivo CSV representa un único registro, y los campos dentro del registro se separan por comas. Es uno de los formatos más utilizados para importar y exportar datos entre diferentes sistemas.

  • Los archivos CSV normalmente tienen una.csvextensión .

  • Puede crearlos o editarlos en herramientas como Excel, Hojas de cálculo de Google o el Bloc de notas.

  • Asegúrese de que solo haya una hoja en el archivo para evitar problemas de importación.

Ejemplo:

m

Estructurando su archivo

Para garantizar una asignación de datos precisa, estructure su archivo CSV con encabezados de columna correspondientes a campos estándar o personalizados en HighLevel.

1. Formato CSV de muestra

m

  • Cada fila representa un solo contacto u oportunidad.

  • Cada columna representa una propiedad distinta.

  • La fila de encabezado es necesaria para asignar los campos correctamente.

2. Campos obligatorios

Se requiere al menos uno de los siguientes para crear o actualizar un contacto:

  • Nombre de pila

  • Dirección de correo electrónico

  • Número de teléfono

Nota : Para actualizar contactos, se requiere un identificador único (ID de contacto, correo electrónico o teléfono) según la configuración de deduplicación. Para las oportunidades, incluya el ID de oportunidad si va a actualizar. Sin él, se creará una nueva.

3. Formato de campo

Siga estas reglas de formato específicas para evitar errores de importación:

m

4. Tipos de archivos y tamaños de archivos admitidos

Su archivo debe cumplir ciertos requisitos básicos para una carga exitosa.

m

5. Campos obligatorios y opcionales para la importación

Incluir los campos correctos ayuda a AIDA Workspace a identificar y procesar sus registros con precisión.

m

6. Pautas de formato por tipo de campo

Para evitar errores de importación, siga estas reglas de formato para cada tipo de datos en su CSV.

m

Consejo : antes de importar su CSV, asegúrese de que los campos personalizados ya estén creados en su cuenta de HighLevel utilizando las mismas etiquetas y tipos de datos. Para obtener ayuda con la creación de campos personalizados, consulte Descripción general de campos de combinación y variables personalizadas.

Lista de países admitidos en importaciones CSV

Esta sección contiene una tabla de nombres de países aceptados durante las importaciones de CSV a AIDA Workspace. Estos son los valores oficiales que deben usarse en su archivo CSV al asignar un campo de país, ya sea estándar o personalizado. Use los nombres de país o códigos cortos exactos que se indican a continuación en su archivo CSV.

  • Propósito: AIDA Workspace valida los nombres de los países durante la importación. Si su CSV incluye un Country campo, cada fila debe coincidir exactamente con uno de los nombres de esta lista.

  • Formato: Debe coincidir exactamente (distingue entre mayúsculas y minúsculas y ortografía). Por ejemplo, United States se acepta, pero "USA o" U.S. causará un error.

  • Uso de campos personalizados: si utiliza un campo de país personalizado, puede resultar beneficioso seguir esta lista para mantener la compatibilidad.

nn

Zonas horarias compatibles

Utilice uno de los siguientes formatos de zona horaria en su CSV. Estos distinguen entre mayúsculas y minúsculas y deben coincidir exactamente.

Zona horaria

mm

Preguntas frecuentes

P: ¿Puedo importar contactos con más de un número de teléfono o correo electrónico?
¡Sí! Use columnas separadas como Additional phone numbers y Additional email addresses y separe las entradas con comas.

P: ¿Qué ocurre si incluyo un campo en el CSV que no existe en AIDA Workspace?
Ese campo se ignorará a menos que lo asigne a un campo estándar o personalizado existente durante el proceso de importación.

P: ¿AIDA Workspace detectará duplicados automáticamente?
Sí, según la configuración de detección de duplicados, puede buscar por ID de contacto, teléfono o correo electrónico y combinar u omitir duplicados.

P: ¿Puedo actualizar contactos con una importación CSV?
Por supuesto. Solo asegúrate de incluir un campo usado en la coincidencia de duplicados (como ID de contacto, correo electrónico o teléfono).

P: ¿Necesito borrar las filas y columnas en blanco?
Sí. Es mejor eliminar todos los datos innecesarios para evitar un comportamiento de importación inesperado.


Back to Blog