> ## Documentation Index
> Fetch the complete documentation index at: https://docs.get-clara.tech/llms.txt
> Use this file to discover all available pages before exploring further.
# Migración desde otros CRM
> Guía paso a paso para migrar tus datos desde cualquier CRM a Twenty.
## Resumen
Esta guía te lleva paso a paso para migrar tus datos desde cualquier CRM a Twenty. El proceso implica auditar tus datos, preparar tu espacio de trabajo de Twenty, exportar desde tu sistema actual e importar en Twenty.
Las vistas, los flujos de trabajo y los permisos deben recrearse manualmente después de la migración. Planifica tiempo para este trabajo de configuración.
## Paso 1: Audita tus datos actuales
La migración es una oportunidad para un nuevo comienzo. No migres datos innecesarios.
**Qué conservar:**
* Contactos y empresas activos
* Oportunidades y negocios abiertos
* Notas y actividades importantes
* Campos personalizados que realmente usas
**Qué dejar atrás:**
* Contactos obsoletos (sin actividad en 2 o más años)
* Registros duplicados
* Datos de prueba
* Campos personalizados no utilizados
## Paso 2: Mapea tu modelo de datos
Crea un documento de mapeo entre tu CRM actual y Twenty:
| Tu CRM | Twenty |
| --------------------- | ------------------------ |
| Cuenta / Organización | **Empresa** |
| Contacto / Persona | **Personas** |
| Negocio / Oportunidad | **Oportunidad** |
| Actividad | **Tarea** o **Nota** |
| Objeto personalizado | **Objeto personalizado** |
**Para cada campo, documenta:**
* El nombre del campo de origen
* El campo de destino en Twenty
* Cualquier transformación de formato necesaria (fechas, números de teléfono, etc.)
Mantén este documento de asignación a mano durante la importación—lo consultarás al asignar columnas.
## Paso 3: Configura tu espacio de trabajo en Twenty
Antes de importar datos, prepara tu espacio de trabajo en Twenty:
### Crea objetos y campos personalizados
1. Ve a **Configuración → Modelo de datos**
2. Crea los objetos personalizados que necesites
3. Añade campos personalizados a los objetos estándar y personalizados
4. Configura los ajustes de los campos (único, obligatorio, opciones de selección, etc.)
**Los campos deben existir antes de la importación.**
La importación de CSV crea registros, no campos. Crea todos los campos personalizados en Configuración → Modelo de datos antes de importar.
### Invita a tu equipo
**Invita a los usuarios ANTES de importar datos.**
Si tus datos incluyen referencias a usuarios (propietario de la cuenta, asignado, etc.), esos usuarios deben existir en Twenty antes de la importación. De lo contrario, esas relaciones no se podrán asignar.
1. Ir a **Ajustes → Miembros**
2. Invita a todos los miembros del equipo
3. **Espera a que todos acepten** su invitación
4. Verifica que todos los usuarios aparezcan en tu lista de miembros
## Paso 4: Exporta desde tu CRM actual
Exporta tus datos desde tu CRM actual:
1. Busca una función de **Exportar** (generalmente en Configuración, Gestión de datos o Administración)
2. Exporta al **formato CSV** cuando sea posible
3. Exporta cada tipo de objeto por separado (Empresas, Contactos, Negocios, etc.)
4. Incluye todos los campos que quieras migrar
**Exporta estos objetos (en este orden como referencia):**
1. Empresas / Cuentas / Organizaciones
2. Contactos / Personas
3. Negocios / Oportunidades
4. Notas y actividades
5. Objetos personalizados
## Paso 5: Limpia y da formato a tus datos
Abre cada CSV exportado en una aplicación de hojas de cálculo y prepáralo para Twenty.
### Elimina duplicados
1. Ordena por el campo único (correo electrónico para Personas, dominio para Empresas)
2. Elimina o combina filas duplicadas
3. Verifica que no existan duplicados ya en Twenty
### Da formato a los campos correctamente
| Tipo de campo | Formato requerido |
| ----------------------- | -------------------------------------------------------- |
| **Dominio** | `https://domain.com` |
| **Correo Electrónico** | `name@domain.com` (debe ser único) |
| **Fecha** | `YYYY-MM-DD` |
| **Teléfono** | Tres columnas: número, código de país, código de llamada |
| **Booleano** | `TRUE` o `FALSE` (mayúsculas) |
| **Campos de selección** | Usa nombres de API, no etiquetas visibles |
**El formato del dominio es fundamental.**
Usa `https://domain.com` (no `domain.com` ni `www.domain.com`). Esto coincide con el formato de Twenty y evita duplicados cuando conectas la sincronización de correo/calendario.
Consulta [Cómo preparar tus archivos CSV](/l/es/user-guide/data-migration/how-tos/prepare-your-csv-files) para conocer los requisitos de formato completos para todos los tipos de campos.
### Añade columnas de relación
Para vincular registros (p. ej., Personas con Empresas), añade una columna con el identificador único del registro padre.
**Ejemplo: CSV de Personas con vínculo a Empresa**
```csv theme={null}
firstName,lastName,email,companyDomain
John,Smith,john@acme.com,https://acme.com
Jane,Doe,jane@widgets.co,https://widgets.co
```
Consulta [Cómo importar relaciones](/l/es/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) para obtener instrucciones detalladas sobre cómo vincular registros.
### Actualiza las referencias de usuario
Si tus datos incluyen asignaciones de usuarios (propietario, asignado):
1. Añade una columna con el **correo electrónico del usuario** (no solo su ID del sistema anterior)
2. Usa las mismas direcciones de correo electrónico que los usuarios utilizaron para unirse a tu espacio de trabajo en Twenty
Consulta [Cómo preparar tus archivos CSV](/l/es/user-guide/data-migration/how-tos/prepare-your-csv-files) para obtener la guía de formato completa.
## Paso 6: Importa a Twenty
**¡El orden de importación importa!**
Importa siempre en este orden:
1. **Empresas** primero (sin dependencias)
2. **Personas** en segundo lugar (enlazadas a Empresas)
3. **Oportunidades** en tercer lugar (enlazadas a Empresas/Personas)
4. **Notas y Tareas** (enlazadas a registros)
5. **Objetos personalizados** siguiendo sus dependencias
El registro padre debe existir antes de que puedas hacer referencia a él.
### Importa cada objeto
Para cada archivo CSV, en orden:
1. Navega hasta el objeto en Twenty
2. Haz clic en **⋮ → Importar registros**
3. Sube el archivo CSV
4. Asocia las columnas a los campos:
* Asocia las columnas de correo electrónico de usuario a los campos de relación correspondientes
* Asocia las columnas de relación (como `companyDomain`) a los campos de relación
5. Revisa y corrige cualquier error en la interfaz
6. Confirma la importación
7. Verifica algunos registros antes de continuar con el siguiente archivo
**Guías detalladas:**
* [Cómo importar Empresas](/l/es/user-guide/data-migration/how-tos/import-companies-via-csv)
* [Cómo importar Contactos](/l/es/user-guide/data-migration/how-tos/import-contacts-via-csv)
* [Cómo importar relaciones](/l/es/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv)
## Paso 7: Migraciones grandes (50.000+ registros)
Para migraciones grandes:
| Volumen | Enfoque recomendado |
| ------------------------- | ------------------------------- |
| Menos de 10.000 registros | Importación en un único CSV |
| 10.000 - 50.000 registros | Divídelo en varios archivos CSV |
| 50.000+ registros | Usa la API |
**Para importaciones mediante la API:**
* Más rápido y fiable para conjuntos de datos grandes
* Admite operaciones por lotes (hasta 60 registros por llamada)
* Consulta [Cómo importar datos mediante la API](/l/es/user-guide/data-migration/how-tos/import-data-via-api)
## Paso 8: Configuración posterior a la migración
Después de importar los datos, completa la configuración de tu espacio de trabajo:
### Recrea las vistas
* Configura vistas guardadas con filtros, ordenaciones y configuraciones de columnas
* Crea cualquier vista de kanban o calendario que necesites
### Recrear flujos de trabajo
* Vuelve a crear tus automatizaciones en **Configuración → Flujos de trabajo**
* Empieza por los flujos de trabajo más críticos
* Prueba cada uno antes de depender de él
### Configura roles y permisos
* Configura los roles en **Configuración → Roles**
* Asigna a los usuarios a los roles adecuados
### Conecta el correo electrónico y el calendario
* Cada usuario conecta su propia cuenta en **Configuración → Cuentas**
* Twenty comenzará a sincronizar los correos electrónicos con los registros de contactos
* Consulta [Correo y calendario](/l/es/user-guide/calendar-emails/overview)
### Capacita a tu equipo
* Recorran juntos la nueva interfaz
* Documenta cualquier proceso específico del equipo
## Problemas Comunes y Soluciones
| Problema | Causa | Solución |
| ---------------------------------- | --------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| **Errores de duplicados** | El correo electrónico/dominio ya existe | Elimina los duplicados del archivo o incluye un identificador único para actualizar los registros existentes |
| **Relación no encontrada** | El registro padre no existe | Importa primero los objetos padre (Empresas antes que Personas) |
| **Campos faltantes** | El campo personalizado no existe | Crea el campo en Configuración → Modelo de datos antes de importar |
| **Errores en campos de selección** | Uso de etiquetas visibles | Usa los nombres de la API (habilita el modo Avanzado en Configuración para encontrarlos) |
| **Relación de usuario vacía** | El usuario no ha aceptado la invitación | Asegúrate de que todos los usuarios acepten las invitaciones antes de importar |
Consulta [Cómo corregir errores de importación](/l/es/user-guide/data-migration/how-tos/fix-import-errors) para obtener pasos detallados de solución de problemas.
## Lista de verificación post-migración
### Integridad de los datos
Todos los registros importados (compara los recuentos con el sistema de origen)
Relaciones funcionando correctamente (Personas vinculadas a Empresas)
Asignaciones de usuario correctas (Propietario, Asignado)
Campos personalizados completados
Sin duplicados inesperados
### Configuración
Vistas recreadas
Flujos de trabajo recreados y probados
Roles y permisos configurados
Sincronización de correo/calendario conectada
### Preparación del equipo
Equipo capacitado en el nuevo sistema
Plan de acceso al CRM antiguo decidido (¿mantenerlo como referencia? ¿Cuándo deshabilitarlo?)
## Preguntas frecuentes
Actualmente no. Los flujos de trabajo deben recrearse manualmente en Twenty.
Los archivos adjuntos no están incluidos en las exportaciones CSV. Necesitarás volver a subirlos manualmente, migrarlos mediante la API o contactar con nuestro equipo para obtener asistencia.
Sí, recomendamos mantener tu CRM antiguo en funcionamiento hasta que hayas verificado que la migración está completa. Solo ten cuidado de no crear datos nuevos en ambos lugares.
Depende del volumen y la complejidad de los datos. Las migraciones pequeñas (menos de 10.000 registros) pueden realizarse en unas pocas horas. Las migraciones grandes pueden llevar varios días, incluyendo la limpieza de datos y las pruebas.
## ¿Necesitas Ayuda?
Para migraciones complejas o conjuntos de datos grandes:
* **Configuración guiada:** Reserva un paquete de incorporación de 4 horas
* **Servicio de migración completo:** Nuestros socios pueden encargarse de toda la migración
Contacta con [contact@twenty.com](mailto:contact@twenty.com) o explora nuestros [Servicios de implementación](/l/es/user-guide/getting-started/capabilities/implementation-services).