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

# Contactos

> Treble incluye un CRM liviano integrado que centraliza todos tus contactos de WhatsApp en un solo lugar. Aprende a gestionar contactos, propiedades personalizadas, listas y acciones masivas.

## ¿Qué es la sección de Contactos?

La sección de **Contactos** es el CRM liviano de Treble. Aquí se centralizan automáticamente todos los números de WhatsApp con los que tu empresa ha interactuado: cualquier usuario que reciba una conversación outbound o que inicie una conversación inbound queda registrado como contacto sin ninguna acción manual de tu parte.

Desde esta sección puedes:

* Ver y buscar todos tus contactos en un solo lugar.
* Crear **propiedades personalizadas** (texto, número o fecha) para enriquecer los perfiles.
* Organizar contactos en **listas** para segmentarlos.
* Aplicar **filtros** para encontrar exactamente el segmento que necesitas.
* Ejecutar **acciones masivas**: enviar conversaciones, agregar o remover de listas, o eliminar contactos.

<img src="https://mintcdn.com/trebleai/DYg-VqTiN7vRC2Sn/images/light-crm-all-platform.png?fit=max&auto=format&n=DYg-VqTiN7vRC2Sn&q=85&s=ccf1010c134fa1c479c55b163f7a93a5" alt="Vista general de Contactos en Treble" width="2348" height="1354" data-path="images/light-crm-all-platform.png" />

En la parte superior de la sección encontrarás tres métricas clave:

* **Contactos totales**: el número total de contactos registrados en tu cuenta.
* **Contactos opt-out**: contactos que han solicitado no recibir más mensajes.
* **Nuevos Contactos (último mes)**: contactos creados en los últimos 30 días, útil para medir el crecimiento de tu base.

***

## Agregar un contacto

Puedes agregar contactos de dos formas: uno a uno o cargando un archivo CSV. Haz click en el botón **Agregar contacto** en la esquina superior derecha para acceder a ambas opciones.

### Agregar uno a uno

Completa el formulario con los datos del contacto:

* **Nombre Completo**: nombre del contacto.
* **Email**: correo electrónico.
* **Número de Teléfono**: selecciona el código de país e ingresa el número.
* **Propiedades adicionales**: cualquier propiedad personalizada que hayas creado aparecerá aquí como campo adicional (por ejemplo, CRM, saldo, Company URL, edad).

<img src="https://mintcdn.com/trebleai/DBZoHVPBew9UGNKw/images/light-crm-add-contacts-onebyone.png?fit=max&auto=format&n=DBZoHVPBew9UGNKw&q=85&s=8211d82df5da9d6830dfcd8aec66b241" alt="Agregar un contacto manualmente" width="2340" height="1350" data-path="images/light-crm-add-contacts-onebyone.png" />

### Agregar por CSV

Si necesitas cargar múltiples contactos a la vez, usa la pestaña de **Lista de contactos** dentro del mismo modal y haz click en **Subir archivo**.

El archivo CSV debe contener las columnas requeridas. Las columnas obligatorias son `country_code` y `cellphone`. Las columnas opcionales incluyen `name`, `email`, y cualquier propiedad personalizada que hayas creado (por ejemplo, `saldo`, `Company URL`, `edad`, o el nombre de una lista como `Leads Mayo`).

<img src="https://mintcdn.com/trebleai/DBZoHVPBew9UGNKw/images/light-crm-add-contancs-csv.png?fit=max&auto=format&n=DBZoHVPBew9UGNKw&q=85&s=0964c7e0f6e83e5a913e83e530354daf" alt="Agregar contactos por CSV" width="2342" height="1350" data-path="images/light-crm-add-contancs-csv.png" />

<Tip>
  Descarga el archivo de ejemplo desde el modal para asegurarte de que tu CSV tenga el formato correcto antes de subirlo.
</Tip>

<Warning>
  Los nombres de las columnas del CSV deben coincidir exactamente con los nombres internos de tus propiedades personalizadas. Si no coinciden, el campo no se importará.
</Warning>

***

## Propiedades personalizadas

Las propiedades personalizadas te permiten almacenar información adicional en cada contacto más allá de los campos base (nombre, teléfono, email). Puedes crear propiedades de tres tipos: **Texto**, **Número** o **Fecha**.

Para crear una propiedad, haz click en el botón **Propiedades** en la barra de herramientas y luego en **Crear nueva propiedad**.

<img src="https://mintcdn.com/trebleai/DYg-VqTiN7vRC2Sn/images/light-crm-create-property-0.png?fit=max&auto=format&n=DYg-VqTiN7vRC2Sn&q=85&s=9ad6187ee42fba21073ec1faa18eaddf" alt="Menú de propiedades personalizadas" width="2346" height="1354" data-path="images/light-crm-create-property-0.png" />

Asigna un nombre descriptivo a la propiedad y selecciona su tipo:

<img src="https://mintcdn.com/trebleai/DYg-VqTiN7vRC2Sn/images/light-crm-create-property-1.png?fit=max&auto=format&n=DYg-VqTiN7vRC2Sn&q=85&s=a8c60c4c4d6419bf3e9e041c8cb6a7b0" alt="Crear propiedad - nombre y tipo" width="2342" height="1352" data-path="images/light-crm-create-property-1.png" />

Los tipos disponibles son:

<img src="https://mintcdn.com/trebleai/DYg-VqTiN7vRC2Sn/images/light-crm-create-property-2.png?fit=max&auto=format&n=DYg-VqTiN7vRC2Sn&q=85&s=613486b5fddd0e93c23dcb94294b7472" alt="Tipos de propiedad: Texto, Número, Fecha" width="2344" height="1354" data-path="images/light-crm-create-property-2.png" />

| Tipo       | Descripción                                                                                  |
| ---------- | -------------------------------------------------------------------------------------------- |
| **Texto**  | Almacena cualquier cadena de texto libre. Ideal para campos como empresa, categoría o notas. |
| **Número** | Almacena valores numéricos. Ideal para saldos, scores o cantidades.                          |
| **Fecha**  | Almacena fechas. Ideal para fechas de última compra, renovación o vencimiento.               |

Una vez creada, la propiedad aparece como columna en la tabla de contactos y como campo disponible al agregar o editar contactos, al cargar CSVs y al usar variables en el editor de conversaciones.

Para ver y gestionar todas tus propiedades, haz click en **Propiedades → Ver propiedades personalizadas**.

***

## Listas de contactos

Las listas te permiten segmentar tus contactos en grupos con nombre para poder filtrarlos y enviarles conversaciones de forma dirigida.

Para crear una lista, haz click en el botón **Listas** en la barra de herramientas, escribe el nombre de la nueva lista y haz click en **Crear lista**.

<img src="https://mintcdn.com/trebleai/DYg-VqTiN7vRC2Sn/images/light-crm-create-list.png?fit=max&auto=format&n=DYg-VqTiN7vRC2Sn&q=85&s=c1e93d01c70a8c40812c3372a874fd95" alt="Crear una lista de contactos" width="2342" height="1350" data-path="images/light-crm-create-list.png" />

Las listas que crees aparecerán:

* Como columna en la tabla de contactos, mostrando a qué listas pertenece cada contacto.
* Como filtro disponible en el panel de **Filtros**.
* Como opción al ejecutar acciones masivas de **Agregar a lista** o **Eliminar de lista**.

***

## Barra de herramientas

<img src="https://mintcdn.com/trebleai/DYg-VqTiN7vRC2Sn/images/light-crm-toolbar-actions.png?fit=max&auto=format&n=DYg-VqTiN7vRC2Sn&q=85&s=009e885cb85db6e412d22909edcef336" alt="Barra de herramientas de Contactos" width="2340" height="1352" data-path="images/light-crm-toolbar-actions.png" />

La barra de herramientas, ubicada en la parte superior derecha de la tabla, contiene las siguientes acciones:

| Acción                                                       | Descripción                                                       |
| ------------------------------------------------------------ | ----------------------------------------------------------------- |
| <Icon icon="magnifying-glass" iconType="solid" /> **Buscar** | Busca contactos por nombre o número de teléfono.                  |
| <Icon icon="download" iconType="solid" /> **Exportar**       | Descarga la lista de contactos filtrados en formato CSV.          |
| **Propiedades**                                              | Crea nuevas propiedades personalizadas o consulta las existentes. |
| **Listas**                                                   | Crea nuevas listas de segmentación.                               |
| **Agregar contacto**                                         | Abre el modal para agregar un contacto manualmente o por CSV.     |

***

## Filtros

El panel de filtros te permite reducir la vista de contactos a exactamente el segmento que necesitas trabajar. Haz click en el botón **Filtros** para abrirlo.

<img src="https://mintcdn.com/trebleai/DYg-VqTiN7vRC2Sn/images/light-crm-filters.png?fit=max&auto=format&n=DYg-VqTiN7vRC2Sn&q=85&s=cb904b969cb1ac12211cd30bc59538b0" alt="Panel de filtros de Contactos" width="1058" height="894" data-path="images/light-crm-filters.png" />

Los filtros disponibles son:

| Filtro              | Opciones                                                                                                                          |
| ------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| **Rango de fechas** | Hoy, Ayer, Últimos 7 días, Últimas 2 semanas, Último mes, Últimos 3 meses, Último año. Filtra por fecha de creación del contacto. |
| **Estado**          | Todos los contactos, Opt-Out, Opt-In.                                                                                             |
| **Listas**          | Muestra solo los contactos que pertenecen a una o más listas seleccionadas.                                                       |
| **País**            | Filtra por código de país del número de teléfono.                                                                                 |

Una vez configurados los filtros, haz click en **Aplicar filtros**. La tabla se actualizará y el encabezado mostrará un enlace **Seleccionar \[N] contactos filtrados** que te permite seleccionar todos los contactos que cumplen con los criterios, independientemente de la página.

***

## Acciones masivas

Con uno o más contactos seleccionados, aparece una barra en la parte inferior de la pantalla con las acciones masivas disponibles.

<img src="https://mintcdn.com/trebleai/DYg-VqTiN7vRC2Sn/images/light-crm-bulk-actions.png?fit=max&auto=format&n=DYg-VqTiN7vRC2Sn&q=85&s=144e104c5c54c19158c8555bf17b91bd" alt="Barra de acciones masivas" width="2338" height="1352" data-path="images/light-crm-bulk-actions.png" />

Puedes seleccionar contactos de tres formas:

* **Individualmente**: marca la casilla junto a cada contacto.
* **Página actual**: marca la casilla del encabezado para seleccionar todos los contactos de la página visible.
* **Todos los filtrados**: haz click en el enlace **Seleccionar \[N] contactos filtrados** en la barra superior para seleccionar todos los que pasen los filtros activos, incluso si son miles.

Las acciones disponibles son:

### 🗑 Eliminar

Elimina permanentemente los contactos seleccionados de tu cuenta.

### ➕ Agregar a lista

Agrega los contactos seleccionados a una lista existente. Al hacer click, aparece un buscador con tus listas disponibles. Selecciona la lista de destino y haz click en **Agregar**.

<img src="https://mintcdn.com/trebleai/DBZoHVPBew9UGNKw/images/light-crm-add-to-list.png?fit=max&auto=format&n=DBZoHVPBew9UGNKw&q=85&s=326a7a956bc02efe9bdc74df095e9ba8" alt="Agregar contactos seleccionados a una lista" width="2344" height="1356" data-path="images/light-crm-add-to-list.png" />

### — Eliminar de lista

Remueve los contactos seleccionados de una lista. Útil para limpiar segmentos sin eliminar los contactos de tu base.

### 📤 Enviar conversación

Despliega una conversación de Treble a los contactos seleccionados directamente desde la sección de Contactos. Al hacer click, se abre un buscador de conversaciones para que elijas cuál enviar.

<img src="https://mintcdn.com/trebleai/DYg-VqTiN7vRC2Sn/images/light-crm-send-conversation.png?fit=max&auto=format&n=DYg-VqTiN7vRC2Sn&q=85&s=4a2ff3fe969c35e77fcf1d93632c149c" alt="Seleccionar conversación para envío masivo" width="2344" height="1352" data-path="images/light-crm-send-conversation.png" />

#### Vincular propiedades

Si la conversación seleccionada contiene variables (por ejemplo, `{{name}}` o `{{company}}`), Treble verificará automáticamente si esas variables coinciden con las propiedades de tus contactos. Si hay variables que no coinciden, se mostrará el modal **Vincular propiedades**.

<img src="https://mintcdn.com/trebleai/DYg-VqTiN7vRC2Sn/images/light-crm-send-conversation-map-columns.png?fit=max&auto=format&n=DYg-VqTiN7vRC2Sn&q=85&s=b9733be2ca4fbcd7fec806465c9f29ad" alt="Vincular propiedades de la conversación con las del contacto" width="2338" height="1348" data-path="images/light-crm-send-conversation-map-columns.png" />

En este modal puedes mapear manualmente cada variable de la conversación con la propiedad del contacto que debe usarse como valor. Por ejemplo, la variable `name` de la conversación puede mapearse a la propiedad `name` del contacto.

<img src="https://mintcdn.com/trebleai/DYg-VqTiN7vRC2Sn/images/light-crm-send-conversation-map-columns-2.png?fit=max&auto=format&n=DYg-VqTiN7vRC2Sn&q=85&s=07940d6de18882e615944156ca5eb599" alt="Seleccionar propiedad del contacto para vincular" width="2340" height="1352" data-path="images/light-crm-send-conversation-map-columns-2.png" />

Las propiedades disponibles para vincular incluyen los campos base del contacto (Email, WhatsApp Id, name, etc.) y todas las propiedades personalizadas que hayas creado.

<Tip>
  Si la variable de tu conversación tiene exactamente el mismo nombre que la propiedad del contacto, Treble la vinculará automáticamente sin necesidad de hacerlo manualmente.
</Tip>

Si una propiedad que necesitas vincular no aparece en el listado, usa el enlace **No encuentro la propiedad que necesito** para crearla antes de continuar.

***

## Variables de Contactos en el editor de conversaciones

Las propiedades de tus contactos en Treble pueden usarse como variables directamente dentro del editor de conversaciones, de la misma forma en que se usan las <a class="article-link" href="/es/docs/integrations/hubspot/features/variables"><p>variables de HubSpot</p><Icon icon="arrow-up-right-from-square" iconType="solid" /></a>.

Esto significa que puedes:

* **Leer** una propiedad del contacto dentro de un mensaje. Por ejemplo, saludar al cliente por su nombre usando la propiedad `name`.
* **Escribir** la respuesta del cliente en una propiedad del contacto. Por ejemplo, capturar el correo que proporcione y guardarlo en su propiedad `email`.

Las variables de Contactos tienen un formato especial según el tipo de propiedad:

* **Propiedades predeterminadas** (nombre y correo): usan el prefijo `trbcontact_d_`.
* **Propiedades personalizadas**: usan el prefijo `trbcontact_c_` seguido del nombre interno de la propiedad.

| Propiedad                    | Variable                        |
| ---------------------------- | ------------------------------- |
| Nombre (predeterminado)      | `{{trbcontact_d_name}}`         |
| Correo (predeterminado)      | `{{trbcontact_d_email}}`        |
| Source (personalizada)       | `{{trbcontact_c_source}}`       |
| Edad (personalizada)         | `{{trbcontact_c_edad}}`         |
| Departamento (personalizada) | `{{trbcontact_c_departamento}}` |
| Sitio web (personalizada)    | `{{trbcontact_c_sitio_web}}`    |

<Tip>
  El nombre interno de una propiedad personalizada es el que asignaste al crearla. Si no recuerdas el nombre exacto, consúltalo en **Propiedades → Ver propiedades personalizadas**.
</Tip>

Al igual que con las variables de HubSpot, para guardar la respuesta de un cliente en una propiedad del contacto debes hacer doble click en el bloque correspondiente en el editor, seleccionar **Guardar respuesta como variable** y escribir el nombre de la variable del contacto (por ejemplo, `trbcontact_c_edad`) en el campo de nombre de la variable.
