> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://hoopdecor.crisp.help/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Importação de Clientes no HoopCRM

Precisa cadastrar ou atualizar vários clientes de uma só vez?
A importação de dados permite que você traga sua base de contatos externa para o HoopCRM de forma massiva, economizando tempo e centralizando suas informações de vendas e marketing em um só lugar.

Neste artigo, você verá:
* [Configurações da Importação](#3-configuracoes-de-importacao)
* [Campos e Validações](#3-campos-e-validacoes)
* [Como Importar](#3-como-importar)
* [Regras de duplicidade](#3-regras-de-duplicidade)

### Configurações de Importação
* No menu superior, passe o mouse em **Importação de Dados** e selecione **Clientes**.

![](https://storage.crisp.chat/users/helpdesk/website/-/3/7/7/a/377a4172135ea400/screenshot4_mlbf0o.png =241xauto)

* Na tela que abrir, você verá a estrutura da tabela aceita pelo sistema.
Antes de importar seus clientes, é importante verificar a configuração que controla o comportamento ao encontrar duplicatas.
**Onde acessar:**
* Procure pela seção **"Configurações"** no topo da página.

![](https://storage.crisp.chat/users/helpdesk/website/-/3/7/7/a/377a4172135ea400/peek1_yzjvx.gif =990xauto)

###### Chave "Editar clientes com e-mail ou telefone iguais"
Esta opção controla como o sistema se comporta quando encontra um cliente já existente com o mesmo e-mail ou telefone:
* **Ativada (ligada)** ✅: O sistema irá **editar e atualizar** o cliente existente com os novos dados da importação
* **Desativada (desligada)** ❌: O sistema irá **bloquear a linha** com erro de duplicidade
> 💡 **Dica importante**: Se você está importando uma atualização de clientes já existentes, certifique-se de que esta opção está **ligada**. Caso contrário, todas as linhas com e-mail ou telefone repetido serão rejeitadas.

### Campos e Validações
###### Campos Obrigatórios
Para que a importação seja bem-sucedida, estes três campos são imprescindíveis:
**Nome**
* Identificação do cliente.
* Não pode estar vazio.
**Tipo**
* Apenas dois valores aceitos: **PF** (Pessoa Física) ou **PJ** (Pessoa Jurídica)
* Qualquer outro valor bloqueará a linha.
**E-mail ou Telefone** (pelo menos um dos dois)
* É obrigatório preencher **no mínimo um** desses campos.
* Se ambos estiverem vazios, a linha falhará com o erro: *"Campo email ou telefone deve ser preenchido".*
> ⚠️ Não é possível importar clientes com apenas nome e tipo. E-mail ou telefone são informações de contato imprescindíveis.

###### Campos Opcionais
Você pode preencher também:
* **E-mail**
* **Telefone**
* **CPF/CNPJ**
* **Responsável**
* **Data de Nascimento**
* **Endereço** (logradouro, número, complemento, bairro, cidade, estado, CEP)
* **Categoria**
* **Campos Extras**
* **Opt-ins**
Cada um desses campos tem regras de validação específicas:
**E-mail**
* Formato obrigatório: usuario@dominio.com
* Exemplo válido: jefferson@hoopcompany.com
**CPF/CNPJ**
* Apenas números, pontos e hífens.
* Exemplos válidos: `123.456.789-10` ou `12345678000190`
> ⚠️ **Importante**: Se sua empresa possui integração com um sistema ERP, **atenção especial ao campo CPF/CNPJ durante a importação de clientes**. Quando você envia um pedido de venda do HoopCRM para o ERP, o sistema solicita o documento do cliente (CPF para Pessoa Física ou CNPJ para Pessoa Jurídica). **Caso o cliente não tenha esse dado preenchido no HoopCRM, a integração falhará** e o pedido não será exportado para o ERP.
>
> **O que fazer**: Se você tem clientes com ERP integrado, certifique-se de preencher o CPF ou CNPJ durante a importação, mesmo que não seja obrigatório no HoopCRM. Valide seus dados antes de importar: confirme se todos os clientes que irão gerar pedidos têm o documento cadastrado. Se descobrir que faltam documentos após a importação, você pode editá-los manualmente no CRM ou fazer uma nova importação com a opção "Editar clientes com e-mail ou telefone iguais" ativada.

**Telefone**
* Números, hífen, parênteses, pontos e espaços.
* Exemplos válidos: `(11) 98765-4321` ou `11 9 8765 4321`
**Número do Endereço**
* Apenas números.
* Exemplo: `250` (não aceita `250A` ou `250 apto`)
**Estado**
* Sigla com exatamente 2 letras maiúsculas.
* Exemplos válidos: `SP`, `RS`, `MG`, `BA`
**CEP**
* Apenas números e hífen.
* Formato: `12345-678` ou `12345678`
> 💡 **Dica**: Se um campo opcional estiver presente na sua planilha, ele será validado conforme o formato acima. Se não estiver preenchido, a validação é pulada automaticamente.

### Como Importar
* Copie os dados da sua planilha (**CTRL+C**) e cole diretamente na grade do sistema (**CTRL+V**).
> Utilize o modelo de planilha fornecido pelo HoopCRM para garantir a compatibilidade: [**Link para a planilha Modelo de Importação de Clientes**](https://docs.google.com/spreadsheets/d/1ImBf2zdmzUN9_gcK9_NAbarPNOuypCrF0qKhIETBCV0/edit?gid=440810358#gid=440810358).
> Coluna vermelha: **OBRIGATÓRIO**
> Coluna laranja: **Necessário preencher e-mail OU telefone do contato**.

* Após preencher as informações, clique em **Enviar Dados**.

![](https://storage.crisp.chat/users/helpdesk/website/-/3/7/7/a/377a4172135ea400/peek2_17vikx8.gif =904xauto)

### Regras de Duplicidade
Ao importar clientes, o sistema verifica se já existe um registro semelhante:
**CPF/CNPJ Repetido**
* Sempre bloqueia a importação
* Mesmo valor de CPF/CNPJ em clientes diferentes na mesma empresa resulta em erro
**E-mail ou Telefone Repetido**
* Comportamento depende da configuração de edição de clientes:
    * **Se a opção "Editar clientes com e-mail ou telefone iguais" estiver ligada** o sistema atualiza o cliente existente com os novos dados.
    * **Se a opção estiver desligada** a linha é bloqueada com erro de duplicidade.
> 💡 **Dica**: Verifique a configuração de edição de clientes antes de importar uma base com possíveis atualizações.

### Atenção aos OPTINS
Os OPTINS são obrigatórios para que você possa realizar o envio de e-mails através do sistema. Sem essa autorização, o contato será importado, mas não poderá receber suas campanhas de e-mail marketing.
* **SIM**: Contato receberá campanhas de e-mail
* **NÃO:** Contato não receberá campanhas de e-mail

Para mais detalhes referente a **Importação de Clientes para disparo de E-mails**, acesse nosso artigo referente ao módulo.
* [Importação de Clientes para Disparo de E-mails](https://hoopdecor.crisp.help/pt-br/article/importacao-de-clientes-para-disparo-de-e-mails-1l85yu0/)

|| Nota: O processamento de grandes volumes de dados pode levar algum tempo. O ícone ficará verde assim que a importação for concluída com sucesso.