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 de Importação

  • No menu superior, passe o mouse em Importação de Dados e selecione Clientes.



  • 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.



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

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.
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.



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.


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.

Atualizado em: 02/09/2026

Este artigo foi útil?

Compartilhe seu feedback

Cancelar

Obrigado!