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

# Exportando Pessoas

O recurso de **Exportação de Pessoas** permite gerar um arquivo contendo os dados das pessoas cadastradas no seu workspace da Hablla. Você pode exportar **todas as pessoas cadastradas** ou utilizar os filtros disponíveis para gerar um arquivo contendo apenas os registros que atendam a determinados critérios.

Esse recurso pode ser útil para análises externas, tratamento de dados, criação de relatórios, conferências ou outras situações em que seja necessário trabalhar com os dados das pessoas fora da Hablla.

{% hint style="info" %}
Para realizar a exportação, o usuário precisa possuir as **permissões necessárias para acessar e visualizar os dados de Pessoas** dentro do workspace.
{% endhint %}

## Como exportar Pessoas

{% stepper %}
{% step %}

### 1. Acesse a página de Pessoas

No menu superior da Hablla, clique em **Dados** e, em seguida, selecione a opção **Pessoas**.

{% hint style="info" %}
Se você estiver usando uma permissão que não seja de administrador, mas que tenha acesso ao gerenciamento de pessoas, você pode clicar na opção <kbd>**Pessoas**</kbd>
{% endhint %}

Nesta página serão apresentadas as pessoas cadastradas no seu workspace.

<figure><img src="https://1879311494-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. Aplique os filtros desejados

Antes de realizar a exportação, você pode utilizar os **Filtros** para definir quais pessoas deverão fazer parte do arquivo. Essa etapa é opcional. Caso nenhum filtro seja aplicado, a exportação considerará todas as pessoas do seu workspace para exportação.

Você pode combinar diferentes filtros para localizar exatamente o conjunto de pessoas que deseja exportar. Entre os filtros disponíveis estão:

<table><thead><tr><th width="158.8275146484375">Filtro</th><th>Como funciona</th></tr></thead><tbody><tr><td><strong>Status</strong></td><td>Permite filtrar as pessoas de acordo com o <strong>status da person</strong> dentro do workspace.</td></tr><tr><td><strong>Duplicados</strong></td><td>Permite identificar pessoas que possuem alguma <strong>informação duplicada</strong> no workspace, como duas pessoas cadastradas com o mesmo número de telefone ou endereço de e-mail.</td></tr><tr><td><strong>Organizações</strong></td><td>Permite filtrar as pessoas vinculadas a uma <strong>Organização</strong> cadastradas no workspace. As Organizações podem representar empresas ou outros grupos aos quais as pessoas estão associadas.</td></tr><tr><td><strong>Campos Personalizados</strong></td><td>Permite utilizar os <strong>Campos Personalizados de Pessoas</strong> como critérios de busca. Selecione o campo que deseja utilizar e informe o valor correspondente. A forma de preenchimento do filtro poderá variar de acordo com o tipo do campo personalizado.</td></tr><tr><td><strong>Bloqueados</strong></td><td>Permite filtrar pessoas de acordo com sua condição de <strong>bloqueio</strong>, possibilitando localizar tanto pessoas bloqueadas quanto pessoas que não estão bloqueadas no seu workspace.</td></tr><tr><td><strong>Data</strong></td><td>Permite filtrar as pessoas por um <strong>período específico</strong>, utilizando como referência a data de <strong>Criação</strong> ou de <strong>Última Atualização</strong> da pessoa.</td></tr><tr><td><strong>Etiquetas</strong></td><td>Permite localizar pessoas que possuem determinadas <strong>Etiquetas</strong> vinculadas. É possível selecionar uma ou mais etiquetas e, quando múltiplas etiquetas forem utilizadas, serão consideradas as pessoas que atendam a <strong>todas as etiquetas selecionadas</strong>.</td></tr><tr><td><strong>Donos</strong></td><td>Permite filtrar as pessoas de acordo com o <strong>usuário definido como Dono</strong>. É possível selecionar um ou mais usuários para localizar as pessoas que possuem esses usuários como seus respectivos donos.</td></tr><tr><td><strong>Seguidores</strong></td><td>Permite filtrar as pessoas de acordo com os <strong>usuários vinculados como Seguidores</strong>. É possível selecionar um ou mais usuários para localizar as pessoas às quais eles estejam vinculados como seguidores.</td></tr></tbody></table>

**Entendendo o filtro por Data**

Ao utilizar o filtro de **Data**, você poderá escolher entre duas referências:

* **Criado em:** considera a data em que a pessoa foi originalmente cadastrada no workspace.
* **Atualizado em:** considera a data da última modificação realizada nos dados da pessoa. Sempre que alguma informação do cadastro é alterada, essa modificação passa a ser considerada como sua última atualização.

{% hint style="warning" %}
**Confira os filtros antes de continuar.** Caso existam filtros aplicados, somente as pessoas correspondentes aos critérios definidos serão consideradas na exportação.
{% endhint %}

Após definir os registros que deseja exportar, clique no botão <kbd>**Exportar Dados**</kbd>, localizado na lateral esquerda da página, abaixo da descrição da seção de Pessoas.&#x20;

Uma nova janela será apresentada para configurar a exportação.

<figure><img src="https://1879311494-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 sua Exportação

Antes de iniciar a geração do arquivo, será necessário definir algumas informações bem rápidas. Falaremos um pouco de cada uma delas brevemente a seguir:

* **Descrição**: Essa descrição será utilizada posteriormente para identificar a solicitação dentro da área de **Notificações** da Hablla.

> No nosso exemplo, definiremos a descrição como "**`Exportação Pessoas`**".

* **Extensão do Arquivo:** Escolha em qual formato você quer exportar a sua lista. Atualmente temos disponíveis três opções de arquivos. Sendo elas:&#x20;

> - **CSV**: Um formato de texto simples, excelente se você for importar essa lista em outros sistemas ou plataformas. OBS: O excel também aceita esse tipo de arquivo.
> - **JSON**: Um formato mais técnico, geralmente usado por equipes de desenvolvimento para integrações.
> - **XLSX**: O formato clássico do Excel. Escolha este se você quiser apenas abrir a planilha para ler e organizar os dados no seu computador.

<figure><img src="https://1879311494-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. Exportação e download do arquivo

Após conferir a descrição, o formato escolhido e a quantidade de pessoas que serão exportadas, clique em **Exportar**. A Hablla receberá sua solicitação e exibirá uma notificação no canto superior direito da tela informando que a exportação foi solicitada com sucesso.

A geração do arquivo é realizada em segundo plano. Por isso, dependendo da quantidade de registros que precisam ser processados, o arquivo pode não ficar disponível para download imediatamente, portanto, recomendamos o acompanhamento após a solicitação.

{% hint style="info" %}
Exportações menores normalmente são processadas mais rapidamente, enquanto exportações com uma quantidade maior de registros podem levar mais tempo para serem concluídas.
{% endhint %}

Você não precisa permanecer na página de Pessoas enquanto o arquivo é processado. Para acompanhar a solicitação, acesse a área de **Notificações** do seu workspace clicando no ícone de **notificação** :bell: no canto superior direito da sua tela.
{% endstep %}

{% step %}

### 5. Baixe o arquivo

Quando o processamento for concluído, a exportação ficará disponível na área de **Notificações**. Localize a exportação correspondente com o mesmo nome definido anteriormente no campo "**Descrição**" na configuração da exportação e clique no botão <kbd>**Baixar**</kbd>.

O arquivo será baixado para o seu dispositivo no formato selecionado durante a configuração da exportação.

<figure><img src="https://1879311494-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 %}

### Pronto :white\_check\_mark:

Com o arquivo gerado e concluído o download, você terá os dados das pessoas exportadas de acordo com os critérios definidos anteriormente.

Sempre que precisar exportar apenas uma parte da sua base, utilize os **Filtros** antes de solicitar a exportação. Dessa forma, você pode gerar arquivos mais específicos e trabalhar somente com os registros necessários para cada finalidade.


---

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