> For the complete documentation index, see [llms.txt](https://docs.hablla.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hablla.com/hablla-docs-es/datos/personas/importacion-de-personas.md).

# Importación de personas

Si ya tienes una base de contactos, clientes o leads, no es necesario registrar cada uno manualmente en Hablla. Nuestra plataforma te permite importar tu lista completa de una sola vez, facilitando y agilizando tu trabajo.

A continuación, preparamos un paso a paso sencillo sobre cómo acceder al área correcta e iniciar tu importación.

### Paso 1: Accediendo al área de Personas

Todo comienza en el menú principal de tu *workspace*. Sigue los pasos:

1. En el menú superior izquierdo, justo al lado del logo de Hablla, haz clic en el botón <kbd>**Datos**</kbd> para abrir el menú desplegable.

<figure><img src="https://4006966930-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrmxWrIrMauHcIrsuqfGq%2Fuploads%2Fk0hGXX7Ww8JsxsCXBjTl%2F7fe94c5d-04c5-4737-b07e-509978cde014.jfif?alt=media&amp;token=f0c5396c-1713-483e-baec-48fcd06011d6" alt=""><figcaption></figcaption></figure>

En el menú que se abrió, haz clic en la primera opción de la lista, llamada <kbd>**Personas**</kbd>.

### Paso 2: Iniciando la importación

Después de hacer clic en "Personas", serás dirigido al panel principal de gestión de tus contactos.

En esta pantalla, justo debajo de la descripción, haz clic en el botón <kbd>**Importar datos**</kbd> para comenzar la importación de personas a Hablla.

<figure><img src="https://4006966930-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrmxWrIrMauHcIrsuqfGq%2Fuploads%2FupMnCYrCNUeqRDD6NHdY%2F96820f2c-7cca-4b7d-9831-a20f8b1579fa.jfif?alt=media&amp;token=76dac110-aac1-45b7-aec8-eb5e6fb62827" alt=""><figcaption></figcaption></figure>

### Paso 3: La ventana de Importación

Al hacer clic en el botón Importar datos, se abrirá una nueva ventana (modal) en el centro de tu pantalla. Es aquí donde realmente ocurre el proceso de importación, dividido en etapas sencillas.

<figure><img src="https://4006966930-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrmxWrIrMauHcIrsuqfGq%2Fuploads%2FjGdPqmyjTf0D66FFlcjs%2Fc94acb06-1f54-44f7-83f7-a604b6698a75.jfif?alt=media&amp;token=d0fe686e-2468-4341-b137-5975b9ddec0a" alt=""><figcaption></figcaption></figure>

En esta nueva pantalla, notarás que la plataforma te guía por 4 pasos. Vamos a centrarnos en el primero y más importante para empezar.

### Paso 4: Descargando la plantilla de la hoja de cálculo

Para que Hablla pueda leer y organizar perfectamente la información de tus contactos (como nombre, teléfono, correo electrónico, etc.), los datos deben estar estandarizados. Para facilitarte la vida, ¡ya creamos un archivo con el formato exacto que exige el sistema!

1. En el paso 1 - Descarga la plantilla de la hoja de cálculo, haz clic en el botón Descargar hoja de cálculo modelo.
2. Se guardará un archivo de hoja de cálculo en tu computadora.
3. Abre este archivo y comienza a completar (o pegar) los datos de tus contactos en las columnas correspondientes.

{% hint style="warning" icon="triangle-exclamation" %}
Atención: Para garantizar que tu importación ocurra sin ningún error, **no alteres** ni **renombres** el título de ninguna columna de la hoja de cálculo que descargaste. Completa solo los datos en las filas debajo de los títulos originales.
{% endhint %}

<figure><img src="https://4006966930-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrmxWrIrMauHcIrsuqfGq%2Fuploads%2FGYU4aekufUdtTkPwW3nx%2FGemini_Generated_Image_r8srehr8srehr8sr.jfif?alt=media&amp;token=c4732e27-9d41-4c35-8cfe-166a9cc79ff1" alt=""><figcaption></figcaption></figure>

### Paso 5: Completando la hoja de cálculo con tus contactos

Al abrir el archivo de Excel que acabas de descargar, notarás que la primera línea (el encabezado) ya contiene los nombres de las columnas en inglés.

Para facilitarte las cosas, mira qué significa cada una de las columnas principales y cómo completarlas:

* **Name (Nombre)**: Escribe el nombre completo de la persona que deseas registrar.
* **DDI (Código del país)**: Es el código internacional telefónico. Si tus contactos son de Brasil, por ejemplo, solo tienes que completar con el número 55.
* **Phone (Teléfono)**: Introduce el número de teléfono del contacto junto con el código de área local. En nuestro ejemplo, usamos un número ficticio como *1199999-0000*.
* **Email**: La dirección de correo electrónico de la persona (complétala si tienes esa información).
* **SSN (Documento)**: Este es un campo destinado a documentos de identificación. Puedes usarlo para registrar el CPF o el RG del contacto, por ejemplo.

{% hint style="info" icon="lightbulb" %}
Consejo: Los campos de Email y SSN no son obligatorios para crear el contacto, ¡pero enriquecen el perfil de tu cliente dentro de Hablla!
{% endhint %}

<figure><img src="https://4006966930-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrmxWrIrMauHcIrsuqfGq%2Fuploads%2FtiYQxJFy3NdBb1BWoIVB%2FCaptura%20de%20tela%202026-08-14%20103235.png?alt=media&amp;token=003dce81-2b35-49cf-9e07-2b5864e5cf18" alt=""><figcaption></figcaption></figure>

### Paso 6: Configurando y finalizando la importación

Ahora que tu hoja de cálculo está completada y guardada en tu computadora, vuelve a la ventana de importación que dejamos abierta en Hablla. Vamos a configurar los últimos detalles:

2\. Selecciona la segmentación (Opcional)

* Si deseas organizar estos nuevos contactos en una segmentación específica que ya tienes, haz clic en el campo y elige la opción deseada. Si esa no es tu intención en este momento, ¡puedes saltarte este paso con tranquilidad!

3\. Sube la hoja de cálculo completada

* Haz clic en el botón Elegir archivo.
* Busca en tu computadora la hoja de cálculo que acabas de completar y selecciónala.

4\. Reglas de importación En esta etapa final, vamos a definir cómo debe actuar la plataforma con los datos que estás trayendo, ayudando a mantener tu base siempre organizada y sin desorden.

Primero, debes elegir cómo tratar los registros que posiblemente ya estén registrados:

* Actualizar existentes (Recomendado): Es la opción ideal para evitar contactos duplicados. El sistema reconoce si la persona ya existe en tu workspace y aprovecha su registro.
* Duplicar Personas: Como su nombre indica, esta opción crea un nuevo contacto en tu base, incluso si esa persona ya está registrada. Recomendamos mantener la opción anterior para no desorganizar tu lista, pero esta alternativa está disponible para casos muy específicos de tu operación.

Datos después de la importación Si elegiste "Actualizar existentes" en el paso anterior, aquí defines cómo hará el sistema esa actualización:

* Actualizar con nuevos datos: Si el contacto ya existe en tu base, su información se actualizará y complementará con los nuevos datos de tu hoja de cálculo.
* Mantener datos antiguos: El sistema reconoce que la persona ya existe, pero conserva los datos que ya estaban en Hablla, ignorando la información nueva de la hoja de cálculo para ese contacto específico.

Propietario (Opcional) No hay ninguna obligación de completar este campo. Define un propietario solo si deseas vincular a un miembro de tu equipo como responsable específico de estos contactos en el momento de la importación.

<figure><img src="https://4006966930-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrmxWrIrMauHcIrsuqfGq%2Fuploads%2FY8HaDzVcvt69D7qpfcq5%2Ffde65e37-8550-4412-8e57-59f53a6af210.jfif?alt=media&amp;token=8b2041d5-ccd9-48f3-9cdb-d36492859979" alt=""><figcaption></figcaption></figure>

Para finalizar, solo tienes que hacer clic en el botón Importar, ubicado en la esquina inferior derecha de la pantalla. Y listo, ¡tus contactos comenzarán a añadirse a tu workspace!

### Paso 7: Revisando tus nuevos contactos importados

Después de hacer clic en el botón de importar, la plataforma hará el trabajo pesado por ti. En instantes, el procesamiento se completará y ya podrás visualizar tu base de datos actualizada.

Todos los contactos que estaban en tu hoja de cálculo ahora aparecerán listados directamente en tu panel principal de Personas. Mira en el ejemplo abajo cómo el contacto que completamos en nuestra plantilla modelo ya aparece perfectamente registrado en el *workspace*, con el nombre, correo electrónico y teléfono organizados.

<figure><img src="https://4006966930-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrmxWrIrMauHcIrsuqfGq%2Fuploads%2FMV25bkByzZZqX8RTBu37%2Fd13c61f0-9c23-4159-b8a8-d2cc44a4be0a.jfif?alt=media&amp;token=6a5873ed-25ac-408f-8203-23e828818a13" alt=""><figcaption></figcaption></figure>

¡Listo! Ahora ya sabes cómo llevar toda tu base de clientes a Hablla de forma ágil y centralizada.

## Buenas prácticas para una importación exitosa

Para garantizar que tu experiencia sea perfecta y que tu base de contactos quede muy bien organizada en Hablla, te dejamos algunos consejos de oro:

* Haz primero una pequeña prueba: Si esta es tu primera vez importando datos a la plataforma, nuestra mayor recomendación es: **no importes tu lista completa de una sola vez**. Completa la plantilla modelo solo con 1 a 10 contactos de prueba. Haz el proceso de importación y ve a tu lista de Personas para comprobar si los datos (teléfono, correo electrónico, etc.) cayeron correctamente en cada campo. ¿Salió todo bien? ¡Genial, ahora puedes importar el resto de tu lista gigante con total seguridad!
* Revisa los formatos en la hoja de cálculo: Echa un vistazo rápido a tus datos antes de subirlos. Verifica si los números de teléfono tienen el DDI correcto (ej.: 55 para Brasil) y si no hay espacios en blanco al inicio o al final de los correos electrónicos y nombres.
* La Regla de Oro sigue vigente: Nunca está de más recordar que los títulos de las columnas en la plantilla modelo (como *Name*, *Phone*, etc.) no deben ser renombrados. La plataforma los necesita exactamente como están para "leer" la información correctamente.
* Evita duplicados: Siempre que sea posible, mantén la regla de importación en Actualizar existentes. Esto evita que crees contactos duplicados y mantiene tu *workspace* limpio y fácil de gestionar.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.hablla.com/hablla-docs-es/datos/personas/importacion-de-personas.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.