# Trazer meus clientes de uma planilha

Fonte: https://docs.barbeiro.app/business-admin/clients/import-clients
Perfil: Administrador
Verificado em: 2026-09-03

Se você já tem a lista dos seus clientes em outro sistema ou numa planilha,
dá para trazer todo mundo de uma vez em vez de cadastrar um por um.

## Antes de começar

-   Você precisa ser **administrador** da barbearia (a mesma permissão de
    cadastrar cliente).
-   A lista precisa estar num arquivo **.csv**. Se a sua planilha está no
    Excel: **Arquivo → Salvar como → CSV UTF-8**.
-   A planilha precisa ter, no mínimo, uma coluna com o **nome** e uma coluna
    com o **telefone** ou o **e-mail**. Sem um contato não conseguimos
    reconhecer quem é a pessoa.
-   Só uma importação por vez. Se você já começou uma e parou no meio, dá para
    **continuar** ou **descartar** ela na hora — veja
    a seção **Se já tem uma importação começada**, abaixo.
    Não é preciso esperar nada.

> **Nota**
>
> Nada entra na sua lista antes de você confirmar. As três primeiras telas são só conferência —
> você vê exatamente quantos clientes vão entrar antes de apertar o botão.

## Passo a passo

1. Na lista de **Clientes**, toque em **Importar**.

2. **Arquivo.** Toque em **Escolher planilha** e selecione o arquivo .csv. No computador você
   também pode arrastar o arquivo para dentro da área pontilhada. Depois toque em **Continuar**.

3. **Conferir.** Mostramos cada coluna da sua planilha com três exemplos tirados
   do seu próprio arquivo e para onde ela vai (Nome, Telefone, E-mail, Data de
   aniversário).

   Cada coluna vem com um aviso escrito:

   -   **Reconhecemos sozinho** — acertamos, pode seguir.
   -   **Confira: não temos certeza desta** — olhe os exemplos e confirme.
   -   **Não reconhecemos esta coluna** — escolha para onde ela vai, ou deixe
       como está para não trazer.

   Se quiser mudar alguma, é só escolher outra opção na lista.

4. As colunas que **não vamos trazer** ficam guardadas num botão embaixo da lista: **+ N
   informações que não vamos trazer**. Colunas como `Última vez`, `Serviços` ou `Profissional` caem
   aí — isso é normal, não é erro. Toque no botão se quiser conferir ou aproveitar alguma delas.

5. **Como vai ficar.** Aqui aparecem os números antes de qualquer coisa acontecer: quantos são
   **clientes novos**, quantos **já têm conta**, quantos **vamos pular** e quantos estão **com
   erro**. Logo abaixo, os primeiros da sua planilha, um por um.

6. Ainda nessa tela, escolha a **base legal** e marque a confirmação. É uma exigência da LGPD: você
   é o responsável pelos dados desta planilha e guardamos essa confirmação junto com a importação.

7. Toque no botão que diz o número — por exemplo **Trazer 1.270 clientes**. A partir daqui a
   importação roda sozinha.

8. **Trazendo.** A barra mostra o andamento. **Pode fechar esta página** — a importação continua e
   o resultado fica guardado nesse mesmo endereço.

## Se já tem uma importação começada

Trazer uma planilha tem várias telas, e é normal parar no meio — o telefone
toca, chega um cliente. A importação **fica guardada** exatamente onde você
parou.

Quando você entrar em **Importar** com uma importação já começada, em vez da
área de escolher arquivo aparece um aviso com o nome da planilha e o que dá
para fazer:

1. **Continuar de onde parei** — volta para a tela em que você estava (escolher as colunas, ou
   conferir como vai ficar).

2. **Descartar e escolher outra** — encerra aquela importação e libera para você mandar outra
   planilha. Pedimos uma confirmação antes. **Nenhum cliente é apagado**: a importação descartada
   nunca chegou a criar ninguém, e o que já está na sua lista continua igual.

> **Abriu em outro aparelho ou em outra aba?**
>
> Se você começou no computador da loja e abriu o endereço no celular, o botão **Continuar de onde
> parei** não aparece — os ajustes de coluna ficam guardados só na aba onde você os fez. Nesse
> caso use **Descartar e escolher outra** e mande a planilha de novo; é rápido.

Se a importação já estiver **trazendo os clientes** naquele momento, só aparece
**Ver o andamento** — nessa altura não dá para descartar, e não precisa: é só
esperar terminar.

## Ver as importações anteriores

Uma importação não acaba quando você fecha a página. Para voltar a qualquer
uma delas, toque em **Importar** na lista de **Clientes** e depois em
**Importações anteriores**, embaixo da área de escolher arquivo.

A lista mostra, da mais recente para a mais antiga:

-   o **nome da planilha** e quando você mandou;
-   em que pé está, escrito por extenso — _Concluída_, _Trazendo agora…_,
    _Você parou antes de confirmar_, _Não deu certo_…;
-   o resultado, quando já terminou — por exemplo **1.102 novos · 168 já
    tinham**.

Tocar numa importação terminada abre o resultado dela (inclusive o botão de
baixar as linhas com erro). Tocar numa que ficou pela metade leva você de volta
para a tela onde parou.

## O que acontece depois

-   Os clientes novos aparecem na sua lista de **Clientes**.
-   Quem **já tinha conta** (na sua barbearia ou já cadastrado na plataforma)
    é vinculado à sua lista sem perder o histórico dele.
-   Se algum cliente novo parecer alguém que você já tem, ele aparece em
    **Possíveis duplicados** para você revisar e juntar depois. Veja
    [Encontrar cadastros duplicados](/business-admin/clients/find-duplicate-clients).
-   Se alguma linha deu erro, aparece o botão **Baixar as linhas com erro**.

## Corrigindo o que deu errado

A planilha de erro volta com as **suas colunas originais**, no mesmo formato
que você mandou, mais duas colunas explicando o motivo de cada linha.

1. Baixe o arquivo e abra na sua planilha de sempre.

2. Corrija as linhas apontadas (telefone inválido, sem nome, e-mail repetido…).

3. Salve e envie o mesmo arquivo de novo. As colunas que começam com `_` são ignoradas — não
   precisa apagar nada.

## Atenção

> **Autorização de marketing não vem na planilha**
>
> Mesmo que o seu arquivo tenha uma coluna tipo "aceita promoções", nós não trazemos. Pela LGPD,
> essa autorização é específica de quem coletou — para enviar campanhas, ela precisa ser dada aqui
> dentro.

-   **Trazemos nome, telefone, e-mail e data de aniversário.** CPF, endereço e
    histórico de agendamento ficam de fora — mesmo que estejam na sua planilha,
    essas colunas caem em "não vamos trazer".
-   **Telefone sem código de país é lido como sendo do país da sua loja.** Uma
    planilha com `912345678` numa loja em Portugal entra como `+351 912 345 678`;
    numa loja no Brasil, `11988761122` entra como `+55 11 98876-1122`. O país vem
    do que você respondeu em **Ajustes → Perfil → País da operação** — se estiver
    em branco, o sistema deduz pelo idioma e pela moeda. Números que já venham com
    `+` são respeitados como estão.
-   **Data de aniversário que não dá para ler não derruba o cliente.** Ele
    entra normalmente, só sem a data; a tela "Como vai ficar" avisa quantos
    ficaram assim, e você completa depois no cadastro de cada um.
-   **Não dá para desfazer** uma importação por enquanto. Por isso a tela
    "Como vai ficar" existe: confira os números antes de confirmar.
-   **Não alteramos cadastros que você já tem.** Se o cliente já está na sua
    lista, mantemos o que está lá — a planilha não sobrescreve nada.
-   Arquivos **.xlsx** não são aceitos. Salve como CSV UTF-8 antes.

## Problemas comuns

-   **"Só conseguimos ler planilhas .csv"** — o arquivo está em .xlsx ou .xls.
    No Excel: Arquivo → Salvar como → CSV UTF-8.
-   **"Já existe uma importação em andamento"** — você tem uma importação
    começada. Entre em **Importar**: o aviso aparece na hora, com **Continuar de
    onde parei** e **Descartar e escolher outra**. Veja
    a seção **Se já tem uma importação começada**, abaixo.
-   **"Você já enviou muitas planilhas na última hora"** — há um limite de
    envios por hora. A mensagem diz em quantos minutos você pode tentar de novo.
-   **Acentos aparecem errados** — salve de novo escolhendo **CSV UTF-8**, não
    só "CSV".
-   **"Escolha qual coluna tem o nome do cliente"** — sua planilha tem um
    cabeçalho que não reconhecemos. Abra o botão
    **+ N informações que não vamos trazer** e aponte a coluna certa.
-   **Esta etapa expirou** — você abriu o endereço numa aba nova ou deixou a
    página parada tempo demais. Volte para **Importar** e descarte a importação
    começada para poder mandar a planilha de novo.
-   **Apertei o botão e não aconteceu nada** — não deve mais acontecer: quando
    algo dá errado, a tela agora rola sozinha até o aviso vermelho. Se aparecer
    um aviso com **Código:** e um nome estranho no fim, mande esse código para o
    suporte — é o que a gente precisa para achar o problema.

## Relacionados

-   [Cadastrar um cliente](/business-admin/clients/add-client)
-   [Encontrar cadastros duplicados](/business-admin/clients/find-duplicate-clients)
-   [Entender a lista de clientes](/business-admin/clients/understand-client-list)

## Leia também

- [Como cadastrar um cliente](https://docs.barbeiro.app/business-admin/clients/add-client)
- [Encontrar cadastros duplicados de clientes](https://docs.barbeiro.app/business-admin/clients/find-duplicate-clients)
- [Como ler e usar a lista de pessoas](https://docs.barbeiro.app/business-admin/clients/understand-client-list)