Importar Leads
Puedes importar leads en masa desde un archivo CSV a tu espacio de trabajo. El importador mapea las columnas CSV a los campos de leads y crea registros de leads en segundo plano.
Paso 1 — Preparar tu CSV
Tu archivo CSV debe:
- Tener una fila de encabezado (nombres de columnas en la primera fila)
- Usar codificación UTF-8
- Estar separado por comas (no tabulaciones ni punto y coma)
Columnas Admitidas
Mapea las columnas de tu CSV a estos campos de lead:
| Nombre de Columna CSV (sugerido) | Campo del Lead |
|---|---|
first_name | Nombre |
last_name | Apellido |
email | Correo Electrónico |
phone | Teléfono |
company | Nombre de empresa (crea una empresa si no existe) |
status | Estado (new, contacted, qualified, converted, lost) |
source | Fuente del lead |
lead_score | Puntuación |
deal_value | Valor de Negociación |
tags | Nombres de etiquetas separados por comas |
notes | Notas (texto plano) |
Las columnas no reconocidas se ignoran. Las columnas sin mapear se pueden mapear manualmente durante la importación.
Paso 2 — Iniciar la Importación
- Ve a Leads → Importar Leads en la barra lateral.
- Haz clic en Nueva Importación.
- Sube tu archivo CSV.
Paso 3 — Mapear Columnas
El importador muestra una vista previa de tu CSV y te permite mapear cada columna a un campo de lead:
- Para cada columna CSV, selecciona el campo de lead correspondiente del menú desplegable.
- Para las columnas que deseas omitir: déjalas en "No importar".
- Revisa la fila de muestra para confirmar que el mapeo es correcto.
- Haz clic en Iniciar Importación.
Paso 4 — Monitorear el Progreso
La importación se ejecuta en segundo plano (a través de la cola). Una barra de progreso muestra:
- Total de filas
- Filas procesadas
- Importaciones exitosas
- Filas omitidas (duplicados o datos no válidos)
- Errores
Manejo de Duplicados
- Si ya existe un lead con el mismo correo electrónico en tu espacio de trabajo, la fila se omite (no se actualiza).
- Las filas sin correo electrónico se importan como nuevos leads.
Historial de Importaciones
Todas las importaciones anteriores se listan en Leads → Importar Leads. Haz clic en cualquier importación para ver su estado y detalles de errores.
Problemas Comunes
| Problema | Solución |
|---|---|
| "Formato CSV no válido" | Asegúrate de que el archivo sea UTF-8 separado por comas |
| Muchas filas omitidas | Verifica correos duplicados en tu espacio de trabajo |
| Campos sin mapear | Verifica la ortografía de la fila de encabezado; mapea manualmente en la pantalla de mapeo |
| Importación detenida | Comprueba que el cron job esté funcionando (Super Admin → Estado del Sistema) |
Consejos
- Siempre prueba con un archivo pequeño (10-20 filas) antes de importar miles de leads.
- Incluye
statusen tu CSV para evitar que todos los leads sean "Nuevo" por defecto. - Usa valores de
sourceconsistentes para poder filtrar por fuente después de la importación.