> ## 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.

# Importar contactos

> Trae contactos a Audience desde un archivo CSV, con mapeo de columnas y validación

La importación de CSV es la forma más rápida de añadir muchos contactos a la vez — ya sea que estés empezando una lista nueva o ampliando Audience con la exportación de una hoja de cálculo.

## Preparar tu archivo

* **Solo CSV** (no Excel), codificado en UTF-8, hasta 12 MB.
* Separado por comas o por punto y coma — Famulor detecta cuál a partir de la primera línea, así que las exportaciones de hojas de cálculo europeas funcionan tal cual.
* Se recomienda encarecidamente una fila de encabezado: Famulor la lee para preasignar las columnas obvias. Un archivo sin ella también se importa; las columnas simplemente se llaman Column 1, Column 2, y así sucesivamente.
* Cada fila necesita un número de teléfono. Todo lo demás — nombre, correo, etiquetas, campos personalizados — es opcional.

```csv theme={null}
phone,name,email,tags,company
+491701234567,Ada Lovelace,ada@example.com,vip;renewal,TechStart Solutions
+14155551234,Grace Hopper,grace@example.com,,Acme Corp
```

## Pasos de importación

Selecciona **Import** en Audience. El wizard tiene tres pasos.

<Steps>
  <Step title="Sube el archivo">
    Arrastra tu CSV o selecciónalo desde el disco. Se te pedirá que certifiques que estos contactos dieron su consentimiento para ser contactados y que no proceden de una lista comprada — esto es responsabilidad tuya, Famulor no lo valida por ti.
  </Step>

  <Step title="Asigna las columnas">
    Asigna cada columna a un destino: un campo de contacto (**Phone**, **Name**, **Email**, **Tags**), una variable de asistente (cuando importas directamente a una campaña con un asistente asignado), un **custom attribute** del espacio de trabajo, o una clave personalizada de formato libre. Las coincidencias obvias — una columna literalmente llamada "phone" o "email" — se preseleccionan; revisa y ajusta el resto, y pon en **Ignore this column** todo lo que no necesites.

    Este paso también incluye dos ajustes para todo el lote. **Default country for phone numbers** se añade a cualquier número que aún no incluya un código de país (`01701234567` → `+491701234567`), para que no tengas que dividir tu archivo por país de antemano. **Tags** añade las mismas etiquetas a cada contacto del lote.
  </Step>

  <Step title="Vista previa">
    Revisa los primeros cinco contactos asignados, comprueba los contadores **Ready to import** y **Skipped (invalid phone)**, y confirma.
  </Step>
</Steps>

## Dónde aterrizan los contactos importados

Importar desde **Audience** crea contactos sin asignar, disponibles para cualquier campaña y segmento del espacio de trabajo. El mismo botón **Import** también está en la propia página de una campaña — usado ahí, añade los contactos directamente a la cola de esa campaña en lugar de dejarlos sin asignar.

<Tip>
  Para añadir contactos ya existentes de Audience a una campaña en lugar de volver a importarlos, usa **Assign leads** en la campaña — elige un segmento guardado o selecciona contactos manualmente. Consulta [Configurar una campaña](/es/campaigns/overview#configurar-una-campaña).
</Tip>

## Referencia de asignación de columnas

| Destino                  | De dónde vienen los valores                                                                                                            |
| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------- |
| Phone, Name, Email, Tags | Campos de contacto integrados. Una columna **Tags** puede contener varias etiquetas separadas por comas o punto y coma                 |
| Assistant variable       | Solo se ofrece al importar a una campaña con un asistente asignado                                                                     |
| Custom attribute         | Campos definidos por el espacio de trabajo en **Settings → Workspace → Custom Attributes**                                             |
| Custom key               | Formato libre: letras minúsculas, dígitos y guiones bajos, empezando por una letra. `phone`, `name`, `email` y `tags` están reservados |

## Mantén tus datos limpios

* Prefiere el formato de teléfono E.164 (`+491701234567`) frente a formatos locales (`0170 123 4567`, `(030) 123-4567`) — elimina cualquier ambigüedad sobre el país.
* Guarda el archivo como CSV en UTF-8. Si exportas desde Excel, convierte las fórmulas en valores y evita las celdas combinadas antes de guardar.
* **Deduplica antes de importar.** Los números de teléfono y las direcciones de correo son únicos por espacio de trabajo, y una importación no fusiona con los registros existentes como sí hace el formulario de contacto individual — una fila cuyo teléfono o correo ya pertenezca a un contacto falla en su lugar. Elimina esas filas del archivo primero, o actualiza esos contactos de forma individual en Audience.
* Dale a cada lote de importación una etiqueta compartida (por ejemplo, `import-2026-08`) en el paso de asignar columnas para poder encontrar ese lote de nuevo en Audience más tarde.

## Solución de problemas

| Síntoma                                                       | Solución                                                                                                                                                                                                                       |
| ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| La subida se rechaza directamente                             | El archivo debe ser `.csv`, codificado en UTF-8 y de 12 MB o menos — Excel (`.xlsx`) no es compatible; expórtalo o guárdalo antes como CSV                                                                                     |
| No se importa ningún contacto                                 | Asegúrate de que una columna esté asignada a **Phone** — una fila sin un número de teléfono válido siempre se omite                                                                                                            |
| Hay menos contactos que filas en el archivo                   | Revisa el contador **Skipped (invalid phone)** en el paso de vista previa; esas filas tenían un número de teléfono que no se pudo interpretar                                                                                  |
| La importación se detiene con un error de identidad duplicada | El teléfono o el correo de una fila ya pertenece a otro contacto de este espacio de trabajo. Elimina las filas duplicadas e importa de nuevo — los contactos ya creados antes del fallo se conservan                           |
| Se añadió el código de país incorrecto                        | Solo a los números sin código de país se les añade el país predeterminado — establece el valor predeterminado correcto antes de confirmar, o corrige esos números para que incluyan `+<código de país>` en el archivo          |
| Se rechaza una custom key                                     | Las claves deben ser letras minúsculas, dígitos y guiones bajos, empezando por una letra. `phone`, `name`, `email` y `tags` están reservados; cambia el nombre de la columna o elige en su lugar un custom attribute existente |

Consulta también [Contactos](/es/audience/contacts) para editar y fusionar registros después de la importación, y [Campañas y leads](/es/campaigns/overview) para asignar contactos a tus campañas de contacto.