Importar datos: asistente CSV para leads, contactos y relaciones

Tesoro dispone de un asistente de importación integrado. Tres tipos de registros: leads, contactos y relaciones. Mapeo automático de columnas, importación de prueba antes de la definitiva, procesamiento por lotes para archivos grandes. Solo Admin.

¿Cuándo usar esta funcionalidad?

• 500 contactos de un CRM anterior en formato CSV
• Una lista de leads de una campaña de marketing
• Colección de relaciones comerciales (empresas) compilada manualmente

Cuatro tipos de importación

Tipo	Descripción	Navegación
Lead	Leads compradores con seguimiento	Leads → Import
Lead (Owner)	Vendedores con detalles de propiedad	Leads → Import (elija Owner)
Contact	Contactos cualificados	Contacts → Import
Relation	Empresas, socios comerciales	Relations → Import

Descargar archivo de ejemplo

Por cada tipo puede descargar un archivo de ejemplo desde la página de importación, con los encabezados de columna correctos y una fila de ejemplo. Úselo como plantilla para evitar el mapeo manual.

---

Requisitos CSV

Propiedad	Requisito
Tipo	.csv
Tamaño máximo	50 MB
Separador	Coma o punto y coma (detección automática)
Fila de encabezado	Primera fila = encabezados de columna
Codificación	Se recomienda UTF-8

Codificación de Excel

Microsoft Excel guarda por defecto en ANSI, lo que puede causar problemas con acentos/umlauts. Guarde como CSV UTF-8.

Nota

Además de CSV: XML para feeds de propiedades (Settings → XML Import) y JSON para integraciones API.

---

Preparar el CSV: directrices

1. Descargue el archivo de ejemplo y úselo como plantilla
2. Mantenga la fila de encabezado con los nombres de campo correctos de Tesoro
3. UTF-8 para caracteres especiales
4. Campos obligatorios rellenados: de lo contrario, la fila se omite

Números de teléfono

• Formato internacional con código de país: +31612345678
• Los espacios se eliminan automáticamente
• Los paréntesis/guiones pueden dar errores

Múltiples valores en una celda

Separe con coma dentro de la misma celda:

• property_details.type: apartment, villa, townhouse
• property_details.location: Marbella, Estepona, Benahavis

Campos anidados: sintaxis de punto

Prefijo	Se anida bajo	Ejemplo
address.	Dirección	address.city, address.street
lead.	Seguimiento de lead	lead.source, lead.status
property_details.	Preferencias de propiedad	property_details.type, property_details.price_min
property_address.	Dirección de propiedad (vendedores)	property_address.street
timing.	Tiempo	timing.looking_to, timing.timeline_max
social.	Redes sociales (relaciones)	social.facebook, social.linkedIn

---

Campos por tipo de importación

Importación de leads

Datos personales

Columna	Obligatorio
type (siempre lead)	Sí
status	Sí
owner_email	Sí
salutation	No
language	No
first_name, last_name	Sí
email, phone	Sí
additional_information	No

Dirección

Columna
address.city, address.country, address.state, address.street, address.zip_code

Seguimiento de lead

Columna	Valores
lead.source	Website, Referral, Portals, Cold Calling, …
lead.status	New, Contacted, Qualified, Unqualified, Lost, Converted
lead.stage	Hot, Neutral, Cold

Campos de comprador

Columna
property_details.type (múltiples, separados por coma)
property_details.location (múltiples)
property_details.number_of_bedrooms, _bathrooms
property_details.price_min, _max
property_details.size_min, _max, size
property_details.market_price

Campos de vendedor

Columna
commision (comisión%)
way_of_selling
property_address.street, _city, _state, _zip_code, _country, _address_line_2

Tiempo

Columna
timing.looking_to, timing.timeline_max

Importación de contactos

Columna	Obligatorio
type (siempre contact)	Sí
status, owner_email	Sí
salutation, role, language	No
first_name, last_name, email, phone	Sí
additional_information	No
address.*	No
do_not_contact, portal_user (true/false)	No

Importación de relaciones

Columna	Obligatorio
name, type, email, phone_number, status	Sí
website_url, preferred_communication, note, credit_terms	No
address.*	No
social.facebook, social.linkedIn, social.instagram	No

---

El asistente de importación: cuatro pasos

1. Seleccionar archivo: diríjase al tipo correspondiente (Leads/Contacts/Relations → Import).

   Clic para ampliar

   El asistente de importación.

   

   Cargue CSV (máx. 50 MB). En esta página también:

   • Descargar archivo de ejemplo para el tipo (leads: elija entre la variante leads y la variante owners)
   • Abrir historial de importaciones para importaciones anteriores

   Siguiente →

2. Asignar campos (mapeo): Tesoro analiza y muestra por columna:

   • Nombre de columna del archivo
   • Valor de ejemplo de la fila 2
   • Desplegable con campos de Tesoro

   Auto-matching:

   • Nombre exacto (p. ej., first_name)
   • Etiqueta exacta (p. ej., First Name)
   • Coincidencia parcial (no distingue mayúsculas)
   • Mapeo anterior para los mismos nombres de columna

   Todos los campos obligatorios deben estar asignados, de lo contrario no se puede continuar.

   Vista previa → importación de prueba.

3. Validar (vista previa): NO se crean registros. Por cada fila:

   • Número de fila
   • Estado: exitoso / fallido
   • Mensaje de error si falla

   ¿Errores? Vuelva al paso 1, corrija el CSV, cárguelo de nuevo.

   ¿Satisfecho? Haga clic en Import → importación definitiva.

4. Listo: registro de importación con filas exitosas/omitidas. Si es exitoso, enlace al registro creado.

---

Cómo funciona el auto-mapping

Tres estrategias:

1. Coincidencia exacta de valor: first_name coincide con first_name
2. Coincidencia de etiqueta: First Name (etiqueta) coincide
3. Coincidencia parcial: no distingue mayúsculas
4. Mapeo anterior: los mismos nombres de columna que en una importación anterior → se restauran los mapeos

Campos obligatorios por tipo

Tipo	Obligatorio
Lead	first_name, last_name, email, phone, owner_email
Contact	first_name, last_name, email, phone, owner_email
Relation	name, type, email, phone_number, status

owner_email

Hace referencia al usuario de Tesoro (agente), debe existir en su cuenta. Si no coincide, se usa el fallback.

---

Determinar el propietario

1. Columna owner_email → se busca el usuario por cada fila
2. Fallback → primer usuario de su empresa

Relaciones

No tienen owner_email. Las relaciones se vinculan directamente a su empresa.

---

Duplicados: sin detección automática

Tesoro no detecta duplicados durante la importación CSV. Todas las filas se crean, incluso si los emails ya existen.

Evite duplicados:

• Revise su CSV previamente
• Elimine duplicados en el origen
• Use la importación de prueba para ver los conteos
• Combine manualmente después de la importación

Importar dos veces = duplicado

Todos los registros se duplican. Tenga cuidado, use la importación de prueba.

---

Errores comunes

Error	Causa	Solución
Campo obligatorio vacío	first_name, last_name, email vacío	Rellene en el CSV
Email inválido	Sin @ o error tipográfico	Verifique
owner_email inválido	El usuario no existe	Use un usuario existente
Tipo/estado inválido	No está en las opciones permitidas	Compare con el archivo de ejemplo
Número de teléfono inválido	No está en formato internacional	Use +31612345678
Ubicación como cadena	Valores múltiples no separados correctamente	Use coma dentro de la celda
Nombre con números	first_name/last_name contiene caracteres numéricos	Elimínelos

Registro de importación (prueba + definitiva)

Por cada fila:

• Número de fila (desde 2, porque 1 = encabezado)
• Estado (error: 0 o 1)
• Mensaje de error si falla
• Registro creado si es exitoso (recurso + ID)

---

Procesamiento por lotes

Las importaciones se procesan en lotes de 100:

• Los archivos grandes se dividen automáticamente
• Cada lote mediante una tarea en segundo plano
• Progreso en vivo en la interfaz (“150/500 procesados”)
• Sondeo cada 5 segundos

Consejo

Con miles de registros: unos minutos. Mantenga la página abierta para ver el progreso.

---

Historial de importaciones

Abrir historial de importaciones en la página de importación. Tabla:

Columna	Qué es
Nombre del archivo	Nombre del CSV
Total filas	En el archivo
Filas procesadas	Cantidad procesada
Fecha	Cuándo

Paginado (10 por defecto, 10/20/30/40/50 posible), ordenado del más reciente primero.

Nota

Solo importaciones del usuario actual y del tipo de importación actual.

---

Importar propiedades: otra ruta

No mediante el asistente CSV, sino a través de XML feed:

• XML feeds de Kyero para sincronización de feeds de propiedades
• Cargas XML manuales para importaciones únicas

Se configura mediante Settings → XML Import. También se define qué hacer con propiedades que ya no están en el feed (p. ej., estado “Removed by Feed”).

---

Ocho consejos para una importación exitosa

1. Comience con una importación de prueba: el asistente lo hace automáticamente en el paso de vista previa
2. Use el archivo de ejemplo como plantilla: evita problemas de mapeo
3. Números de teléfono internacionales con código de país
4. Direcciones de correo electrónico válidas: de lo contrario, se omiten
5. owner_email debe coincidir con un usuario existente: de lo contrario, fallback
6. Divida archivos grandes: más fáciles de revisar en el registro
7. UTF-8 para caracteres especiales
8. Valores múltiples con coma: no punto y coma dentro de las celdas

---

Pasos siguientes

Resumen de migración Migración completa a Tesoro, realizada por el equipo de Tesoro.

Gestionar contactos Trabaje con los contactos importados.

Gestionar leads Gestione los leads importados a través de su pipeline.