> ## Documentation Index
> Fetch the complete documentation index at: https://ajuda.attende.online/llms.txt
> Use this file to discover all available pages before exploring further.
# Importando clientes
> Traga sua base de contatos para o Attende de uma vez só — via planilha CSV com nome, telefone, e-mail, empresa e etiquetas.
Se você já tem uma lista de clientes em outro sistema ou planilha, não precisa cadastrar um a um. O Attende aceita importação em lote via arquivo CSV. Em alguns minutos, toda a base está disponível para o time.
Importação de contatos é uma função exclusiva de **administradores**. Agentes não visualizam essa opção.
***
## Como funciona o processo
A importação roda em segundo plano. Você faz o upload do arquivo, o Attende processa e — ao terminar — envia um **e-mail de confirmação** para todos os administradores da conta com o resumo: quantos contatos foram importados com sucesso e, se houver falhas, um arquivo CSV com os registros rejeitados e o motivo de cada um.
Isso significa que você não precisa ficar de olho na tela. Inicie e aguarde o e-mail.
***
## Preparando o arquivo CSV
O arquivo deve ser salvo em formato **CSV com codificação UTF-8**. Planilhas do Google Sheets e do Excel exportam nesse formato — veja na seção de dúvidas como fazer isso.
### Colunas aceitas
| Coluna | Obrigatória | Formato / Observação |
| -------------- | ----------------- | --------------------------------------------------- |
| `name` | Não (recomendada) | Nome completo ou apelido |
| `email` | Não | Endereço de e-mail válido, único por conta |
| `phone_number` | Não | Formato internacional E.164 — ex.: `+5511999990000` |
| `company_name` | Não | Nome da empresa onde o contato trabalha |
| `labels` | Não | Etiquetas separadas por vírgula — ex.: `lead,vip` |
| `middle_name` | Não | Nome do meio |
| `last_name` | Não | Sobrenome |
| `location` | Não | Cidade, estado ou endereço livre |
| `country_code` | Não | Código do país — ex.: `BR` |
Nenhuma coluna é tecnicamente obrigatória, mas um contato sem `name`, `email` ou `phone_number` fica praticamente inutilizável. No mínimo, inclua o telefone ou o e-mail.
### Regras de formato
▸ **Telefone (`phone_number`):** deve seguir o padrão internacional E.164 — sempre começando com `+` e o código do país. Para números brasileiros: `+55` + DDD + número. Exemplo: `+5511987654321`.
▸ **Etiquetas (`labels`):** use as etiquetas que já existem na sua conta. Etiquetas não cadastradas são ignoradas durante o import.
▸ **E-mail:** registros com e-mail duplicado em relação a um contato que já existe na conta são ignorados silenciosamente — o contato existente não é alterado.
### Exemplo de arquivo
```csv theme={null}
name,email,phone_number,company_name,labels
Ana Lima,ana@empresa.com,+5511999990001,Empresa A,vip,lead
Carlos Souza,,+5511999990002,Empresa B,
Mariana Costa,mariana@outra.com,,,
```
***
## Fazendo o upload
No menu lateral, clique em **Contatos** (ícone de pessoa).
No canto superior direito da tela de Contatos, clique no ícone de **importar** (seta para cima) ou no menu de opções.
Na janela que abrir, escolha o arquivo CSV preparado. O upload começa imediatamente.
O processamento roda em segundo plano. Você — e os demais administradores da conta — receberão um e-mail quando concluir. Não precisa manter a aba aberta.
***
## Lendo o e-mail de resultado
O e-mail de resultado traz três informações:
▸ **Contatos importados com sucesso** — número de registros que entraram na base.
▸ **Registros com falha** — número de linhas que não puderam ser importadas.
▸ **Arquivo de erros** — se houver falhas, um CSV para download. Ele contém as linhas rejeitadas com uma coluna extra chamada `errors` explicando o motivo de cada rejeição (e-mail inválido, telefone fora do formato, arquivo em branco etc.).
Corrija os registros do arquivo de erros e faça um novo upload só com eles.
***
## Sobre duplicados
O Attende detecta automaticamente contatos que já existem na conta — por **e-mail** ou **telefone** — e os ignora durante o import. O contato existente não é sobrescrito nem duplicado.
A importação não atualiza dados de contatos existentes. Se um cliente já cadastrado teve o nome ou empresa alterados, a mudança precisa ser feita manualmente na ficha dele.
***
## Dúvidas comuns
**Google Sheets:** Arquivo → Fazer download → Valores separados por vírgula (.csv). O Google já exporta em UTF-8.
**Excel:** Arquivo → Salvar como → Tipo: "CSV UTF-8 (delimitado por vírgula) (.csv)". Atenção: escolha a versão UTF-8, não o CSV padrão, para evitar problemas com acentos e caracteres especiais.
Não há um limite rígido de linhas por arquivo. O processamento é feito em lotes de 1.000 registros internamente, o que garante estabilidade mesmo em bases maiores. Para bases muito grandes (acima de 50 mil linhas), considere dividir em múltiplos arquivos para facilitar a análise de erros.
Etiquetas que não foram cadastradas previamente são ignoradas. Antes de importar, crie as etiquetas necessárias em **Configurações → Etiquetas** para que sejam aplicadas corretamente aos contatos.
Não diretamente pelas colunas padrão. Os campos personalizados criados em **Configurações → Atributos personalizados** precisam ser preenchidos manualmente nas fichas dos contatos após a importação.
Verifique a caixa de spam e o e-mail do administrador da conta. Se após 30 minutos o e-mail não chegou, tente uma importação com um arquivo menor para validar o processo. Em caso de persistência, entre em contato com o suporte do Attende.
***
Com a base importada, a equipe já pode abrir conversas, aplicar etiquetas e acompanhar o histórico de cada cliente — tudo centralizado. Ponto.
**Próximos artigos desta seção:** ▸ [Bloqueando contatos](/crm/bloqueando-contatos)