# Importar contactos

Importa contactos a una población de Pristo CX desde un archivo Excel o CSV de hasta 10 MB, con una columna de identificador y un correo o un teléfono.

En Pristo CX, importas contactos desde un archivo Excel (`.xlsx`) o CSV en la pestaña **Población**, con **Acciones** > **Importar contactos**. Cada contacto necesita un identificador, y el archivo necesita una columna de correo electrónico o de teléfono.

## Antes de empezar

- Rol: administrador de la cuenta o administrador del programa. Los usuarios del programa no pueden importar. Consulta [Roles y permisos](https://docs.pristo.io/es/cx/users/roles-and-permissions).
- Plan: cualquier plan excepto el plan Gratis. La [población](https://docs.pristo.io/es/cx/glossary) no está disponible en el plan Gratis.
- Configuración: para conservar columnas adicionales, como la ciudad o el nivel de cliente, defínelas primero como atributos de contacto. Consulta [Atributos de contacto](https://docs.pristo.io/es/cx/populations/contact-attributes).
- Archivo: un contacto por fila, hasta 10 MB. En un archivo de Excel, pon los contactos en la primera hoja.

## Pasos

![Boceto del cuadro de diálogo para importar contactos, abierto sobre la página de la población. El marcador 3 está en el botón que selecciona el archivo. El marcador 4 está en la opción para un archivo cuya primera fila tiene los nombres de las columnas. El marcador 5 está en la opción que actualiza los contactos existentes. El marcador 6 está en la asignación de columnas, donde eliges la letra de la columna para cada campo. El marcador 7 está en el botón que revisa el archivo, abajo a la derecha del cuadro de diálogo.](https://docs.pristo.io/_astro/import-contacts.C3UNRsGr.webp)

1. Abre la pestaña **Población**.

2. Selecciona **Acciones** > **Importar contactos**.

3. Selecciona **Seleccionar archivo** y elige tu archivo.

4. Deja marcada la opción **El archivo contiene títulos** si la primera fila contiene los nombres de las columnas. Desmárcala si los datos empiezan en la primera fila.

5. Deja marcada la opción **Actualizar contactos cuyo identificador ya existe** para actualizar los contactos que ya están en la población. Desmárcala para agregar solo contactos nuevos.

6. En **Asignación de columnas en el archivo**, elige la letra de la columna de cada campo: el campo **ID** es obligatorio, y también al menos uno de los campos **Correo electrónico** o **Teléfono**. Los campos **Nombre**, **Apellido(s)** e **Idioma**, así como tus atributos de contacto, son opcionales.

7. Selecciona **Siguiente**. Pristo CX revisa el archivo sin importar nada.

8. Si la revisión no encuentra problemas, selecciona **Importar**. Si muestra errores, selecciona **Volver**, corrige el archivo o la asignación y vuelve a revisarlo.

9. Cuando aparezca **Importación finalizada con éxito**, selecciona **Cerrar**.

El cuadro de diálogo recuerda tu asignación, así que la próxima importación empieza con las mismas columnas.

## Resultado

Los contactos nuevos aparecen en la pestaña **Contactos**. La pestaña **Importaciones** agrega una fila para el archivo con el número de filas, de contactos importados y actualizados, de errores y de advertencias. Expande la fila para ver cada advertencia por número de fila.

Para importar actividades (eventos) en lugar de contactos, usa **Importar actividades** en el mismo menú, como se explica en [Importar actividades](https://docs.pristo.io/es/cx/populations/import-activities).

## Límites

- Tipos de archivo: solo `.xlsx` y `.csv`, hasta 10 MB. Pristo CX lee solo la primera hoja de un archivo de Excel.
- Columnas: puedes asignar las columnas de la A a la BZ.
- Identificador: obligatorio, de hasta 50 caracteres y único en el archivo. Una fila con un identificador que ya existe actualiza ese contacto, o se omite si la actualización está desactivada.
- Cuando se actualiza un contacto, los campos de nombre, correo electrónico, teléfono y atributos que no asignaste conservan sus valores.
- Nombre y apellido: hasta 50 caracteres. Los valores más largos se recortan a 50 caracteres, con una advertencia.
- Correo electrónico: una dirección no válida se omite, con una advertencia, y el resto del contacto se importa.
- Teléfono: Pristo CX envía SMS solo a los números que puede leer como celulares israelíes (+972 5…). Un número sin código de país se lee como un número israelí. Los demás números se importan con una advertencia, y la página del contacto muestra **Número no válido**.
- Idioma: un código de dos letras, como `en` o `he`. Si la columna de idioma no está asignada o un valor no se puede leer, el contacto recibe el idioma predeterminado de la población.
- Un archivo con algún error no se puede importar. La revisión deja de mostrar errores después de unos 100.

## Solución de problemas

**El cuadro de diálogo dice que el archivo no es válido.** El mensaje **Archivo inválido. Por favor, selecciona un archivo xlsx o csv válido de hasta 10 MB** significa que el archivo no es `.xlsx` ni `.csv`, o que pesa más de 10 MB. Guárdalo en uno de esos formatos o divídelo en archivos más pequeños.

**La revisión muestra Se encontraron contactos que no se pueden importar.** Cada línea indica una fila y un campo. Las causas más comunes son un identificador vacío, un identificador de más de 50 caracteres y el mismo identificador en dos filas. Corrige esas filas y vuelve a seleccionar **Siguiente**.

**No se importó una columna de mi archivo.** Pristo CX importa solo las columnas asignadas. Define la columna como atributo de contacto y vuelve a importar el archivo con la opción **Actualizar contactos cuyo identificador ya existe** marcada.

**Un contacto no recibe SMS.** Abre el contacto. Si su teléfono muestra **Número no válido**, corrige el número en el archivo y vuelve a importarlo con la actualización activada.

## Temas relacionados

- [Introducción a las poblaciones](https://docs.pristo.io/es/cx/populations/overview)
- [Importar actividades](https://docs.pristo.io/es/cx/populations/import-activities)
- [Atributos de contacto](https://docs.pristo.io/es/cx/populations/contact-attributes)
- [Crear una distribución](https://docs.pristo.io/es/cx/distributions/create-a-distribution)
- [Enviar encuestas después de un evento](https://docs.pristo.io/es/cx/distributions/event-based)
- [Roles y permisos](https://docs.pristo.io/es/cx/users/roles-and-permissions)
