--- title: Importacion Masiva slug: importacion-masiva docTags: createdAt: 2026-01-08T16:36:34.366Z --- **Tiempo:** 15-30 minutos | **Requiere:** Rol de Administrador y addon CRM activo *** ## Resumen rapido Si ya conoces el proceso: 1. Configuracion CRM (menu lateral) → Pestana Importar 2. Selecciona tipo: Combinado, Empresas o Contactos 3. Arrastra tu archivo CSV/XLSX (max 50MB, 50,000 registros) 4. Mapea columnas con Auto-mapear y ajusta manualmente 5. Configura deduplicacion y vinculacion empresa-contacto 6. Ejecuta validacion dry-run y corrige errores 7. Confirma importacion y descarga reporte de errores si los hay Primera vez? Sigue leyendo. *** ## Antes de empezar | Requisito | Como verificar | | --------------------- | ------------------------------------------------------------ | | **Addon CRM activo** | El menu lateral muestra opciones de Contactos/Empresas | | **Rol Administrador** | Los usuarios regulares no pueden acceder a Configuracion CRM | | **Archivo preparado** | CSV o Excel (.xlsx, .xls) con encabezados en primera fila | **Limites:** 50 MB por archivo, 50,000 filas maximo. *** ## Paso a paso ### 1. Acceder al modulo de importacion Navega a **Configuracion** (icono engranaje) → **CRM** → Pestana **Importar** *** ### 2. Seleccionar tipo de importacion | Tipo | Descripcion | Cuando usarlo | | --------------------------- | ----------------------------------- | ------------------------------------ | | **Combinado** (recomendado) | Importa contactos y empresas juntos | Tienes columna "Empresa" en tu lista | | **Empresas** | Solo empresas/organizaciones | Carga inicial de cartera B2B | | **Contactos** | Solo personas individuales | Las empresas ya estan cargadas | *** ### 3. Subir el archivo Arrastra tu archivo a la zona de carga o haz clic para seleccionarlo. El sistema detecta automaticamente el delimitador para CSV (coma, punto y coma, tabulador, pipe). *** ### 4. Revisar vista previa Verifica que el archivo se lea correctamente: - Conteo de registros coincide con tus filas - Las 5 primeras filas muestran datos correctos - Si se ve mal, cambia el delimitador manualmente *** ### 5. Mapear columnas Asocia cada columna de tu archivo con el campo correspondiente en AsisteCRM. **Auto-mapeo:** Haz clic en **Auto-mapear** para sugerencias automaticas basadas en nombres de columna. **Manual:** Para cada columna, selecciona el campo destino del dropdown. | Tipo de importacion | Campo obligatorio | | --------------------- | ------------------------------ | | Contactos / Combinado | display\_name (Nombre) | | Empresas | company\_name (Nombre empresa) | :::BlockQuote **Tip:** Si tienes "Nombre" y "Apellido" separados, mapea ambos. El sistema los combina. ::: *** ### 6. Configurar politicas de datos ### Campos referenciados (FK) Cuando mapeas "Tipo de contacto", "Industria", etc., define que hacer si el valor no existe: | Politica | Comportamiento | | ---------------- | ------------------------------ | | **Crear** | Crea el valor automaticamente | | **Dejar vacio** | Guarda NULL | | **Saltar fila** | No importa el registro | | **Usar default** | Usa el primer valor disponible | **Mapear valores:** Si tu archivo dice "Tech" pero quieres "Tecnologia", usa el boton "Mapear valores". ### Vinculacion con empresa (solo Contactos/Combinado) | Opcion de busqueda | Descripcion | | ---------------------- | ------------------------------- | | Por nombre | Usa la columna "Nombre Empresa" | | Por dominio | Extrae dominio del email | | Por referencia externa | ID de tu sistema anterior | **Si no encuentra:** Dejar sin empresa, Crear nueva, o Saltar contacto. ### Deduplicacion | Campo de deteccion | Recomendado para | | ------------------ | --------------------------- | | Email principal | Contactos (mas confiable) | | Nombre empresa | Empresas con datos limpios | | Telefono | Cuando no hay emails | | ID Fiscal | Empresas con datos fiscales | | Estrategia | Comportamiento | | --------------- | ------------------------------- | | **Saltar** | No importa el duplicado | | **Actualizar** | Actualiza el registro existente | | **Crear igual** | Crea duplicado (no recomendado) | *** ### 7. Validar datos (Dry-run) El sistema valida todos los registros antes de importar: | Categoria | Significado | | --------------------------- | --------------------------- | | **Validos** (verde) | Se importaran sin problemas | | **Advertencias** (amarillo) | Se importaran con ajustes | | **Errores** (rojo) | NO se importaran | ### Errores comunes | Codigo | Causa | Solucion | | ------------------- | ----------------------- | ------------------------------------------------------------ | | REQUIRED\_MISSING | Campo obligatorio vacio | Completa el campo | | INVALID\_EMAIL | Formato incorrecto | Corrige a [usuario@dominio.com](mailto\:usuario@dominio.com) | | DUPLICATE\_FOUND | Ya existe | Cambia estrategia o elimina del archivo | | FK\_NOT\_FOUND | Valor no existe | Cambia politica a "Crear" | | COMPANY\_NOT\_FOUND | Empresa no encontrada | Importa empresas primero | **Descargar errores:** Obten CSV con fila, campo, valor y mensaje de error. *** ### 8. Ejecutar importacion Haz clic en **Importar**. Mantene la pagina abierta durante el proceso. La barra de progreso muestra: - Procesados / Total - Creados, Actualizados, Errores *** ### 9. Revisar resultados | Metrica | Descripcion | | ---------------- | ---------------------- | | **Creados** | Registros nuevos | | **Actualizados** | Existentes modificados | | **Omitidos** | Duplicados saltados | | **Errores** | Fallos de insercion | Si hay errores, haz clic en "Descargar errores" para el reporte detallado. **Acciones:** Ver datos importados, Nueva importacion. *** ## Mapeo tipico por tipo ### Combinado | Columna archivo | Campo destino | | --------------- | ---------------------- | | Empresa | company.company\_name | | Industria | company.industry\_key | | Nombre completo | contact.display\_name | | Email | contact.primary\_email | | Telefono | contact.primary\_phone | ### Empresas Campos clave: company\_name, domain, industry\_key, tax\_id, mrr ### Contactos Campos clave: display\_name, primary\_email, primary\_phone, job\_title, tags *** ## Campos especiales ### Etiquetas (tags) Puedes mapear multiples columnas. Los valores se combinan: ```text Columna "Categoria": VIP Columna "Origen": Web Resultado: ["VIP", "Web"] ``` ### Campos JSON array Campos como `products_owned`, `tech_stack` aceptan valores separados por coma o formato JSON. *** ## Problemas comunes | Problema | Solucion | | ------------------------------ | ------------------------------------------------- | | Archivo excede 50MB | Divide en partes mas pequenas | | Limite 50,000 excedido | Importa en lotes | | Datos mezclados en preview | Cambia delimitador | | Auto-mapeo no detecta columnas | Renombra encabezados (Email, Phone, Company) | | Campo requerido vacio | Verifica mapeo de display\_name/company\_name | | Muchos DUPLICATE\_FOUND | Cambia estrategia a "Actualizar" | | Empresa no encontrada | Importa empresas primero o cambia a "Crear nueva" | | Importacion se detiene | No cierres la pagina | *** ## Preguntas frecuentes **Puedo importar desde Google Sheets?** Exporta como CSV (Archivo → Descargar → CSV). **Que pasa con columnas no mapeadas?** Se ignoran. **Puedo deshacer una importacion?** No hay rollback automatico. Exporta datos antes de importar. **Cuanto tarda?** 1,000 registros \~30 seg, 50,000 \~10 min. *** ## Relacionado - [Gestion de Contactos en AsisteCRM](#) - [Gestion de Empresas en AsisteCRM](#) - [Introduccion a AsisteCRM](#) *** *Ultima actualizacion: Diciembre 2025*