# Atributos de contacto

Referencia de los atributos de contacto y de evento en Pristo CX: seis tipos, límites, reglas de las claves y su uso en segmentos, mensajes e informes.

Los atributos de contacto son los campos adicionales que Pristo CX guarda en cada contacto de una población, como la ciudad o el nivel de cliente. Los atributos de evento son los datos que acompañan a una actividad, como la sucursal o el monto. Un administrador de la cuenta o un administrador del programa define los atributos de contacto en la pestaña **Población**, en **Acciones** > **Atributos de contacto**, y los atributos de evento en **Acciones** > **Atributos de eventos** > **Atributos**.

## Resumen

| Tipo | Máximo por población | Valor de ejemplo | Comparaciones en segmentos y filtros |
|---|---|---|---|
| **Texto** | 5 | `Haifa` | **Igual a**, **No igual a** |
| **Número** | 2 | `42`, `12.5` | **Igual a**, **No igual a**, **Mayor que**, **Menor que**, **Mayor o igual que**, **Menor o igual que** |
| **Fecha** | 2 | `2026-10-21` | Las mismas seis que los números |
| **Hora** | 2 | `14:30` | Las mismas seis que los números |
| **Fecha y hora** | 2 | `2026-10-21 14:30` | Las mismas seis que los números |
| **Booleano** | 2 | `true`, `false` | **Igual a**, con **Sí** o **No** |

Los límites cuentan por separado los atributos de contacto y los atributos de evento, así que una población puede tener 5 atributos de contacto de texto y 5 atributos de evento de texto. Cuando un tipo llega a su límite, la lista de tipos del cuadro de diálogo lo desactiva.

## Claves y nombres

| Campo | Regla |
|---|---|
| **Identificador único** | De 1 a 50 caracteres: letras en inglés (de la a a la z y de la A a la Z) y guiones bajos, sin guion bajo al principio ni al final. Debe ser única en su lista. El cuadro de diálogo no distingue mayúsculas de minúsculas al comparar claves. Las importaciones y la API usan la clave. No puedes cambiarla después de agregar el atributo |
| **Nombre del atributo** | De 1 a 50 caracteres. El nombre que las personas ven en la aplicación, por ejemplo Edad. Puedes cambiar el nombre de un atributo en cualquier momento |
| **Tipo de atributo** | Uno de los seis tipos del resumen. No puedes cambiarlo después de agregar el atributo |

Los tipos de evento siguen las mismas reglas de clave y nombre, y no tienen tipo.

## Valores de los atributos de contacto

- Los valores llegan desde [Importar contactos](https://docs.pristo.io/es/cx/populations/import-contacts), desde [Importar actividades](https://docs.pristo.io/es/cx/populations/import-activities) y desde el objeto `contact.customFields` de [Enviar un evento](https://docs.pristo.io/es/cx/api/send-an-event).
- La página del contacto muestra los valores en **Atributos adicionales**. Ahí no puedes escribir ningún valor, y **Añadir contacto** no tiene campos de atributos.
- Una importación o un evento solo escribe los atributos que trae. Una celda vacía o una clave que falta conserva el valor actual, así que una importación no puede borrar un valor.
- Pristo CX quita los espacios del principio y del final de cada valor y lo recorta a 50 caracteres. Un valor que no se puede leer como el tipo del atributo se omite, y una importación lo muestra como advertencia.
- Los booleanos aceptan `true`, `false`, `1` y `0`, en mayúsculas o en minúsculas. Escribe las fechas como `YYYY-MM-DD`.
- En las importaciones y en la API, las claves coinciden sin importar las mayúsculas y minúsculas.

## Valores de los atributos de evento

- Los valores llegan desde [Importar actividades](https://docs.pristo.io/es/cx/populations/import-activities) y desde el objeto `customFields` de primer nivel de [Enviar un evento](https://docs.pristo.io/es/cx/api/send-an-event).
- Pristo CX los guarda con la actividad como texto y no comprueba su tipo.
- Una distribución basada en eventos puede filtrar por ellos en **Definir eventos de activación**. El filtro lee el valor como el tipo del atributo, así que un valor que no se puede leer así, o un valor que falta, no coincide. En un booleano, envía `true` o `false`.
- En la API, la clave de un atributo de evento debe coincidir exactamente, incluidas las mayúsculas y minúsculas.

## Dónde se usan los atributos

| Dónde | Atributos de contacto | Atributos de evento |
|---|---|---|
| El segmento de la pestaña **Muestras** de una distribución | Sí | No |
| Los filtros de eventos de una [distribución basada en eventos](https://docs.pristo.io/es/cx/distributions/event-based) | No | Sí |
| Las variables de los mensajes y los recordatorios, con **Agregar variable** | Sí | No |
| **Columnas** en la página de respuestas, y el panel de la respuesta | Sí | Sí |
| [Exportaciones](https://docs.pristo.io/es/cx/responses/export-responses) | Sí | Sí |
| Segmentación y filtros de los paneles | Sí | Sí |

Una variable de un mensaje se reemplaza con el valor del contacto cuando se envía el mensaje. Si el contacto no tiene valor, en su lugar queda un texto vacío.

## Eliminar un atributo

Pristo CX elimina un atributo de contacto, un tipo de evento o un atributo de evento solo mientras la población no tiene contactos. Cuando la población ya tiene contactos, el atributo se conserva, aunque la lista deja de mostrarlo hasta que vuelves a cargar la página.

## Temas relacionados

- [Introducción a las poblaciones](https://docs.pristo.io/es/cx/populations/overview)
- [Importar contactos](https://docs.pristo.io/es/cx/populations/import-contacts)
- [Importar actividades](https://docs.pristo.io/es/cx/populations/import-activities)
- [Elegir quién recibe una distribución](https://docs.pristo.io/es/cx/distributions/sampling-and-rules)
- [Introducción a los paneles](https://docs.pristo.io/es/cx/dashboards/overview)
- [Glosario](https://docs.pristo.io/es/cx/glossary)