Saltar al contenido principal

​
Resumen

Esta guía te explica cómo preparar tu archivo CSV para una importación exitosa. Sigue estos pasos para evitar errores.

​
Paso 1: Comprueba los requisitos del archivo

Antes de empezar, asegúrate de que tu archivo cumpla estos requisitos:
RequisitoDetalles
FormatoCSV, XLSX o XLS
Límite de tamaño10.000 registros por archivo
CodificaciónSe recomienda UTF-8
EstructuraUn tipo de objeto por archivo
Para conjuntos de datos de más de 10.000 registros, divídelos en varios archivos o usa la importación por API.

​
Paso 2: Descarga el archivo de ejemplo

Este es el paso más importante. El archivo de ejemplo te muestra los nombres de columna y el formato exactos que Twenty espera.
  1. Ve a la vista del objeto (Personas, Empresas, etc.)
  2. Haz clic en ⋮ → Importar registros
  3. Haz clic en Descargar archivo de ejemplo
  4. Utiliza este archivo como plantilla
Consejo práctico: En su lugar, exporta algunos registros existentes. Esto te proporciona ejemplos reales de cómo debe darse formato a los datos, y los nombres de las columnas se asignarán automáticamente durante la importación.

​
Paso 3: Eliminar valores duplicados

Twenty exige unicidad en determinados campos. Los duplicados provocarán errores de importación.
ObjetoCampos únicos
Personasid, email
Empresasid, domain
Objetos personalizadosid, además de cualquier campo que hayas marcado como único
Antes de importar:
  1. Ordena tu hoja de cálculo por el campo único (correo electrónico o dominio)
  2. Elimina o fusiona las filas duplicadas
  3. Comprueba si hay duplicados que ya existan en Twenty
Los registros eliminados lógicamente cuentan para la unicidad. Los registros en Menú de comandos → Ver registros eliminados provocarán errores de duplicados. Elimínalos de forma permanente o restáuralos y actualízalos.

​
Paso 4: Formatea correctamente cada tipo de campo

Los distintos tipos de campos requieren formatos específicos. Aquí tienes la referencia completa:

​
Campos de texto

  • No se requiere un formato especial
  • Los espacios iniciales y finales se eliminan automáticamente

​
Campos de correo electrónico

  • Debe tener un formato de correo electrónico válido: name@domain.com
  • Debe ser único (sin duplicados en el archivo ni en Twenty)
  • Para correos electrónicos adicionales, utiliza este formato en la columna Emails / Additional Emails:
["jane@twenty.com","jane.doe@twenty.com"]

​
Campos de dominio

  • Formato recomendado: https://domain.com
  • Esto coincide con el formato usado por la sincronización del buzón/calendario (evita duplicados)
  • Rellena ambas columnas:
    • Domain / Domain Label: domain.com
    • Domain / Domain URL: https://domain.com
  • Debe ser único dentro de tu archivo y en Twenty

​
Campos de teléfono

El campo de teléfono es un campo anidado que requiere varias columnas:
ColumnaEjemplo
Phones / Primary Phone Number4159095555
Phones / Primary Phone Country CodeUS
Phones / Primary Phone Calling Code+1

​
Campos de dirección

Dirección es un campo anidado con varias columnas (algunas pueden dejarse en blanco):
  • Dirección / Dirección 1: Línea 1 de la dirección
  • Dirección / Dirección 2: Línea 2 de la dirección (opcional)
  • Dirección / Ciudad: Nombre de la ciudad
  • Dirección / Estado: Estado o provincia
  • Dirección / País: Nombre del país
  • Dirección / Código postal: Código postal/ZIP

​
Campos de fecha

Usa un formato coherente en todo tu archivo:
  • YYYY-MM-DD (recomendado): 2024-03-15
  • MM/DD/YYYY: 03/15/2024
  • DD/MM/YYYY: 15/03/2024
  • ISO 8601: 2024-03-15T10:30:00Z

​
Campos numéricos

  • Solo números (sin texto)
  • Usa punto para decimales: 1234.56
  • Sin separadores de miles (no 1,234.56)

​
Campos de moneda

Moneda es un campo anidado que requiere dos columnas que ambas deben completarse:
ColumnaEjemplo
Importe / Importe1234.56
Importe / MonedaUSD

​
Campos booleanos

Usa mayúsculas: TRUE o FALSE
Las minúsculas true o false no funcionarán.

​
Campos de Selección

Usa el nombre de la API de la opción, no la etiqueta visible. Cómo encontrar los nombres de la API:
  1. Ve a Configuración → Modelo de datos
  2. Selecciona el objeto y el campo
  3. Activa el modo Avanzado (conmutador en la parte inferior derecha)
  4. Copia el nombre de la API (p. ej., OPTION_1, no “Option 1”)
Las nuevas opciones de selección no se crean automáticamente. Agrégalas en Configuración → Modelo de datos antes de importar.

​
Campos de selección múltiple

Usa nombres de API en formato de arreglo: 
["VALUE1","VALUE2"]

​
Campos de arreglo

Usa el formato de arreglo JSON: 
["value1","value2"]

​
Campos de calificación

Usa el formato: RATING_1, RATING_2, RATING_3, RATING_4 o RATING_5

​
Campos de enlaces/URL

Completa ambas columnas:
  • Enlaces / Etiqueta del enlace: Twenty
  • Enlaces / URL del enlace: https://twenty.com
Para enlaces secundarios, usa la columna Enlaces / Enlaces secundarios: 
[{"url":"https://twenty.com","label":"Twenty"}]

​
Campos JSON

Usa un formato JSON válido: 
{"key":"value","key2":"value2"}

​
Campos de ID

  • Opcional: Twenty genera IDs automáticamente si no se proporcionan
  • Formato: UUID (p. ej., c776ee49-f608-4a77-8cc8-6fe96ae1e43f)
  • Caso de uso: Incluye el ID para actualizar registros existentes en lugar de crear nuevos

​
Paso 5: Agrega columnas de relación (si se vinculan registros)

Para vincular registros con otros objetos (p. ej., Personas con Empresas), agrega una columna con el identificador único del registro relacionado. Ejemplo: Vincular Personas con Empresas Agrega una columna a tu CSV de Personas: 
firstName,lastName,email,companyDomain
John,Smith,john@acme.com,https://acme.com
Jane,Doe,jane@widgets.co,https://widgets.co
Reglas importantes para las relaciones:
  • El registro padre debe existir previamente en Twenty
  • Usa el formato de URL de dominio (https://domain.com), no la etiqueta
  • Mapea solo UN identificador único (no incluyas companyId Y companyDomain)
  • Para los miembros del espacio de trabajo, usa su email (no el nombre)
¡El orden de importación importa!Importa el lado “uno” antes del lado “muchos”:
  1. Empresas primero
  2. Personas después (con referencia a la empresa)
  3. Oportunidades en tercer lugar
El registro padre debe existir antes de poder referenciarlo.
Consulta Cómo importar relaciones para obtener instrucciones detalladas.

​
Paso 6: Asegúrate de que los campos existan en Twenty

La importación crea registros, no campos. Todos los campos que quieras importar deben existir ya en tu modelo de datos. Antes de importar:
  1. Ve a Configuración → Modelo de datos
  2. Selecciona tu objeto
  3. Crea los campos personalizados que necesites
  4. Anota los nombres exactos de los campos (deben coincidir con los encabezados de tus columnas)

​
Paso 7: Lista de comprobación final

Antes de subir tu archivo, verifica:
El archivo está en formato CSV, XLSX o XLS
El archivo tiene menos de 10,000 registros
La codificación es UTF-8
No hay correos electrónicos duplicados (para Personas) ni dominios duplicados (para Empresas)
Las fechas usan un formato coherente en todo el archivo
Los dominios usan el formato https://domain.com
Los campos booleanos usan TRUE o FALSE (en mayúsculas)
Los campos de selección usan nombres de API, no etiquetas visibles
Todos los campos personalizados existen en Configuración → Modelo de datos
Los registros padre importados antes que los registros hijo
Las columnas de relación hacen referencia a registros existentes

​
Errores comunes a evitar

ErrorSolución
Usar true en lugar de TRUELos valores booleanos deben estar en mayúsculas
Usar etiquetas visibles para campos de selecciónBusca y usa los nombres de API en Configuración
Importar Personas antes que EmpresasImporta siempre primero los objetos padre
Falta el código de moneda en los campos de monedaCompleta las columnas de Importe y Moneda
Formato de dominio incorrectoUsa https://domain.com de forma coherente
Mapear varios campos únicos para las relacionesMapea solo UNO (dominio O ID, no ambos)

​
Próximos Pasos

¡Tu archivo está listo! Ahora: