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

# Cómo importar contactos por CSV

> Trae varios contactos a la vez desde una planilla guardada como CSV y revisa cuántos se crearon.

## Para qué sirve

Tienes una planilla de clientes y quieres ponerlos todos en **Contactos** de una vez. La importación solo acepta archivos **.csv**. El sistema empareja cada fila por el teléfono: quien ya existe se actualiza, sin duplicar. Para traer también embudo, etiquetas y responsables de otro sistema, usa el asistente [Cómo traer contactos de otro sistema](https://docs.stchat.app/es/subcontas/trazer-contatos-de-outro-sistema.md).

## Quién puede

* Por defecto, todos los perfiles menos el Operador.
* El Operador solo importa si el Admin le activa esa capacidad.
* Para que la columna de responsable valga, debes ser Dueño, Admin o Supervisor. Para los demás, la columna se ignora.

## Dónde hacer clic

En **Contactos**, haz clic en el ícono **Importar contactos vía CSV** (al lado de **Nuevo contacto**). Si la organización aún no tiene contactos, usa el botón **Importar .csv** en el centro de la pantalla.

## Paso a paso

**1. Prepara la planilla**

Guarda la planilla como CSV. La primera fila es el encabezado y debe tener al menos **nombre** o **teléfono**. Para ver el formato, haz clic en **Descargar modelo de CSV** (archivo `plantilla-contactos.csv`).

**2. Elige el archivo**

Haz clic en **Suelta el .csv aquí o haz clic para elegir**. Cualquier otro tipo de archivo se rechaza: **Solo archivos .csv. Guarda la hoja como CSV y elígela otra vez.**

**3. Revisa el mapeo**

El sistema reconoce las columnas por el nombre del encabezado: nombre, apellido, teléfono, email, empresa, notas (u observación), tags, responsable, CPF/CNPJ (o documento) y la columna de consentimiento (**Acepta recibir**, con **Fecha de aceptación**). En la tabla ves las primeras 100 filas y los totales: **válidos**, **repetidos (se actualizarán)** e **ignorados**.

**4. Ajusta los avisos**

En la columna **tags**, separa varias con punto y coma, como `vip;finanzas`. Las tags nuevas se crean y la pantalla avisa cuántas. Si hay consentimiento, elige el canal en **Vale para el canal**. Para cambiar de archivo, haz clic en **Cambiar**.

**5. Importa**

Haz clic en **Importar N contactos**. Sigue **Importando X/Y…** hasta que termine.

## Qué pasa después

Se abre la ventana **Importación concluida** (o **Importación concluida con avisos**) con el nombre del archivo y las filas leídas. Los números son:

* **creados**: contactos nuevos.
* **actualizados**: contactos que ya existían y se actualizaron con los datos de la planilla.
* **no entraron**: filas con error.

En la parte **Teléfonos** puedes ver números ajustados a +55 DDD (solo cambia el formato), contactos que ya existían con el mismo número con o sin el 9.º dígito y números no reconocidos. Para estos, usa **Descargar lista (.csv)**, corrige e importa de nuevo. Después, haz clic en **Ver contactos importados** o **Cerrar**.

**Dónde queda el registro.** En la ficha de cada contacto importado hay el bloque **IMPORTADO**, con el archivo, la fecha, quién importó y la **fila** de la planilla. Cuando aparece el enlace **Ver importación**, abre la pantalla **Importaciones**, con **Fecha**, **Origen**, **Quién lo hizo · números** y **Situación**, además de **Descargar errores** y **Deshacer** cuando están disponibles. Las fechas aparecen en la zona horaria de tu navegador.

## Errores comunes

* **No fue posible identificar las columnas.** El encabezado necesita **nombre** o **teléfono**.
* **Fila sin nombre y sin teléfono.**
* **Teléfono inválido: usa código de área + número (mínimo 10 dígitos) o +código del país.**
* **Email no válido.** Corrige el email en la fila.
* **Responsable no encontrado: ...** El nombre o email de la columna no coincide con ningún miembro de la organización.
* **Teléfono repetido en el archivo: esta fila actualiza el mismo contacto, sin duplicar.** Es solo un aviso.
* **Error al importar contactos.** La pantalla muestra el mensaje del problema. Revisa el archivo e inténtalo de nuevo.
* **Sesión no válida. Recarga la página.**

## Siguiente paso

* [Contactos](https://docs.stchat.app/es/subcontas/contatos.md)
* [Cómo traer contactos de otro sistema](https://docs.stchat.app/es/subcontas/trazer-contatos-de-outro-sistema.md)
* [Ficha del contacto](https://docs.stchat.app/es/subcontas/ficha-do-contato.md)
* [Listas y segmentos](https://docs.stchat.app/es/subcontas/listas-e-segmentos.md)


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