> ## Documentation Index
> Fetch the complete documentation index at: https://help.clientix.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Importar contactos desde un archivo CSV

> Cómo subir de una vez tus leads y clientes desde Excel o Google Sheets, con simulación previa para que no se guarde nada hasta que confirmes.

> [!NOTE]
>
> Requisito: haber completado la [configuración inicial](https://help.clientix.io/configuracion-inicial.md). Pueden importar todas las personas que pueden **crear contactos** (dueño, gerentes, supervisores y vendedores). Lo que importas queda **a tu nombre**.

## Para qué sirve

Si ya tienes tus leads y clientes en Excel o Google Sheets, no hace falta escribirlos uno por uno: los subes en un archivo y Clientix los crea de una vez, junto con sus empresas.

**Siempre se simula primero.** La simulación calcula exactamente qué pasaría (cuántos contactos nuevos, cuáles ya existen y cuáles tienen errores) y **no guarda nada**. Solo cuando confirmas con **Importar ahora** se guardan los datos.

## Prepara tu archivo

1. En Excel o Google Sheets, deja **una fila de encabezados** arriba y un contacto por fila.
2. Guarda como **CSV** (en Excel: *Archivo → Guardar como → CSV UTF-8*). Sirven los archivos separados por coma, punto y coma (el usual de Excel en español) o tabulador.
3. Máximo **2 MB** y **5 000 contactos** por archivo. Si tienes más, divídelo en partes.

Para empezar rápido, en la pantalla de importación pulsa **Descargar plantilla**.

| Columna | ¿Obligatoria? | Qué contiene |
| - | - | - |
| **Nombre** | Sí | Nombre del contacto (hasta 200 caracteres) |
| **Correo** | No | Se guarda en minúsculas |
| **Teléfono** | No | Con código de país: `+573001112233`. Si no lo traen, ver abajo |
| **Empresa** | No | Si no existe, se crea; si ya existe, se enlaza |
| **Etapa** | No | `lead`, `qualified`, `customer`, `lost`. También se entienden *prospecto, calificado, cliente, perdido* |
| **Origen** | No | De dónde vino el contacto. Si lo dejas vacío se guarda «Importación CSV» |

Los encabezados en español o en inglés se reconocen solos (*Nombre, Correo electrónico, Celular, Empresa…*). Las columnas que no reconoce las puedes asignar a mano o marcar como **No importar**.

## Importar paso a paso

**1. Abre la pantalla**

En **Contactos**, pulsa **Importar**.

**2. Elige tu archivo**

Pulsa **Elegir archivo CSV**. Verás cuántas filas se leyeron.

**3. Revisa las columnas**

Cada columna de tu archivo muestra un ejemplo y a qué campo se asignó. Cámbialo si hace falta. Es obligatorio que una columna sea el **Nombre**.

**4. Elige el país de los teléfonos**

Si tus teléfonos no empiezan con **+**, elige su país y Clientix agrega el código (y quita el 0 inicial). **Nunca se adivina el país**: si no eliges uno, esos teléfonos se marcan con error.

**5. Decide qué hacer con los que ya existen**

Un contacto «ya existe» si coincide su **correo o su teléfono**. Puedes **Omitirlo** (no se cambia nada) o **Actualizarlo** con los datos del archivo.

**6. Pulsa Simular importación**

Verás los totales (nuevos, actualizados, omitidos, con problemas, empresas nuevas) y la lista de filas con problemas y su motivo.

**7. Pulsa Importar ahora**

Solo aparece después de simular. Si cambias cualquier opción, hay que simular de nuevo.

## Si el contacto ya existe

* **Omitir:** el contacto existente queda intacto.
* **Actualizar:** se sobrescribe **solo lo que trae tu archivo** (nombre, empresa, etapa, origen). El **correo y el teléfono solo se completan si el contacto no los tenía**: nunca se cambian los que ya tiene. Lo que tu archivo deja vacío **no borra** nada.
* Un vendedor solo puede actualizar **sus propios** contactos (y un supervisor, los de su equipo). Los demás se omiten.
* Si en el archivo el **correo** de una fila es de un contacto y el **teléfono** es de otro, la fila se marca con error y no se toca ninguno.
* Si el mismo correo o teléfono aparece **dos veces en tu archivo**, se usa la primera fila.

## Filas con problemas

Las filas con errores no impiden importar las demás. Para cada una verás su **número de línea** del archivo y el motivo (correo inválido, teléfono sin código de país, nombre vacío, etapa desconocida, caracteres no permitidos…). Pulsa **Descargar filas con problemas** para obtener un CSV con esas filas y una columna **Motivo**: corrígelas y súbelas de nuevo.

> [!WARNING]
>
> Si tu empresa tiene **campos personalizados obligatorios** para contactos, los contactos **nuevos** no se pueden importar (el archivo no los trae): marca el campo como opcional en **Campos personalizados** mientras importas, o crea esos contactos a mano. Actualizar contactos existentes sí funciona.

## Después de importar

* Los contactos importados quedan a tu nombre y aparecen en **Contactos**; cada uno queda registrado en el historial de auditoría como creado «vía importación».
* Si se corta la conexión a la mitad de un archivo grande, lo de los lotes ya procesados **sí se guardó**. Vuelve a subir el mismo archivo en modo **Omitir**: lo ya importado se omite y se completa el resto.
* La importación no borra contactos ni cambia sus tareas, actividades ni deals.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.