Importação e qualidade dos dados
Traga sua base para o FlakeDesk e mantenha-a limpa: importação em massa por planilha (contatos + empresas), importação das conexões do LinkedIn, gestão de duplicatas e campos personalizados.
Importar dados pela planilha (Excel)
No menu lateral, abra Configurações → Importar Dados. A tela abre na aba Planilha (Excel), a forma mais rápida de trazer contatos e empresas de uma vez, sem cadastrar um a um:
- Baixe o template oficial (.xlsx) pelo botão "Baixar template" da tela (endereço
/import-template.xlsx). - Preencha as duas abas:
- Contact (contatos): Name (obrigatório), Email (obrigatório), Current Role, Company, Phone / Whatsapp, LinkedIn URL.
- Company (empresas): Company Name (obrigatório), Website, Email, Phone / Whatsapp, Company Linkedin.
- Apague a linha de exemplo de cada aba (a que começa com "Example") — se esquecer, o FlakeDesk a ignora automaticamente.
- Envie o arquivo na tela. O preview mostra quantos contatos e empresas foram encontrados (e avisa sobre linhas sem nome ou e-mails inválidos) antes de você confirmar.
Validação antes de importar
O preview valida tudo e mostra dois painéis antes de você confirmar:
- Erros (vermelho) — linhas que NÃO serão importadas: nome ausente ou com mais de 255 caracteres, e-mail do contato ausente ou inválido (o e-mail é obrigatório para criar um contato, como no cadastro manual) e abas com cabeçalho irreconhecível. Corrija na planilha e envie de novo para incluí-las.
- Avisos (amarelo) — campos com formato inválido são descartados, mas a linha ainda é importada sem eles: e-mail fora do padrão, telefone sem DDI/DDD válido (esperado algo como
+55 21 99999-8888, 8–15 dígitos), URLs que não começam comhttp(s)://e textos longos demais.
Cada item diz a aba, a linha e o valor problemático. O botão de importar mostra só a contagem de registros válidos (e fica desabilitado se nenhum sobrar).
Regras que valem na importação:
- Empresas são criadas antes dos contatos, e o campo Company do contato vincula pelo nome.
- E-mail único: o e-mail não pode pertencer a outro contato da organização (maiúsculas e minúsculas não fazem diferença). Contato novo com e-mail repetido, ou repetido dentro do próprio arquivo, não é criado e entra em "Sem alteração ou recusados" no relatório. Atualizar um contato que já existe continua permitido, e o e-mail do arquivo não é copiado para ele se já pertencer a outro.
- Sem duplicar: contato já existente (mesmo nome/empresa) e empresa já existente (mesmo nome) viram atualização — só campos vazios são preenchidos; o que você editou manualmente é preservado.
- Limites do plano valem aqui também: registros novos além do limite de contatos/empresas do plano ficam de fora e o relatório final informa quantos (atualizações não consomem limite).
- Até 20.000 linhas por arquivo, somando as abas de contatos e de empresas (por exemplo, 12.000 contatos e 8.000 empresas). Contam só as linhas que serão importadas: as que aparecem no painel de erros ficam de fora da conta. Se passar disso, o preview mostra o aviso "Este arquivo passa do limite de 20.000 linhas por importação" e o botão de importar fica desativado. Divida a planilha em dois ou mais arquivos e importe um de cada vez, esperando o anterior terminar.
- Cabeçalhos traduzidos (ex.: "Nome", "Empresa", "Telefone") também são reconhecidos.
A importação roda no servidor: pode navegar ou fechar a tela que o progresso continua. Ao final, o relatório mostra Novos, Atualizados e Sem alteração, com atalhos para ver contatos e empresas.
Importar conexões do LinkedIn
A aba LinkedIn (CSV) da tela Importar Dados (menu Configurações → Importar Dados) importa o arquivo oficial de conexões exportado do LinkedIn, em 4 passos: Upload → Preview → Importando → Concluído.
1. Exporte do LinkedIn
- No LinkedIn, acesse Configurações → Privacidade de Dados → Obter uma cópia dos seus dados (a tela tem o atalho "Abrir LinkedIn → Exportar Dados").
- Selecione Connections e clique em Request archive.
- Em até ~10 minutos você recebe por e-mail o link do arquivo ZIP.
2. Envie e confira
- Arraste o ZIP completo (o FlakeDesk encontra o
Connections.csvdentro dele) ou o CSV extraído. - O mapeamento é automático: nome, e-mail, empresa, cargo, data de conexão e URL do perfil.
- O preview mostra o total de conexões e marca cada linha como Novo (será criado) ou Atualização (já existe na base — os dados manuais são preservados).
- Cada importação aceita até 20.000 conexões. Se você tiver mais, selecione no máximo 20.000 de cada vez e importe o restante depois que a primeira terminar. Com mais de 20.000 selecionadas, a tela avisa quantas estão marcadas e o botão de importar fica desativado até você desmarcar as que passam do limite.
- E-mail: o arquivo do LinkedIn quase nunca traz o e-mail, então aqui o e-mail não é obrigatório (exceção à regra do cadastro manual e da planilha). Se a conexão tiver e-mail, ele não pode pertencer a outro contato da organização; nesse caso a conexão não é criada e entra em "Sem alteração ou recusados".
- Selecione quem importar ("Selecionar todos" ou individualmente) e clique em Importar.
Dica: exporte o arquivo com a coluna Profile URL presente — é ela que garante a detecção precisa de duplicados. Sem ela, a comparação é feita por nome.
3. Acompanhe e finalize
A importação roda no servidor: pode navegar ou fechar a tela que o progresso continua. Ao final, o relatório mostra Novos, Atualizados e Sem alteração — e, se o limite de contatos do plano foi atingido, quantos ficaram de fora (só contatos novos consomem limite; atualizações não).
Limites de contatos por plano: Free 500 · Starter 5.000 · Premium 25.000 · Platinum sem limite.
Outras formas de trazer dados
- Planilha (Excel): contatos + empresas em massa pelo template — seção acima.
- WhatsApp / chatbot / site / e-mail: leads entram sozinhos pelos canais conectados.
- API externa (Premium+): crie contatos e empresas por integração — guia "API externa".
- Cadastro manual: telas de Contatos e Empresas.
Gerenciar Duplicatas
No menu Configurações → Gerenciar Duplicatas, o FlakeDesk identifica contatos possivelmente repetidos (por e-mail e nome) e permite mesclar os registros preservando interações e histórico. Rode a verificação depois de grandes importações. É recurso dos planos Starter, Premium e Platinum: no plano Free a tela mostra o aviso "Duplicatas indisponíveis neste plano", com o atalho para alterar o plano. Como mesclar, passo a passo, no guia "Contatos", seção "Gerenciar Duplicatas".
Campos Personalizados
Campos personalizados guardam informações do seu negócio que não existem no cadastro padrão, como "Nível de inglês" num contato ou "Segmento de atuação" numa empresa. Eles aparecem automaticamente nos formulários de cadastro e nas páginas de detalhe. Só administradores da organização criam, editam, desativam e excluem campos; quem pode editar um contato ou uma empresa preenche os valores no próprio cadastro. O recurso existe em todos os planos.
Como criar um campo
- No menu lateral, abra Configurações → Campos Personalizados (
/settings/custom-fields). - No topo da lista, escolha Contatos ou Empresas.
- Clique em Novo campo (ou em Criar primeiro campo, quando ainda não há nenhum).
- Preencha a janela Novo campo personalizado:
- Entidade: Contatos ou Empresas.
- Rótulo: o nome que aparece na tela (ex.: "Stack principal").
- Nome interno: o identificador do campo, sem espaços nem acentos. Ele é preenchido sozinho a partir do rótulo (ex.:
stack_principal) e você pode ajustar. - Tipo de campo: escolha um dos tipos da tabela abaixo.
- Opções: só para Lista de opções e Múltipla escolha. Separe por vírgula (ex.: "Básico, Intermediário, Avançado").
- Ordem de exibição: a posição do campo no formulário (números menores aparecem antes).
- Campo obrigatório: marque para exigir o preenchimento no cadastro.
- Clique em Criar campo. Aparece "Campo criado com sucesso!".
Tipos de campo
| Tipo | Para que serve | Exemplo |
|---|---|---|
| Texto curto | Uma linha de texto | Tecnologia principal |
| Texto longo | Vários parágrafos | Observações do contrato |
| Número | Valores e quantidades | Orçamento mensal |
| Data | Uma data | Data de renovação |
| Lista de opções | Escolher uma opção de uma lista | Nível de inglês |
| Múltipla escolha | Marcar várias opções de uma lista | Canais de contato |
| Sim / Não | Uma resposta de sim ou não | Cliente recorrente |
| URL / Link | Um endereço de site | Site do portfólio |
Editar, desativar e excluir
- Editar: clique no ícone de lápis (Editar) do campo, ajuste e clique em Salvar Alterações. O nome interno de um campo já criado não muda sozinho quando você troca o rótulo.
- Desativar: clique no interruptor verde (Desativar). O campo some dos formulários e das páginas de detalhe, mas os valores já preenchidos ficam guardados. Clique de novo no interruptor (Reativar) para mostrar o campo outra vez.
- Excluir permanentemente: clique no ícone de lixeira e confirme. Isso apaga o campo e todos os valores preenchidos nele, em todos os registros, e não dá para desfazer. Se quiser só esconder o campo, use Desativar.
Erros comuns
- "Nome interno é obrigatório." ou "Rótulo é obrigatório.": preencha os dois campos antes de salvar.
- "Informe as opções separadas por vírgula.": os tipos Lista de opções e Múltipla escolha precisam de pelo menos uma opção.
- Não vejo o item Campos Personalizados no menu: ele aparece só para administradores da organização. Peça a um administrador para criar o campo.
Boas práticas
- Prefira campos personalizados a "guardar tudo nas notas": os dados ficam organizados e no mesmo lugar em todos os cadastros.
- Após importar, use o Score para avaliar os contatos mais promissores e transformar a lista em plano de ação.
Veja também
- Contatos: Cadastro, histórico de interações e responsável.
- Empresas e Funil de vendas: Empresas e o funil de vendas em estágios.
- API externa: Integrações por API com chaves e escopos.