# Importar contactos desde una hoja de cálculo

> En Leads → Importar leads, sube un CSV, XLS o XLSX con encabezado en la primera fila, vincula las columnas a Nombre, Email, Teléfono, Etiquetas o campos personalizados, elige el código de país y las etiquetas del lote, valida e importa. Quien ya existe por email o teléfono se actualiza, sin duplicados.

Fonte: https://wiki.bip.marketing/es-es/importar-contactos · Atualizado: 2026-10-08

<UseCaseMeta effort="csv" plan="free" />

Trae toda tu base de una vez: los clientes de la tienda, los inscritos de un evento, la lista que estaba en el CRM anterior. En pocos minutos, todos están en la BIP, con etiquetas y campos listos para segmentar.

<Checklist items="Una cuenta en la BIP (sirve el plan gratuito)|Una hoja de cálculo CSV, XLS o XLSX de hasta 200 MB, con encabezado en la primera fila|Una columna de nombre y otra de email o teléfono|Los campos personalizados creados en Ajustes, si la hoja trae datos adicionales" />

## Lo que vas a lograr

- Toda tu lista dentro de la BIP, sin duplicados: quien ya existe por email o por teléfono se actualiza.
- Teléfonos en formato internacional, listos para WhatsApp, aunque la hoja solo traiga el código de área y el número.
- Una etiqueta del lote en todos los contactos (por ejemplo `feria-abril-2026`), para armar el segmento al instante.
- Fechas, ciudades y otros datos en los campos personalizados, listos para criterios como cumpleaños y radio.

## Cómo funciona

<Steps items="Sube la hoja y vincula cada columna a un campo de la BIP|Valida: la BIP revisa nombre, email y teléfono fila por fila|Importa: los contactos nuevos se crean y los existentes se actualizan" />

La BIP reconoce a cada persona por el **email** o por el **teléfono**. Cuando una fila coincide con un contacto que ya existe:

- el nombre de la hoja pasa a ser el vigente;
- los emails y teléfonos nuevos se suman al perfil;
- las etiquetas se suman (la importación nunca quita etiquetas);
- los campos personalizados completos se actualizan, y las celdas vacías mantienen el valor actual (o borran el campo, si así lo eliges en el mapeo);
- un contacto archivado vuelve a la lista.

## Paso a paso

### 1. Crea los campos personalizados

Nombre, email, teléfono y etiquetas ya existen en todo contacto. Para cualquier otro dato de la hoja (fecha de nacimiento, ciudad, plan), crea el campo antes de importar. Así aparece en el mapeo.

1. En **Ajustes** → **General**, ve a **Campos** y haz clic en **Añadir campo**.
2. Elige el **Tipo de campo**: **Cadena** (texto), **Número**, **Booleano**, **Fecha**, **Teléfono**, **Ubicación** o **Array** (lista).
3. Completa el **Nombre del campo** (por ejemplo, _Fecha de nacimiento_) y haz clic en **Guardar**.

<Shot src="/img/importar-contatos/1-es-es.png" alt="Campos personalizados en Ajustes, pestaña General" url="dash.bip.marketing/…/settings" />

### 2. Sube el archivo

1. En **Leads**, haz clic en **Importar leads**. El importador tiene cuatro pasos: **Subir archivo**, **Mapear columnas**, **Validar datos** e **Importar leads**.
2. Arrastra la hoja al área de carga o haz clic en **Examinar archivos**. La BIP acepta CSV, XLS y XLSX de hasta 200 MB. En XLS y XLSX, lee la primera pestaña.
3. Revisa la **Vista previa de leads**: el total de filas y columnas y los datos del archivo, página por página.
4. Haz clic en **Siguiente paso**.

<Shot src="/img/importar-contatos/2-es-es.png" alt="Paso Subir archivo con la vista previa de la hoja" url="dash.bip.marketing/…/leads/import" />

### 3. Mapea las columnas

1. La BIP ya sugiere el mapeo según el encabezado: las columnas con "email" o "e-mail" van a **Email**; con "nome", "name" o "usuario", a **Nombre**; con "telefone", "phone" o "cel" (como "celular"), a **Teléfono**. Encabezados como "nombre" o "teléfono" no se reconocen solos: vincúlalos a mano en **Campo del lead**.
2. En **Campo del lead**, ajusta cada columna: elige **Nombre**, **Email**, **Teléfono** o **Etiquetas** en **Campos estándar**, o uno de los **Campos personalizados**. La columna **Datos de muestra** muestra un valor real para que lo compruebes.
3. Deja en **Omitir esta columna** lo que no debe entrar.
4. Decide qué hacer con las celdas vacías. Con **Borrar campos en celdas vacías** desactivado (la opción predeterminada), una celda vacía mantiene lo que el contacto ya tiene. Si lo activas, una celda vacía en un campo personalizado borra ese campo del contacto.
5. Haz clic en **Siguiente paso**.

El mapeo necesita **Nombre** y **Email** o **Teléfono** (o los dos). Cada campo de la BIP recibe una sola columna. En la columna vinculada a **Etiquetas**, separa varias etiquetas con comas: `cliente, vip`.

<Shot src="/img/importar-contatos/3-es-es.png" alt="Paso Mapear columnas con las columnas vinculadas a Nombre, Email, Teléfono y campos personalizados" url="dash.bip.marketing/…/leads/import" />

### 4. Valida los datos

1. En **Código de país predeterminado**, elige el país de los teléfonos que vinieron sin código: Brasil (+55), Portugal (+351), Estados Unidos (+1), España (+34) o Francia (+33). Con Brasil, `11 91234-5678` se convierte en `+5511912345678`. Al cambiar el país, la validación se rehace al instante.
2. En **Etiquetas**, agrega las etiquetas del lote. Se aplican a todos los contactos de la hoja, nuevos o existentes.
3. Sigue la validación: la BIP muestra cuántos registros se procesaron, cuántos son válidos, cuántos tienen advertencias y cuántos tienen errores.
4. Si hay problemas, revisa **Problemas más comunes** (con filas de ejemplo) y **Problemas por columna**. Corrige la hoja y vuelve a subirla, o sigue con las filas válidas.

- **Error**: la fila queda fuera. Ocurre cuando falta el nombre o cuando el email y el teléfono son inválidos a la vez.
- **Advertencia**: la fila entra. El email o el teléfono inválido se descarta y el contacto se importa con el otro dato.

<Shot src="/img/importar-contatos/4-es-es.png" alt="Paso Validar datos con código de país, etiquetas del lote y resumen de la validación" url="dash.bip.marketing/…/leads/import" />

### 5. Confirma e importa

1. Haz clic en **Siguiente paso**. La ventana **Confirmar importación** muestra los **Registros totales**, los **Registros válidos para importar**, los registros con error (que se ignorarán), los que tienen advertencia (que se importarán) y las etiquetas del lote.
2. Haz clic en **Importar _N_ registro(s)**.
3. Deja la página abierta hasta que aparezca **Importación completada**. La barra de progreso muestra cuántos se procesaron, cuántos se importaron y, si es el caso, cuántos fallaron.

<Callout type="warning">
No cierres ni recargues la página durante la importación. Los contactos se envían por lotes desde esta pantalla, y el paso solo termina cuando aparece **Importación completada**.
</Callout>

<Shot src="/img/importar-contatos/5-es-es.png" alt="Paso Importar leads con la importación completada" url="dash.bip.marketing/…/leads/import" />

## Listo para copiar

### Plantilla de hoja de cálculo

Copia, pega en un editor de texto y guarda como `contactos.csv`. Antes, crea los campos _Fecha de nacimiento_ (tipo Fecha) y _Ciudad_ (tipo Ubicación). Como la BIP no reconoce sola los encabezados `nombre` y `teléfono`, vincúlalos a **Nombre** y **Teléfono** en el mapeo.

<Copy label="contactos.csv" code>
nombre,email,teléfono,etiquetas,fecha_nacimiento,ciudad
Marina Alves,marina.alves@example.com,11 91234-5678,"cliente, vip",12/05/1990,"Curitiba, PR"
Tiago Pereira,tiago.pereira@example.com,,cliente,03/11/1985,"Porto Alegre, RS"
Sofia Costa,,21 99876-5432,newsletter,27/08/1994,"Niterói, RJ"
</Copy>

| Columna          | Campo del lead                                        |
| ---------------- | ----------------------------------------------------- |
| nombre           | Nombre                                                |
| email            | Email                                                 |
| teléfono         | Teléfono                                              |
| etiquetas        | Etiquetas                                             |
| fecha_nacimiento | Fecha de nacimiento (campo personalizado, tipo Fecha) |
| ciudad           | Ciudad (campo personalizado, tipo Ubicación)          |

### Formato de cada tipo de campo

| Tipo      | Escríbelo así                                                | Ejemplo             |
| --------- | ------------------------------------------------------------ | ------------------- |
| Cadena    | Cualquier texto                                              | Plan Oro            |
| Número    | Punto como separador decimal, sin separador de miles         | 1250.90             |
| Booleano  | `true` o `false`                                             | true                |
| Fecha     | dd/mm/aaaa o aaaa-mm-dd, con dos dígitos en el día y el mes  | 05/03/1990          |
| Teléfono  | Con `+` y el código de país                                  | +55 41 99876-5432   |
| Ubicación | Nombre de la ciudad, de preferencia con el estado            | Curitiba, PR        |
| Array     | Elementos separados por comas                                | panes, dulces, café |

Un valor fuera de formato queda fuera solo en ese campo; el resto de la fila entra normalmente. La **Ubicación** siempre se guarda como ciudad.

<Callout type="tip">
En Excel, aplica el formato **Texto** a las columnas de fecha y de teléfono antes de guardar. Así la fecha queda en dd/mm/aaaa y el teléfono no se convierte en un número abreviado. Para CSV, usa **Guardar como → CSV UTF-8**: los acentos llegan bien, con coma o punto y coma como separador.
</Callout>

### Etiquetas del lote

Usa un patrón que diga de dónde vino la persona y cuándo:

<Copy label="Ejemplos de etiquetas del lote">
importacion-2026-10
feria-abril-2026
crm-anterior
clientes-tienda-centro
</Copy>

### Segmento del lote

En **Segmentos**, basta un criterio para hablar solo con quienes llegaron en esta importación:

| Criterio  | Operador           | Valor            |
| --------- | ------------------ | ---------------- |
| Etiquetas | Incluye cualquiera | feria-abril-2026 |

## Cómo medir

- El paso **Importar leads** cierra con los números finales: procesados, importados y, si los hay, los que fallaron. Al terminar, la BIP confirma el total con el mensaje **Importación completada con éxito**.
- En **Segmentos**, crea el segmento del lote (**Etiquetas** → **Incluye cualquiera** → la etiqueta del lote). El conteo en vivo muestra cuántos contactos tienen la etiqueta: es el tamaño real de la lista que acabas de traer.
- Si el conteo quedó por debajo de lo esperado, vuelve a la hoja y revisa las filas sin nombre o sin email ni teléfono válidos. Importa de nuevo: quien ya entró solo se actualiza.

## Preguntas frecuentes

### ¿La importación duplica a quien ya está en la BIP?

No. La BIP reconoce al contacto por el email o por el teléfono y actualiza el perfil existente: suma emails, teléfonos y etiquetas nuevos y actualiza los campos completos. Puedes importar la misma hoja otra vez sin miedo.

### ¿Importar contactos cuenta como envío?

No. Importar, guardar y segmentar contactos no consume envíos. Solo cuenta el email o el mensaje de WhatsApp que sale hacia una persona.

### ¿Por qué algunas filas no entraron?

Toda fila necesita un nombre de al menos 2 caracteres y un email o teléfono válido. Las filas que no los tienen aparecen como error en la validación o como fallo al final de la importación. Corrige la hoja e importa de nuevo.

### Mi hoja llegó con los acentos cambiados. ¿Qué hago?

Guarda el archivo como **CSV UTF-8** (en Excel: **Guardar como** → **CSV UTF-8**) o sube el XLSX directamente, sin convertirlo. Después, vuelve a importar.

## Ver también

- [Primeros pasos en la BIP](/es-es/primeros-pasos)
- [Segmentos: los 10 criterios para filtrar contactos](/es-es/segmentos)
- [Campañas: únicas, recurrentes y por API](/es-es/campanas)
- [API de la BIP: claves, contactos, eventos y disparos](/es-es/api)