> ## Documentation Index
> Fetch the complete documentation index at: https://docs.meetzy.es/llms.txt
> Use this file to discover all available pages before exploring further.
# Importar Contactos
> Importa contactos desde archivos Excel o Google Sheets con funcionalidades avanzadas
# Importar Contactos
Meetzy te permite importar contactos de forma masiva desde archivos Excel (.xlsx, .xls, .xlsm) o directamente desde Google Sheets. Esto te permite poblar rápidamente tu base de datos de contactos para campañas con características avanzadas de validación y configuración.
## Métodos de Importación
| Método | Descripción | Requisitos |
| ---------------- | ------------------------------------------- | ----------------------------- |
| 📊 Excel | Sube archivos .xlsx, .xls o .xlsm | Archivo hasta 10MB |
| 📗 Google Sheets | Conecta directamente a tus hojas de cálculo | Integración con cuenta Google |
## Nueva Interfaz de Usuario
La experiencia de importación ha sido rediseñada con una interfaz moderna que incluye:
* **Panel de consumo Billy**: Monitorea en tiempo real el consumo de recursos durante la importación
* **Indicadores visuales mejorados**: Estados de progreso más claros y detallados
* **Validación avanzada**: Detección automática de errores y sugerencias de corrección
* **Configuración de horarios**: Programa cuándo realizar las llamadas automáticas
El nuevo panel de consumo aparece automáticamente durante importaciones grandes para ayudarte a monitorear el uso de recursos.
## Asistente de Importación Mejorado
El proceso de importación sigue pasos optimizados:
Elige tu archivo fuente u hoja de cálculo con validación instantánea.
Mapea columnas, establece opciones avanzadas y configura protocolos de rellamada.
Define horarios de llamadas y estrategias de reintento.
Procesa contactos con monitoreo en tiempo real.
## Importación desde Excel
### Subiendo un Archivo
1. Navega a **CRM** → **Import Contacts**
2. Selecciona **Import from Excel**
3. Arrastra y suelta tu archivo o haz clic para buscar
4. Formatos soportados: `.xlsx`, `.xls`, `.xlsm`
5. Tamaño máximo de archivo: 10MB
El nuevo sistema de arrastrar y soltar incluye indicadores visuales mejorados. El borde se vuelve verde cuando se detecta un archivo válido y muestra una vista previa instantánea de la estructura.
### Validación Avanzada del Archivo
Una vez subido, el sistema realiza análisis profundo:
| Análisis | Descripción |
| ------------------ | ----------------------------------------------------------------- |
| Total Rows | Número de filas de datos detectadas |
| Valid Phones | Filas con números de teléfono válidos (con formato internacional) |
| Duplicates | Números duplicados con opción de deduplicación automática |
| No Phone | Filas sin número válido con sugerencias de corrección |
| Data Quality Score | Puntuación de calidad basada en completitud de campos |
El sistema ahora detecta automáticamente formatos de teléfono incorrectos y sugiere correcciones. Las filas con problemas graves serán marcadas para revisión manual.
## Importación desde Google Sheets Mejorada
### Conectando Google Sheets
Si no está conectado:
1. Haz clic en **Connect Google Sheets**
2. Autoriza con tu cuenta de Google
3. Otorga acceso ampliado a hojas de cálculo
4. **Nuevo**: Sincronización en tiempo real disponible
### Seleccionando una Hoja de Cálculo
1. Navega por tus hojas con vista previa mejorada
2. Usa la búsqueda inteligente para encontrar archivos
3. **Nuevo**: Acceso a hojas compartidas del equipo
4. Validación automática de estructura y permisos
## Mapeo de Columnas Inteligente
### Campos Estándar Expandidos
| Campo | Descripción | Requerido | Nuevo |
| --------- | ------------------------------------------ | --------- | ----------------------- |
| Phone | Número de teléfono (formato internacional) | ✅ Sí | Validación mejorada |
| Name | Nombre completo o separado | No | Auto-combinación |
| Email | Email con validación de formato | No | Verificación de dominio |
| Company | Empresa del contacto | No | ✅ Campo expandido |
| Job Title | Cargo profesional | No | ✅ Nuevo campo |
| City | Ciudad de residencia | No | ✅ Nuevo campo |
| Country | País (formato ISO) | No | ✅ Nuevo campo |
| Timezone | Zona horaria para llamadas | No | ✅ Nuevo campo |
### Mapeo Automático
El sistema ahora incluye:
1. **Detección inteligente**: Reconoce automáticamente columnas comunes
2. **Sugerencias contextuales**: Propone mapeos basados en contenido
3. **Validación en tiempo real**: Muestra errores antes de importar
4. **Preservación de datos**: Mantiene campos personalizados intactos
El nuevo motor de mapeo utiliza IA para reconocer patrones de datos y sugerir la configuración óptima automáticamente.
## Configuración de Protocolos de Rellamada
### Modos de Configuración
Programa llamadas en fechas y horarios exactos:
* Fecha y hora de inicio de campaña
* Hasta 5 reintentos programados
* Validación de horarios comerciales
* Ajuste automático por zona horaria
Define intervalos automáticos entre llamadas:
* Retraso inicial configurable
* Incremento progresivo de intervalos
* Límite máximo de intentos
* Filtros por días laborables
### Configuración de Horarios
```json theme={null}
{
"campaignStart": "2024-03-15T09:00:00",
"retryAttempts": [
{
"date": "2024-03-15",
"time": "14:00",
"timezone": "Europe/Madrid"
},
{
"delay": 24,
"unit": "hours"
}
],
"businessHours": {
"start": "09:00",
"end": "18:00",
"timezone": "local"
}
}
```
## Plantillas de Rellamada
### Plantillas Predefinidas
| Plantilla | Descripción | Intentos |
| ---------------- | ---------------------------------------- | ----------------------- |
| 🚀 Agresiva | Llamadas frecuentes para leads calientes | 5 intentos en 48h |
| 📞 Estándar | Protocolo equilibrado para uso general | 3 intentos en 1 semana |
| 🕐 Pausada | Contacto espaciado para leads fríos | 2 intentos en 2 semanas |
| 🎯 Personalizada | Configura tu propio protocolo | Hasta 10 intentos |
### Crear Plantillas Personalizadas
Define horarios y frecuencia de rellamadas.
Asigna un nombre descriptivo y descripción.
La plantilla estará disponible para futuras campañas.
## Panel de Consumo Billy
Durante importaciones grandes, aparece automáticamente el panel de monitoreo:
### Métricas en Tiempo Real
* **Consumo por período**: Uso de minutos facturables
* **Breakdown por asistente**: Detalle de consumo por agente
* **Proyección de costos**: Estimación de facturación
* **Filtros temporales**: Vista por períodos personalizables
### Controles de Filtrado
1. **Período**: Selecciona rango temporal (mes actual, trimestre, personalizado)
2. **Fecha personalizada**: Define inicio y fin específicos
3. **Actualización automática**: Datos en tiempo real durante importación
Las importaciones masivas (>5,000 contactos) pueden generar costos significativos. Utiliza el panel de consumo Billy para monitorear el gasto en tiempo real.
## Asignación Avanzada a Segmentos
### Segmentación Inteligente
* **Auto-segmentación**: Crea segmentos basados en criterios de los datos
* **Segmentos múltiples**: Asigna contactos a varios segmentos simultáneamente
* **Etiquetado dinámico**: Genera tags automáticos basados en contenido
### Reglas de Segmentación
```javascript theme={null}
// Ejemplo de regla de auto-segmentación
{
"criteria": {
"city": "Madrid",
"company": "*Tech*"
},
"segment": "Madrid Tech Companies",
"tags": ["madrid", "technology", "b2b"]
}
```
## Funcionalidades Admin Expandidas
Para usuarios administradores:
### Gestión Multi-Empresa
1. **Selector de empresa mejorado**: Búsqueda y filtrado avanzado
2. **Importación cruzada**: Mueve contactos entre empresas
3. **Auditoría completa**: Registro de todas las acciones de importación
4. **Permisos granulares**: Control de acceso por empresa y segmento
### Monitoreo del Sistema
* Dashboard de importaciones activas
* Alertas de consumo excesivo
* Reportes de calidad de datos
* Métricas de rendimiento del sistema
## Proceso de Importación Optimizado
### Importación en Paralelo
El sistema ahora procesa importaciones en múltiples hilos:
1. **Validación paralela**: Verifica datos mientras se cargan más filas
2. **Procesamiento asíncrono**: No bloquea la interfaz durante importaciones grandes
3. **Reintentos automáticos**: Reintenta filas con errores temporales
4. **Checkpoint system**: Guarda progreso para recuperación en caso de interrupción
### Duración Optimizada
| Tamaño | Tiempo Estimado | Método |
| ------------------ | --------------- | ------------------------- |
| \< 1,000 contactos | \< 30 segundos | Procesamiento inmediato |
| 1,000 - 5,000 | 1-3 minutos | Procesamiento en lotes |
| 5,000 - 20,000 | 5-15 minutos | Procesamiento paralelo |
| > 20,000 | 15-60 minutos | Procesamiento distribuido |
## Reporte de Importación Detallado
### Métricas Completas
| Métrica | Descripción |
| ------------ | ----------------------------------------- |
| ✅ Imported | Nuevos contactos creados exitosamente |
| 🔄 Updated | Contactos existentes actualizados |
| ⏭️ Skipped | Filas omitidas con razón específica |
| ❌ Failed | Errores que requieren intervención manual |
| 🎯 Segmented | Contactos asignados a segmentos |
| 📱 Validated | Números de teléfono verificados |
| 🏷️ Tagged | Tags automáticos aplicados |
### Análisis de Calidad
* **Puntuación de calidad general**: 0-100 basada en completitud
* **Distribución geográfica**: Mapa de ubicaciones de contactos
* **Análisis de dominio**: Tipos de empresas más comunes
* **Recomendaciones**: Sugerencias para mejorar futuras importaciones
### Exportar Reportes
* PDF detallado con gráficos y métricas
* CSV con filas procesadas y resultados
* JSON para integración con sistemas externos
* Excel con múltiples hojas por categoría de resultado
## Mejores Prácticas Actualizadas
Utiliza las nuevas herramientas de validación previa para garantizar calidad de datos antes de importar.
Aprovecha la configuración de zona horaria para optimizar tasas de respuesta.
Usa el panel Billy para controlar gastos durante importaciones grandes.
Crea segmentos específicos para campañas más efectivas.
Desarrolla y guarda protocolos de seguimiento para diferentes tipos de leads.
Revisa reportes de calidad para mejorar continuamente tus procesos.
## Solución de Problemas Avanzada
| Problema | Causa Común | Solución Mejorada |
| ---------------------------- | ------------------------------------ | --------------------------------------------------------------- |
| "Billy consumption exceeded" | Límite de facturación alcanzado | Contactar soporte o ajustar límites en configuración |
| "Timezone validation failed" | Formato de zona horaria incorrecto | Usar formato estándar (ej: Europe/Madrid, America/Mexico\_City) |
| "Recall protocol conflict" | Horarios de rellamada solapados | El sistema ahora auto-resuelve conflictos con sugerencias |
| "Segment capacity full" | Segmento ha alcanzado límite máximo | Crear nuevos segmentos o expandir capacidad |
| "Import queue full" | Demasiadas importaciones simultáneas | Sistema de cola inteligente - se procesará automáticamente |
| "Data quality score low" | Muchos campos vacíos o inválidos | Usar las sugerencias del analizador de calidad |
## Integrations y APIs
### Webhook de Importación
Configura webhooks para recibir notificaciones:
```json theme={null}
{
"event": "import.completed",
"import_id": "imp_123456",
"status": "success",
"stats": {
"imported": 1250,
"updated": 45,
"skipped": 12,
"failed": 3
},
"timestamp": "2024-03-15T10:30:00Z"
}
```
### API de Estado
Consulta el progreso programáticamente:
```bash theme={null}
GET /api/v1/imports/{import_id}/status
Authorization: Bearer {token}
```
## Siguientes Pasos
Ve y edita tus contactos importados con herramientas avanzadas.
Organiza contactos con reglas inteligentes de segmentación.
Crea campañas con los contactos importados y protocolos configurados.