# Introducción a las poblaciones

Aprende cómo funciona una población en Pristo CX: contactos, atributos de contacto, actividades y tipos de evento, y cómo los usan las distribuciones.

Una población en Pristo CX es la lista de contactos de un programa, con sus atributos y actividades, a la que las distribuciones envían cuestionarios. Cada programa tiene una población, y la abres desde la pestaña **Población** en la parte superior de la aplicación.

![Una población contiene contactos. Cada contacto tiene atributos de contacto y actividades, y cada actividad tiene un tipo de evento. Las distribuciones usan los atributos de contacto y los tipos de evento para decidir quién recibe un cuestionario, y el cuestionario genera respuestas.](https://docs.pristo.io/_astro/population-model.light.Dnc_pFci.svg)

## Quién puede ver la población

La pestaña **Población** aparece en todos los planes excepto en el plan Gratis. En el plan Gratis, la pestaña está oculta y las páginas de la población no se pueden abrir. Consulta [Planes y límites](https://docs.pristo.io/es/cx/get-started/plans-and-limits).

Todos los miembros del programa pueden abrir la población: los administradores de la cuenta, los administradores del programa y los usuarios del programa. Solo los administradores de la cuenta y los administradores del programa ven el menú **Acciones**, que sirve para agregar e importar contactos, importar actividades y definir atributos. Los usuarios del programa pueden consultar los contactos y el historial de importaciones, pero no pueden cambiar nada. Consulta [Roles y permisos](https://docs.pristo.io/es/cx/users/roles-and-permissions).

## Contactos

Un contacto es una persona que puede recibir cuestionarios por SMS o correo electrónico. La pestaña **Contactos** los muestra con su **ID**, **Nombre**, **Teléfono**, **Correo electrónico**, **Idioma preferido** y si se dieron de baja. El cuadro de búsqueda encuentra contactos por el principio de su nombre o por el valor exacto de su apellido, correo electrónico, teléfono o identificador.

- El identificador (**ID**) es único en la población. Las importaciones y la API lo usan para reconocer a la misma persona, así que una fila o un evento con un identificador que ya existe se refiere a ese contacto en lugar de crear un duplicado.
- Un contacto necesita un número de celular israelí (+972 5…) para recibir SMS y una dirección de correo electrónico para recibir correos. Los demás números de teléfono se guardan, pero no reciben SMS; consulta [Importar contactos](https://docs.pristo.io/es/cx/populations/import-contacts).
- Un contacto que selecciona el enlace para darse de baja de un mensaje queda marcado como **Dado de baja** y ya no recibe cuestionarios. Consulta [Darse de baja de los SMS y los correos](https://docs.pristo.io/es/cx/respondents/answer-a-questionnaire#darse-de-baja-de-los-sms-y-los-correos).
- Cada contacto tiene su propia página con sus datos, sus **Atributos adicionales**, los **Envíos** que recibió y sus **Eventos**. Un administrador puede cambiar un contacto a **Inactivo**, y los contactos inactivos no reciben cuestionarios.

Puedes agregar contactos de tres formas: uno por uno con **Añadir contacto**, desde un archivo con [Importar contactos](https://docs.pristo.io/es/cx/populations/import-contacts), o a través de la API, donde cada [evento que envías](https://docs.pristo.io/es/cx/api/send-an-event) crea o actualiza su contacto.

## Atributos de contacto

Los atributos de contacto son campos adicionales de cada contacto, como la ciudad o el nivel de cliente. Un administrador los define en **Acciones** > **Atributos de contacto**. Conviene definirlos antes de la primera importación, para que la importación pueda completarlos.

| Campo | Qué es |
|---|---|
| **Identificador único** | La clave que se usa en las importaciones y en la API. Solo admite letras en inglés y guiones bajos, y no puede empezar ni terminar con un guion bajo |
| **Nombre del atributo** | El nombre que las personas ven en la aplicación, por ejemplo Edad |
| **Tipo de atributo** | **Texto**, **Número**, **Fecha**, **Hora**, **Fecha y hora** o **Booleano** |

Una población puede tener hasta 5 atributos de texto y hasta 2 atributos de cada uno de los demás tipos. Las distribuciones usan los atributos de contacto para elegir un segmento de contactos, y los mensajes pueden insertarlos como variables. Un atributo solo se puede eliminar mientras la población no tiene contactos. Consulta [Atributos de contacto](https://docs.pristo.io/es/cx/populations/contact-attributes).

## Actividades y tipos de evento

Una actividad es un evento registrado para un contacto, como una compra o una llamada de soporte cerrada. En la aplicación, las actividades aparecen como **Eventos** en la página del contacto.

Un administrador define los tipos de evento y sus atributos en **Acciones** > **Atributos de eventos**, que tiene dos pestañas:

- **Tipos de eventos**: los tipos de actividad que informas, por ejemplo Compra realizada. Cada uno tiene un identificador y un nombre.
- **Atributos**: los datos que acompañan a una actividad, por ejemplo la sucursal y el monto de la transacción. Admiten los mismos tipos y límites que los atributos de contacto.

Las actividades llegan a Pristo CX desde un archivo con **Importar actividades**, como se explica en [Importar actividades](https://docs.pristo.io/es/cx/populations/import-activities), o desde tus propios sistemas con el endpoint [enviar un evento](https://docs.pristo.io/es/cx/api/send-an-event) de la API. Una [distribución basada en eventos](https://docs.pristo.io/es/cx/distributions/event-based) envía un cuestionario cuando llega una actividad de un tipo de evento elegido, y puede filtrar por los atributos del evento.

## Historial de importaciones

La pestaña **Importaciones** muestra todas las importaciones de contactos y de actividades de la población, con el nombre del archivo, el estado y el número de filas, de contactos importados y actualizados, de errores y de advertencias. Expande una fila para ver cada error y cada advertencia por número de fila. Una importación de actividades puede seguir en curso unos minutos después de que se acepta el archivo. La lista se actualiza sola mientras haya una importación en curso.

## Temas relacionados

- [Importar contactos](https://docs.pristo.io/es/cx/populations/import-contacts)
- [Importar actividades](https://docs.pristo.io/es/cx/populations/import-activities)
- [Atributos de contacto](https://docs.pristo.io/es/cx/populations/contact-attributes)
- [Introducción a las distribuciones](https://docs.pristo.io/es/cx/distributions/overview)
- [Enviar encuestas después de un evento](https://docs.pristo.io/es/cx/distributions/event-based)
- [Enviar un evento con la API](https://docs.pristo.io/es/cx/api/send-an-event)
