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

# Contactos

> Crea, edita, fusiona y elimina las personas y empresas de tu Audience

Un contacto es un único registro de una persona o empresa — compartido en todas las llamadas, mensajes, hilos de correo y campañas en los que participa. Audience mantiene una única lista de contactos para todo el espacio de trabajo; las campañas extraen sus leads de ahí en lugar de mantener cada una su propia lista privada.

## Crear un contacto

Selecciona **New Lead** en Audience para abrir el formulario **New contact**. El nombre es opcional; se requiere un número de teléfono o una dirección de correo — cualquiera de los dos por sí solo es suficiente. Ambos deben ser únicos en el espacio de trabajo, así que si un valor ya pertenece a otro contacto, el formulario señala la coincidencia y ofrece abrir ese contacto o añadirle el dato que falta, en lugar de crear un duplicado.

Los contactos también aparecen sin que nadie rellene ese formulario: mediante una [importación de CSV](/es/audience/importing-contacts), la primera vez que alguien llama o escribe a uno de tus números, cuando se añade un lead a una campaña, y a través de la API REST o MCP.

## Editar un contacto

Abre un contacto para ver tres pestañas:

* **Overview** — segmentos, último contacto, promedio de QA de llamadas (cuando los [cuadros de puntuación de AI QA](/es/assistants/analysis#cuadros-de-puntuación-de-ai-qa) están habilitados), datos personales, atributos personalizados y cualquier perfil de canal vinculado.
* **Memory** — [memoria del cliente](/es/assistants/memory) sensible al consentimiento e identidades verificadas recogidas a través de los canales.
* **Timeline** — todas las llamadas, mensajes y correos de este contacto, con un enlace a [Historial](/es/monitoring/history) para ver el registro completo.

La barra de acciones en la parte inferior del panel inicia una llamada con cualquier asistente activo, abre un correo al contacto y — bajo **More actions** — ofrece **Manage** y **Delete**. **Manage Contact** edita el registro en cuatro pestañas: **Info** (nombre, teléfono, correo, foto), **Tags**, **Attributes** y **Channels**.

<Note>
  El etiquetado, el filtrado y los segmentos guardados se explican en [QA de llamadas en Audience](/es/audience/call-qa) — esta página se centra en el propio registro del contacto.
</Note>

## Custom Attributes

Define campos para todo el espacio de trabajo en **Settings → Workspace → Custom Attributes**: un nombre, un tipo y si es obligatorio. Los tipos son **Text**, **Number**, **Boolean** (un campo sí/no), **Enum** (una lista de opciones que tú defines) y **Date**. La clave del atributo se genera a partir del nombre — "Maiden Name" se convierte en `maiden_name` — y el tipo queda fijo en cuanto el atributo existe.

Un espacio de trabajo puede definir hasta 50 atributos, y un atributo Enum puede ofrecer hasta 50 opciones. Los valores se guardan en la pestaña **Attributes** de un contacto, o se rellenan automáticamente durante la importación de CSV.

Un asistente activa los atributos que necesita: en el panel **Variables** del asistente, marca el atributo bajo **Lead attributes** y su valor queda disponible como `{{key}}` en cada llamada con ese contacto. Consulta [Variables personalizadas](/es/assistants/variables).

## Estado del contacto

Cada contacto tiene un único estado, determinado por su actividad de campaña más reciente:

| Estado            | Significado                                                                                             |
| ----------------- | ------------------------------------------------------------------------------------------------------- |
| Created           | Aún no se ha llamado                                                                                    |
| Processing        | Hay una llamada en curso ahora mismo                                                                    |
| Rescheduled       | Esperando su próximo reintento                                                                          |
| Max retries       | Presupuesto de reintentos agotado sin resultado                                                         |
| Completed         | Contactado, o se alcanzó el objetivo de la campaña                                                      |
| DNC (Blacklisted) | En la [lista de no llamar](/es/campaigns/dialer-and-compliance#lista-de-no-llamar-dnc) — nunca se marca |

Filtra Audience por estado para encontrar contactos en cualquiera de estas situaciones. Los mismos seis estados controlan el tablero de arrastrar y soltar dentro de una campaña, donde las columnas llevan nombres orientados a la campaña — consulta [Monitorear una campaña en ejecución](/es/campaigns/overview#monitorear-una-campaña-en-ejecución).

## Fusionar contactos duplicados

Los números de teléfono y las direcciones de correo son únicos por espacio de trabajo, así que Famulor nunca deja que un segundo registro reclame una identidad que ya existe:

* **Al crear** — si añades un único contacto cuyo teléfono o correo ya pertenece a otra persona, se fusionan las etiquetas nuevas y se completan los campos de identidad que falten en ese contacto, en lugar de crear un segundo registro. Esto se aplica al formulario **New contact**, a `POST /api/v1/leads` y a `create_audience_contact` de MCP.
* **Al editar** — si cambias el teléfono o el correo de un contacto a un valor ya usado en otro sitio, la pestaña Info señala la colisión y ofrece **Merge into this contact**. Al fusionar se trasladan el teléfono, el correo, las identidades de canal, las llamadas y las conversaciones al contacto que conservas, y se elimina el otro registro.
* **Al importar** — las importaciones masivas nunca fusionan. Una fila de CSV o un lead de campaña cuyo teléfono o correo ya esté ocupado se rechaza en lugar de incorporarse al contacto existente, así que depura duplicados contra Audience antes de una importación grande. Consulta [Importar contactos](/es/audience/importing-contacts).

<Warning>
  Fusionar dos contactos existentes es siempre un paso explícito. Un teléfono o correo que colisiona en una actualización normal se rechaza, no se fusiona en silencio — tienes que confirmar tú mismo la fusión.
</Warning>

La misma operación está disponible como `POST /api/v1/leads/{id}/merge` o la herramienta MCP `merge_audience_contacts`.

## Eliminar un contacto

Elimina un contacto desde **More actions** en su panel. Esto elimina el registro del contacto de forma permanente y no se puede deshacer.

Sacar un lead de una [campaña](/es/campaigns/overview) es una acción distinta y no destructiva: el lead sale de la cola de esa campaña, y el contacto — con sus llamadas, conversaciones e historial — permanece en Audience.

## API y MCP

```bash theme={null}
GET  /api/v1/leads          # list contacts, with status/channel/tag/date filters
POST /api/v1/leads          # create a contact (or merge into a matching one)
POST /api/v1/leads/{id}/merge
```

Los clientes MCP pueden usar `list_audience_contacts`, `create_audience_contact` y `merge_audience_contacts` para la lista de contactos de todo el espacio de trabajo. `get_lead`, `update_lead` y `delete_lead` funcionan sobre un lead de **campaña** en lugar del registro de Audience — y `delete_lead` solo saca el lead de su campaña; el contacto permanece en Audience.