Importación y Exportación de Contactos

Importación Masiva de Contactos

Importación de Archivos CSV y Excel

El sistema proporciona capacidades integrales de importación masiva de contactos para gestión eficiente de contactos:

Formatos de Archivo Admitidos:

Archivos CSV: Formato estándar de valores separados por comas
Archivos Excel: Se admiten formatos .xls y .xlsx
Validación de Archivo: Detección y validación automática de formato
Límites de Tamaño de Archivo: Límites razonables de tamaño de archivo para rendimiento

Resumen del Proceso de Importación:

Carga de Archivo: Cargar archivos de contactos a través de la interfaz de carga masiva
Análisis de Encabezados: Detección y análisis automáticos de encabezados de archivo
Mapeo de Campos: Mapear columnas de archivo a campos de base de datos de contactos
Importación de Datos: Procesamiento por lotes para creación eficiente de contactos

Autorización de Importación:

Se requieren permisos de creación de contactos para operaciones de importación
Control de acceso basado en equipo para funcionalidad de importación
Se requiere autenticación de usuario para todas las operaciones de importación
Verificaciones de autorización antes de procesar archivos de importación

Flujo de Trabajo de Importación

El proceso de importación de contactos sigue un flujo de trabajo estructurado:

Paso 1: Carga y Análisis de Archivo

Cargar archivos CSV o Excel a través del modal de carga masiva
Validación automática de formato de archivo (solo csv, xls, xlsx)
Extracción de encabezados y cálculo de conteo de filas
Análisis de archivo con manejo de errores para formatos inválidos

Paso 2: Configuración de Mapeo de Campos

Visualización de encabezados de archivo detectados para mapeo
Campos de contacto disponibles presentados para selección de mapeo
Validación de mapeo para prevenir asignaciones duplicadas de columnas
Opción para mapear todos los encabezados o solo columnas requeridas

Paso 3: Procesamiento e Importación de Datos

Transformación de datos de contacto usando objetos ContactDTO
Procesamiento por lotes para operaciones eficientes de base de datos (100 contactos por lote)
Respaldo de creación individual de contactos para operaciones de lote fallidas
Seguimiento de éxito de importación con conteo total de importados

Importación de Pipedrive (Personas y Organizaciones)

Cargue la exportación de "Personas" de Pipedrive (CSV/XLS/XLSX) desde el diálogo Contactos → Carga/Importación Masiva bajo la pestaña "Pipedrive: Personas".

Lo que se importa:

Contactos (de Personas): nombre, correo electrónico, teléfono, nombre de empresa y campos básicos
Enlace opcional a cliente existente por nombre de empresa

Comportamiento:

El mapeo idempotente se mantiene internamente; los duplicados no están bloqueados para mantener las importaciones flexibles
Se muestra un resumen (creados/actualizados/omitidos) después de la finalización

Para Clientes (de Organizaciones), abra Clientes → Carga/Importación Masiva y use la pestaña "Pipedrive: Organizaciones" para importar datos de organización/empresa en Clientes. Formatos admitidos: CSV, XLS, XLSX.

Mapeo de Campos de Importación

Mapear Columnas de Archivo a Campos de Contacto

El sistema de mapeo de campos proporciona asignación flexible de columna a campo:

Configuración de Mapeo:

Índice de Columna: Índice numérico de columnas en el archivo cargado
Nombre de Columna: Nombre de encabezado original del archivo cargado
Columna Mapeada: Campo de contacto objetivo para asignación de datos
Validación de Mapeo: Especificación de mapeo requerida para todas las columnas usadas

Campos de Contacto Disponibles:

Todos los campos de contacto estándar disponibles para mapeo a través de ContactDTO
Campos personales: first_name, last_name, email, phone, birth_date
Campos empresariales: company_name, website, description
Campos de dirección: address_line_1, city, zip, country
Campos sociales: skype, telegram, linkedin
Campos del sistema: client_id, outreach_id, company_id

Reglas de Validación de Mapeo:

Mapeos Requeridos: Cada mapeo debe especificar índice y columna mapeada
Prevención de Duplicados: El mismo campo de contacto no se puede mapear a múltiples columnas
Validación de Columna: Las columnas mapeadas deben ser campos de contacto válidos
Validación de Índice: Los índices de columna deben ser enteros válidos

Características Avanzadas de Mapeo

El sistema de mapeo incluye validación sofisticada y prevención de errores:

Validación de Mapeo:

Detección de Duplicados: Previene mapear múltiples columnas de archivo al mismo campo de contacto
Mapeo Completo: Valida que se especifiquen todos los mapeos requeridos
Consistencia de Columna: Asegura que las columnas mapeadas existan en la lista de campos de contacto
Completitud de Mapeo: Valida que todos los encabezados de archivo tengan asignaciones de mapeo

Prevención de Errores:

La validación del frontend previene configuraciones de mapeo inválidas
Retroalimentación de validación en tiempo real durante la configuración de mapeo
Mensajes de error claros para conflictos de mapeo
Validación de mapeo antes de que comience el procesamiento de importación

Opciones de Mapeo Flexibles:

El mapeo de campos opcionales permite importación parcial de datos
El mapeo de columnas vacías omite columnas de archivo no usadas
El mapeo flexible admite varias estructuras de archivo
Integración de campos personalizados para mapeo de datos extendido

Validación de Importación

Validación de Datos y Manejo de Errores

El sistema de importación incluye validación integral y manejo de errores:

Validación de Archivo:

Validación de Formato: Solo se aceptan archivos CSV, XLS y XLSX
Estructura de Archivo: Detección y validación de fila de encabezados
Integridad de Datos: Validación de datos fila por fila durante el procesamiento
Recuperación de Errores: Manejo elegante de errores de análisis de archivo

Validación de Datos Durante la Importación:

Validación de Datos de Contacto: Cada contacto validado contra reglas de creación de contactos
Verificación de Campos Requeridos: Requisito de nombre aplicado durante la importación
Validación de Formato de Correo Electrónico: Direcciones de correo electrónico validadas para formato adecuado
Validación de Longitud de Campo: Límites de longitud de campo aplicados durante la importación

Manejo de Errores de Importación por Lotes:

Procesamiento por Lotes: 100 contactos procesados por lote para eficiencia
Recuperación de Fallos de Lote: Respaldo de creación individual de contactos para lotes fallidos
Seguimiento de Éxito: Se mantiene conteo de contactos importados exitosamente
Aislamiento de Errores: Los contactos fallidos no previenen importación exitosa de contactos

Recuperación de Errores de Importación

El sistema proporciona mecanismos robustos de recuperación de errores:

Beneficios del Procesamiento por Lotes:

Importaciones grandes procesadas en lotes manejables
Los fallos de lote no previenen que otros lotes tengan éxito
Eficiencia de memoria para operaciones de importación de contactos grandes
Optimización de rendimiento para operaciones masivas

Respaldo de Contacto Individual:

Las operaciones de lote fallidas recurren a creación individual de contactos
Los errores de contacto individual se registran pero no detienen el proceso de importación
El éxito parcial de importación permite máxima finalización de importación de contactos
Registro detallado de errores para solución de problemas de contactos fallidos

Informes de Errores:

Contactos fallidos registrados con información detallada de errores
Conteo de éxito de importación proporcionado para verificación
Mensajes de error devueltos para retroalimentación del usuario
Registro integral para depuración de problemas de importación

Exportación de Contactos

Exportar Datos de Contacto para Uso Externo

El sistema de contactos admite exportación de datos para análisis externo y respaldo:

Integración de Exportación:

Datos de contacto disponibles a través de APIs de búsqueda y filtrado
Exportación en formato JSON para integración de API
Los resultados de búsqueda de contactos se pueden exportar programáticamente
Filtrado de exportación basado en equipo para control de acceso adecuado

Estructura de Datos de Exportación:

Datos de contacto exportados con todos los campos estándar
Valores de campos personalizados incluidos en datos de exportación
Información de relaciones con clientes incluida
Datos de asociación de pipeline disponibles en exportaciones

Control de Acceso de Exportación:

Las operaciones de exportación requieren permisos de contacto apropiados
El filtrado basado en equipo asegura acceso adecuado a datos
Filtrado de propiedad de usuario disponible para exportaciones restringidas
Verificaciones de autorización para todas las operaciones de exportación

Características y Capacidades de Exportación

La exportación de contactos se integra con funcionalidad más amplia del sistema:

Exportación Basada en Búsqueda:

Exportar listas de contactos filtradas basadas en criterios de búsqueda
Exportación de contactos específica del equipo con control de acceso adecuado
Los datos de contacto incluyen relaciones y asociaciones
Exportación flexible basada en permisos y acceso de usuario

Integración de API:

Datos de contacto disponibles a través de endpoints de API para integración externa
Formato JSON para fácil integración con sistemas externos
Funcionalidad de búsqueda admite acceso programático a contactos
Capacidades de exportación de datos de contacto en tiempo real

Registro de Importación

Seguimiento y Depuración de Operaciones de Importación

El sistema de importación incluye registro integral para monitoreo y depuración:

Registro del Proceso de Importación:

Registro de Analizador de Archivos: Canal de registro dedicado file-parser para procesamiento de archivos
Registro de Importación de Contactos: Canal de registro dedicado contacts para operaciones de importación
Procesamiento de Filas: Procesamiento de filas individuales registrado para depuración
Registro de Mapeo: Configuración de mapeo de campos registrada para verificación
Registro de Importación de Pipedrive: Claves de fila, valores analizados y acciones de upsert registradas para solución de problemas

Información Detallada de Registro:

Procesamiento de Archivos: Encabezados de archivo, conteos de filas y resultados de análisis
Datos de Mapeo: Configuración de mapeo completa y mapeos aplicados
Datos de Contacto: Transformación y creación de datos de contacto individuales
Operaciones por Lotes: Resultados de procesamiento por lotes y seguimiento de éxito/fallo

Registro de Errores y Depuración:

Errores de Análisis de Archivos: Registro detallado de errores para fallos de procesamiento de archivos
Fallos de Importación: Registro integral de errores para importaciones de contactos fallidas
Errores de Contacto Individual: Mensajes de error específicos para creación de contacto fallida
Registro de Seguimiento de Pila: Contexto completo de errores para depuración

Monitoreo y Análisis de Importación

El sistema de registro admite monitoreo de importación y análisis de rendimiento:

Monitoreo de Rendimiento:

Rendimiento por Lotes: Monitoreo de eficiencia de procesamiento por lotes
Tasas de Éxito de Importación: Seguimiento de importaciones exitosas vs. fallidas
Tiempo de Procesamiento: Métricas de rendimiento para operaciones de importación
Patrones de Errores: Análisis de patrones comunes de fallos de importación

Análisis de Importación:

Volumen de Importación: Seguimiento de volúmenes de importación de contactos a lo largo del tiempo
Métricas de Éxito: Análisis de tasas de éxito de importación y patrones
Análisis de Errores: Identificación de problemas comunes de importación
Optimización de Rendimiento: Datos para optimizar procesos de importación

Soporte de Solución de Problemas:

Contexto Detallado de Errores: Información completa de errores para resolución de problemas
Seguimiento de Importación: Rastro de auditoría completo de operaciones de importación
Registro de Validación de Datos: Seguimiento y análisis de fallos de validación
Monitoreo de Salud del Sistema: Seguimiento de rendimiento y confiabilidad del sistema de importación