> 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/importacao-de-pessoas.md).

# Importação de Pessoas

Se você já possui uma base de contatos, clientes ou leads, não é necessário cadastrar cada um deles manualmente na Hablla. Nossa plataforma permite que você importe a sua lista completa de uma só vez, facilitando e acelerando o seu trabalho!

Abaixo, preparamos um passo a passo simples de como acessar a área correta e iniciar a sua importação.

### Passo 1: Acessando a área de Pessoas

Tudo começa no menu principal do seu *workspace*. Siga os passos:

1. No menu superior esquerdo, logo ao lado da logo da Hablla, clique no botão <kbd>**Dados**</kbd> para abrir o menu suspenso.

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

No menu que se abriu, clique na primeira opção da lista, chamada <kbd>**Pessoas**</kbd>.

### Passo 2: Iniciando a importação

Após clicar em "Pessoas", você será direcionado para o painel principal de gerenciamento dos seus contatos.

Nesta tela, logo abaixo da descrição, clique sobre o botão <kbd>**Importar dados**</kbd> para começarmos a sua importação de pessoas para a Hablla.

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

### Passo 3: A janela de Importação

Ao clicar no botão Importar dados, uma nova janela (modal) se abrirá no centro da sua tela. É aqui que o processo de importação realmente acontece, dividido em etapas simples.

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

Nesta nova tela, você notará que a plataforma te guia por 4 passos. Vamos focar no primeiro e mais importante deles para começar.

### Passo 4: Baixando o modelo de planilha

Para que a Hablla consiga ler e organizar perfeitamente as informações dos seus contatos (como nome, telefone, e-mail, etc.), os dados precisam estar padronizados. Para facilitar a sua vida, nós já criamos um arquivo com o formato exato que o sistema exige!

1. Na etapa 1 - Baixe o modelo de planilha, clique no botão Baixar planilha modelo.
2. Um arquivo de planilha será salvo no seu computador.
3. Abra este arquivo e comece a preencher (ou colar) os dados dos seus contatos nas colunas correspondentes.

{% hint style="warning" icon="triangle-exclamation" %}
Atenção: Para garantir que a sua importação ocorra sem nenhum erro, **não altere** ou **renomeie** o título de nenhuma coluna da planilha que você baixou. Preencha apenas os dados nas linhas abaixo dos títulos originais.
{% endhint %}

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

### Passo 5: Preenchendo a planilha com seus contatos

Ao abrir o arquivo Excel que você acabou de baixar, você notará que a primeira linha (o cabeçalho) já contém os nomes das colunas em inglês.

Para facilitar, veja o que significa cada uma das colunas principais e como preenchê-las:

* **Name (Nome)**: Digite o nome completo da pessoa que você deseja cadastrar.
* **DDI (Código do País)**: É o código internacional de telefone. Se os seus contatos forem do Brasil, por exemplo, basta preencher com o número 55.
* **Phone (Telefone)**: Insira o número de telefone do contato junto com o DDD local. No nosso exemplo, usamos um número fictício como *1199999-0000*.
* **Email**: O endereço de e-mail da pessoa (preencha caso você tenha essa informação).
* **SSN (Documento)**: Este é um campo destinado a documentos de identificação. Você pode usá-lo para registrar o CPF ou RG do contato, por exemplo.

{% hint style="info" icon="lightbulb" %}
Dica: Os campos de Email e SSN não são obrigatórios para a criação do contato, mas enriquecem o perfil do seu cliente dentro da Hablla!
{% endhint %}

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

### Passo 6: Configurando e finalizando a importação

Agora que a sua planilha está preenchida e salva no seu computador, retorne para a janela de importação que deixamos aberta na Hablla. Vamos configurar os últimos detalhes:

2\. Selecione a segmentação (Opcional)

* Se você deseja organizar esses novos contatos em uma segmentação específica que você já possui, clique no campo e escolha a opção desejada. Se essa não for a sua intenção no momento, pode pular esta etapa tranquilamente!

3\. Faça o upload da planilha preenchida

* Clique no botão Escolher arquivo.
* Busque no seu computador a planilha que você acabou de preencher e selecione-a.

4\. Regras de importação Nesta etapa final, vamos definir como a plataforma deve lidar com os dados que você está trazendo, ajudando a manter sua base sempre organizada e sem bagunça.

Primeiro, você deve escolher como tratar registros que porventura já estejam cadastrados:

* Atualizar existentes (Recomendado): É a opção ideal para evitar contatos repetidos. O sistema reconhece se a pessoa já existe no seu workspace e aproveita o cadastro dela.
* Duplicar Pessoas: Como o nome sugere, essa opção cria um novo contato na sua base, mesmo que aquela pessoa já esteja cadastrada. Recomendamos manter a opção anterior para não desorganizar sua lista, mas essa alternativa fica disponível para casos muito específicos da sua operação.

Dados após importação Caso você tenha escolhido "Atualizar existentes" no passo acima, é aqui que você define como o sistema fará essa atualização:

* Atualizar com novos dados: Se o contato já existir na sua base, as informações dele serão atualizadas e complementadas com os dados novos da sua planilha.
* Manter dados antigos: O sistema reconhece que a pessoa já existe, mas preserva os dados que já estavam na Hablla, ignorando as informações novas da planilha para esse contato específico.

Dono (Opcional) Não há nenhuma obrigatoriedade de preencher este campo. Defina um dono apenas se você desejar atrelar um membro da sua equipe como responsável específico por esses contatos logo no momento da importação.

<figure><img src="https://1879311494-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, basta clicar no botão Importar, localizado no canto inferior direito da tela. E pronto, seus contatos começarão a ser adicionados ao seu workspace!

### Passo 7: Conferindo seus novos contatos importados

Após clicar no botão de importar, a plataforma fará o trabalho pesado por você. Em instantes, o processamento será concluído e você já poderá visualizar a sua base de dados atualizada!

Todos os contatos que estavam na sua planilha agora aparecerão listados diretamente no seu painel principal de Pessoas. Veja no exemplo abaixo como o contato que preenchemos na nossa planilha modelo já aparece perfeitamente cadastrado no *workspace*, com o nome, e-mail e telefone organizados.

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

Pronto! Agora você já sabe como trazer toda a sua base de clientes para a Hablla de forma ágil e centralizada.

## Boas Práticas para uma Importação de Sucesso

Para garantir que a sua experiência seja perfeita e que a sua base de contatos fique muito bem organizada na Hablla, separamos algumas dicas de ouro:

* Faça um pequeno teste primeiro: Se esta é a sua primeira vez importando dados para a plataforma, nossa maior recomendação é: **não importe sua lista inteira de uma vez**. Preencha a planilha modelo com apenas 1 a 10 contatos de teste. Faça o processo de importação e vá até a sua lista de Pessoas para conferir se os dados (telefone, e-mail, etc.) caíram certinhos em cada campo. Deu tudo certo? Ótimo, agora você pode importar o resto da sua lista gigante com total segurança!
* Revise os formatos na planilha: Dê uma conferida rápida nos seus dados antes de fazer o upload. Verifique se os números de telefone estão com o DDI correto (ex: 55 para o Brasil) e se não há espaços em branco vazios no começo ou no final dos e-mails e nomes.
* A Regra de Ouro continua: Nunca é demais lembrar que os títulos das colunas na planilha modelo (como *Name*, *Phone*, etc.) não devem ser renomeados. A plataforma precisa deles exatamente como estão para "ler" as informações corretamente.
* Evite duplicatas: Sempre que possível, mantenha a regra de importação em Atualizar existentes. Isso evita que você crie contatos repetidos e mantém o seu *workspace* limpo e fácil de gerenciar.


---

# 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/importacao-de-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.