> ## 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 traer contactos de otro sistema

> Usa el asistente para traer contactos, negocios del embudo, etiquetas y responsables de otro sistema, paso a paso y con revisión antes de guardar.

## Para qué sirve

Usabas otro sistema y quieres llevar a tus clientes a STChat sin escribirlos. El asistente **Traer contactos de otro sistema** trae contactos, negocios del embudo, etiquetas, campos y responsables. No se guarda nada antes de que lo revises.

Si solo tienes una hoja de cálculo simple de contactos, consulta también [Cómo importar contactos por CSV](https://docs.stchat.app/es/subcontas/importar-contatos-csv.md).

> [!NOTE]
>
> El asistente acepta solo archivos **.csv**. El selector de archivos no abre otros tipos. Si tu sistema exporta en Excel, abre el archivo y guárdalo como CSV antes.

## Quién puede

Solo Dueño, Admin y Supervisor pueden importar. Para los demás perfiles la pantalla muestra el aviso **Solo el Dueño, Admin y Supervisor pueden importar.**

Deshacer una importación le corresponde a quien importó, al Dueño o al Admin.

## Dónde hacer clic

El asistente se abre en una ventana sobre **Contactos**, en la dirección `/contacts?importar=sistema`. Llegas por dos caminos:

* En la [Primera semana](https://docs.stchat.app/es/subcontas/primeira-semana.md), en el paso **Trae tus contactos**, elige **Vengo de otro sistema** y haz clic en **Continuar**.
* Por la dirección de arriba, si alguien del equipo o de la agencia te envió el enlace.

## Paso a paso

**1. Origen**

En **¿De dónde vienen tus contactos?**, elige la tarjeta del sistema desde donde exportaste. Si solo tienes un archivo, elige **Hoja de cálculo** (**CSV o Excel** aparece como pista en la tarjeta, pero el archivo debe ser CSV). **Agenda del celular** se abre solo en la app. Haz clic en **Siguiente**.

**2. Cómo exportar y Archivos**

La pantalla muestra **Cómo exportar**, con los pasos para sacar el archivo del otro sistema. Después, en **Tus archivos**, haz clic en **Suelta el archivo aquí o haz clic para elegir** en el recuadro **Contactos**. Cuando el origen tiene negocios, hay otro recuadro, **Negocios (opcional)**. El límite es de hasta 50 mil filas por archivo. El envío empieza al instante y aparece **Enviando… y leyendo las columnas**. Para detenerlo, usa **Cancelar el envío**; para cambiarlo, **Quitar el archivo**. Cuando el archivo se lee, la pantalla confirma cuántas filas tiene y de qué origen parece ser.

**3. Mapear**

El sistema sugiere cómo vincular cada columna del archivo con un campo del contacto. Hay cuatro pestañas: **Columnas**, **Embudo**, **Etiquetas** y **Responsables**. En **Columnas**, cambia el **Campo del contacto** de cada **Columna del archivo**, crea un campo nuevo o marca **No importar**. En **Embudo**, crea un embudo igual al del otro sistema o usa uno que ya existe. En **Etiquetas**, deja marcado **Crear las etiquetas que aún no existen**. En **Responsables**, elige quién es el responsable de cada nombre; quien no tenga par queda **Sin responsable**.

**4. Revisar**

En **Revisa antes de importar** ves cuántos contactos entran, cuántos son nuevos, cuántos ya existen y se actualizarán, y cuántos están repetidos en el archivo (unidos). También ves negocios, responsables encontrados y teléfonos inválidos. Elige la **Base legal (LGPD)**, que es obligatoria. Marca o desmarca **Actualizar a quien ya existe** (solo llena campos vacíos; las etiquetas se suman, nunca se quitan) y **No disparar automatizaciones para los importados**. Si el archivo tiene consentimiento, la pantalla resume quién acepta, quién salió y quién está sin registro.

**5. Importar**

Haz clic en **Importar N contactos**. La importación corre en segundo plano y se puede deshacer hasta 24 h después. En una base grande, la pantalla avisa que tarda unos 15 minutos.

## Qué pasa después

La pantalla muestra **Importando…** con el avance. Puedes cerrarla: el aviso de que terminó aparece en el sistema y en el celular.

Al final aparece **Importación terminada**, con contactos creados y actualizados, negocios en el embudo, responsables no encontrados y filas con error. Haz clic en **Ver los contactos importados** para abrir la lista.

**Historial.** Todas las importaciones quedan en **Importaciones**, en la dirección `/contacts?lista=importacoes`. También llegas con **Ver importaciones**, en el primer paso del asistente. La tabla tiene **Fecha**, **Origen**, **Quién lo hizo · números** y **Situación** (**Terminada**, **En curso**, **Se detuvo** o **Deshecha**). En cada fila:

* **Deshacer (hasta …)**: elimina los contactos y negocios creados y devuelve los actualizados como estaban. Los contactos que ya conversaron después se quedan, con un aviso.
* **Descargar errores**: descarga un CSV con las filas que no entraron y el motivo. Corrige e importa de nuevo.
* **Reanudar**: continúa una importación que se detuvo, desde donde se detuvo.

Las fechas aparecen en la zona horaria del navegador de quien usa el sistema.

## Errores comunes

* **Traer de otro sistema aún no está disponible.** La función aún no está activa para ti. Habla con la agencia.
* **No se pudieron cargar los orígenes.** Haz clic en **Intentar de nuevo**.
* **Este archivo no abre.** El archivo no fue aceptado. Exporta de nuevo y guárdalo como CSV.
* **El archivo pasa de 50 mil filas. Divídelo en partes.**
* **Ya hay una importación en curso en esta empresa. Espera a que termine.**
* **No se pudo continuar ahora. No se guardó nada.** Inténtalo de nuevo.
* **No reconocemos N columnas. Elige el campo de cada una o marca "No importar".** Ajústalo en la pestaña **Columnas**.
* **N teléfonos inválidos**: van a la lista de errores, para descargar después.
* **Pasaron más de 24 h: ya no se puede deshacer.**
* **La importación se detuvo en N%. No se perdió nada.** Usa **Reanudar** en el historial.

## Próximo paso

* [Cómo importar contactos por CSV](https://docs.stchat.app/es/subcontas/importar-contatos-csv.md)
* [Contactos](https://docs.stchat.app/es/subcontas/contatos.md)
* [Ficha del contacto](https://docs.stchat.app/es/subcontas/ficha-do-contato.md)
* [Kanban](https://docs.stchat.app/es/subcontas/kanban.md)


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