> 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/exportando-personas.md).

# Exportando personas

El recurso de **Exportación de Personas** permite generar un archivo que contenga los datos de las personas registradas en tu workspace de Hablla. Puedes exportar **todas las personas registradas** o usar los filtros disponibles para generar un archivo que contenga solo los registros que cumplan determinados criterios.

Este recurso puede ser útil para análisis externos, tratamiento de datos, creación de informes, verificaciones u otras situaciones en las que sea necesario trabajar con los datos de las personas fuera de Hablla.

{% hint style="info" %}
Para realizar la exportación, el usuario necesita tener las **permisos necesarios para acceder y visualizar los datos de Personas** dentro del workspace.
{% endhint %}

## Cómo exportar Personas

{% stepper %}
{% step %}

### 1. Accede a la página de Personas

En el menú superior de Hablla, haz clic en **Datos** y, a continuación, selecciona la opción **Personas**.

{% hint style="info" %}
Si estás usando un permiso que no sea de administrador, pero que tenga acceso a la gestión de personas, puedes hacer clic en la opción <kbd>**Personas**</kbd>
{% endhint %}

En esta página se mostrarán las personas registradas en tu workspace.

<figure><img src="https://4006966930-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrmxWrIrMauHcIrsuqfGq%2Fuploads%2FY9q3clRi0Vf0hsnwBMDR%2Fpessoas.png?alt=media&amp;token=7123c20d-a6d5-4d1c-b467-ba24d694e22e" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### 2. Aplica los filtros deseados

Antes de realizar la exportación, puedes usar los **Filtros** para definir qué personas deben formar parte del archivo. Este paso es opcional. Si no se aplica ningún filtro, la exportación considerará a todas las personas de tu workspace para exportación.

Puedes combinar diferentes filtros para localizar exactamente el conjunto de personas que deseas exportar. Entre los filtros disponibles están:

<table><thead><tr><th width="158.8275146484375">Filtro</th><th>Cómo funciona</th></tr></thead><tbody><tr><td><strong>Estado</strong></td><td>Permite filtrar a las personas de acuerdo con el <strong>estado de la persona</strong> dentro del workspace.</td></tr><tr><td><strong>Duplicados</strong></td><td>Permite identificar personas que poseen alguna <strong>información duplicada</strong> en el workspace, como dos personas registradas con el mismo número de teléfono o dirección de correo electrónico.</td></tr><tr><td><strong>Organizaciones</strong></td><td>Permite filtrar a las personas vinculadas a una <strong>Organización</strong> registradas en el workspace. Las Organizaciones pueden representar empresas u otros grupos a los que las personas están asociadas.</td></tr><tr><td><strong>Campos Personalizados</strong></td><td>Permite usar los <strong>Campos Personalizados de Personas</strong> como criterios de búsqueda. Selecciona el campo que deseas usar e informa el valor correspondiente. La forma de completar el filtro puede variar de acuerdo con el tipo de campo personalizado.</td></tr><tr><td><strong>Bloqueados</strong></td><td>Permite filtrar personas de acuerdo con su condición de <strong>bloqueo</strong>, lo que permite localizar tanto personas bloqueadas como personas que no están bloqueadas en tu workspace.</td></tr><tr><td><strong>Fecha</strong></td><td>Permite filtrar a las personas por un <strong>período específico</strong>, usando como referencia la fecha de <strong>Creación</strong> o de <strong>Última actualización</strong> de la persona.</td></tr><tr><td><strong>Etiquetas</strong></td><td>Permite localizar personas que tienen determinadas <strong>Etiquetas</strong> etiquetas vinculadas. Es posible seleccionar una o más etiquetas y, cuando se utilicen varias etiquetas, se considerarán las personas que cumplan con <strong>todas las etiquetas seleccionadas</strong>.</td></tr><tr><td><strong>Propietarios</strong></td><td>Permite filtrar a las personas de acuerdo con el <strong>usuario definido como Propietario</strong>. Es posible seleccionar uno o más usuarios para localizar a las personas que tienen a esos usuarios como sus respectivos propietarios.</td></tr><tr><td><strong>Seguidores</strong></td><td>Permite filtrar a las personas de acuerdo con los <strong>usuarios vinculados como Seguidores</strong>. Es posible seleccionar uno o más usuarios para localizar a las personas a las que estén vinculados como seguidores.</td></tr></tbody></table>

**Entendiendo el filtro por Fecha**

Al utilizar el filtro de **Fecha**, podrás elegir entre dos referencias:

* **Creado en:** considera la fecha en que la persona fue registrada originalmente en el workspace.
* **Actualizado en:** considera la fecha de la última modificación realizada en los datos de la persona. Siempre que se modifica alguna información del registro, esa modificación pasa a considerarse como su última actualización.

{% hint style="warning" %}
**Revisa los filtros antes de continuar.** Si existen filtros aplicados, solo se considerarán en la exportación las personas que correspondan a los criterios definidos.
{% endhint %}

Después de definir los registros que deseas exportar, haz clic en el botón <kbd>**Exportar datos**</kbd>, ubicado en el lateral izquierdo de la página, debajo de la descripción de la sección de Personas.&#x20;

Se mostrará una nueva ventana para configurar la exportación.

<figure><img src="https://4006966930-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrmxWrIrMauHcIrsuqfGq%2Fuploads%2FW8sOejWNPclaGGd1hgYA%2F0f68efd3-5cf4-4ebb-b029-71bbd1104ee3.jfif?alt=media&amp;token=7735b5ab-423d-46d2-a258-b1721f0cb975" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### 3. Configurando tu exportación

Antes de iniciar la generación del archivo, será necesario definir algunas informaciones muy rápidas. A continuación hablaremos brevemente de cada una de ellas:

* **Descripción**: Esta descripción se usará posteriormente para identificar la solicitud dentro del área de **Notificaciones** de Hablla.

> En nuestro ejemplo, definiremos la descripción como "**`Exportación Personas`**".

* **Extensión del archivo:** Elige en qué formato quieres exportar tu lista. Actualmente tenemos disponibles tres opciones de archivos. Estas son:&#x20;

> - **CSV**: Un formato de texto simple, excelente si vas a importar esta lista a otros sistemas o plataformas. OBS: Excel también acepta este tipo de archivo.
> - **JSON**: Un formato más técnico, generalmente usado por equipos de desarrollo para integraciones.
> - **XLSX**: El formato clásico de Excel. Elige este si solo quieres abrir la hoja de cálculo para leer y organizar los datos en tu computadora.

<figure><img src="https://4006966930-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrmxWrIrMauHcIrsuqfGq%2Fuploads%2FDBo6B2dp6N9sa5uYg9ZJ%2Fexport.png?alt=media&amp;token=9e51ce34-b5dc-43aa-95d0-60a75f81baba" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### 4. Exportación y descarga del archivo

Después de revisar la descripción, el formato elegido y la cantidad de personas que se exportarán, haz clic en **Exportar**. Hablla recibirá tu solicitud y mostrará una notificación en la esquina superior derecha de la pantalla informando que la exportación se solicitó con éxito.

La generación del archivo se realiza en segundo plano. Por eso, dependiendo de la cantidad de registros que deban procesarse, el archivo puede no estar disponible para su descarga de inmediato, por lo que recomendamos hacer un seguimiento después de la solicitud.

{% hint style="info" %}
Las exportaciones más pequeñas normalmente se procesan más rápido, mientras que las exportaciones con una mayor cantidad de registros pueden tardar más en completarse.
{% endhint %}

No necesitas permanecer en la página de Personas mientras el archivo se procesa. Para seguir la solicitud, accede al área de **Notificaciones** de tu workspace haciendo clic en el ícono de **notificación** :bell: en la esquina superior derecha de tu pantalla.
{% endstep %}

{% step %}

### 5. Descarga el archivo

Cuando el procesamiento haya finalizado, la exportación estará disponible en el área de **Notificaciones**. Localiza la exportación correspondiente con el mismo nombre definido anteriormente en el campo "**Descripción**" en la configuración de la exportación y haz clic en el botón <kbd>**Descargar**</kbd>.

El archivo se descargará en tu dispositivo en el formato seleccionado durante la configuración de la exportación.

<figure><img src="https://4006966930-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrmxWrIrMauHcIrsuqfGq%2Fuploads%2FvysIyVEpKnNE9wz2Q6v0%2F%5BDOCS%5D%20-%20Exportando%20Pessoas.gif?alt=media&amp;token=e01be218-a157-45d2-9ad3-22b9c57f38ce" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### Listo :white\_check\_mark:

Con el archivo generado y la descarga completada, tendrás los datos de las personas exportadas según los criterios definidos anteriormente.

Siempre que necesites exportar solo una parte de tu base, utiliza los **Filtros** antes de solicitar la exportación. De esta forma, puedes generar archivos más específicos y trabajar solo con los registros necesarios para cada finalidad.


---

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