Importação de Especificadores/Arquitetos no HoopCRM

O HoopCRM permite a importação de dados de especificadores, facilitando a inclusão de grandes volumes de informações de forma rápida e eficiente.

Neste artigo, você verá:

• Configurações de Importação
• Campos e Validações
• Como importar
• Regras de Duplicidade e ID

Configurações de Importação

No menu lateral esquerdo, passe o mouse sobre a aba Importação de Dados → Especificadores.

• Na tela que abrir, você verá a estrutura da tabela aceita pelo sistema.

Antes de importar seus especificadores, é 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 especificadores com e-mail ou telefone iguais"

Esta opção controla como o sistema se comporta quando encontra um especificador já existente com o mesmo e-mail ou telefone:

• Ativada (ligada) ✅: O sistema irá editar e atualizar o especificadores 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 especificadores 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 campos são imprescindíveis:
Nome

• Identificação do especificador.
• 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".

Campos Opcionais

Você pode preencher também:

• ID
• E-mail
• CPF/CNPJ
• Data de Nascimento
• Telefone
• Endereço (logradouro, número, complemento, bairro, cidade, estado, CEP)
• Número
• Complemento
• Bairro
• Cidade
• Estado (Sigla)
• CEP
• Categoria
• RT
• Responsável
• CPF/CNPJ escritório
• Nome Escritório
• Email Escritório
• Telefone escritório
• Cargo

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

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

💡 Dica: Utilize o modelo oficial fornecido pelo HoopCRM para garantir a compatibilidade: Modelo de Planilha Padrão Especificadores.
Coluna vermelha: Campo obrigatório
Coluna laranja: Precisa preencher E-mail OU Telefone do contato.

Envie os Dados

Após preencher todos os dados na sua planilha e copiá-los para a área de texto no sistema, clique em "Enviar Dados".

Regras de Duplicidade e ID

Ao importar especificadores, o sistema verifica se já existe um registro semelhante:

Sem a Coluna ID Preenchida

E-mail Repetido

• Comportamento depende da chave "Editar especificadores com e-mail ou CPF/CNPJ iguais" (veja seção 2):
• • Se ligada ✅: O sistema irá editar o especificador existente com os novos dados.
  • Se desligada ❌: A linha é bloqueada com erro de duplicidade.

CPF/CNPJ Repetido

• Comportamento também depende da mesma chave:
• • Se ligada ✅: O sistema irá editar o especificador existente com os novos dados.
  • Se desligada ❌: A linha é bloqueada com erro de duplicidade.

Com a Coluna ID Preenchida

Comportamento Especial do ID:

• Se a coluna ID estiver preenchida, o sistema sempre atualiza o especificador com aquele ID, independente da configuração da chave.
• Se o ID preenchido não existir na base de dados, a linha falha com erro.

⚠️ Importante: A coluna ID é um identificador direto do especificador no sistema. Se você o informar, a importação usará esse ID como referência de atualização, ignorando as regras de duplicidade normais.

Atualizado em: 01/09/2026