Pular para o conteúdo principal

Importar clientes por planilha (CSV/XLSX)

O que é / Para que serve​

O assistente de importação traz a base de clientes de outra ferramenta para o Strice a partir de uma planilha .csv ou .xlsx. Cada linha vira um cliente, podendo trazer junto:

  • valores de campos personalizados (existentes ou criados na hora);
  • um contato principal por linha (nome, e-mail, telefone, cargo);
  • o estágio do ciclo de vida, o responsável (CS), a data de cancelamento e a próxima compra prevista.

A importação é somente inserção: ela cria clientes novos. Duplicatas podem ser detectadas e ignoradas, nunca mescladas.

📷 Captura: assistente de importação mostrando os 3 passos — Enviar, Mapear colunas, Importar.

Antes de começar​

  • Apenas admin e proprietário podem importar (é criação de clientes em massa).
  • Formatos aceitos: .csv e .xlsx, até 10 MB.
  • Dica: baixe a planilha de exemplo no passo 1 — ela já vem com as colunas certas e usa os nomes reais dos seus estágios como exemplo.

Passo a passo​

Acesse por Menu lateral > Clientes > Importar (botão no topo da lista).

Passo 1 — Enviar​

  1. Arraste um arquivo .csv ou .xlsx para a área indicada, ou clique em Escolher arquivo.
  2. Se estiver em dúvida sobre o formato, clique em Baixar planilha de exemplo e use-a como base.
  3. O Strice lê o cabeçalho e uma prévia das primeiras linhas e leva você ao passo de mapeamento.

Passo 2 — Mapear colunas​

Aqui você diz ao Strice o que cada coluna deve se tornar. A tela mostra uma tabela com Coluna, Exemplo (valores de amostra) e Mapeia para.

Para cada coluna, escolha um destino:

  • Ignorar — a coluna não é importada.
  • Cliente — campos do próprio cliente:
    • Nome do cliente (obrigatório mapear ao menos uma coluna aqui);
    • Tipo do cliente (PF/PJ);
    • Estágio do ciclo de vida;
    • Responsável (CS);
    • Data de cancelamento / perda;
    • Próxima compra prevista.
  • Contato principal — Nome, E-mail, Telefone ou Cargo do contato.
  • Campo personalizado existente — mapeia para um campo já criado na organização.
  • Criar um novo campo — cria um campo personalizado na hora (o tipo é inferido da amostra e pode ser ajustado; para tipo seleção há um editor de opções).

O assistente já tenta pré-mapear colunas óbvias pelo nome do cabeçalho (nome, e-mail, telefone, estágio, responsável etc.).

Ainda no passo 2:

  • Ignorar linhas duplicadas por — escolha a regra de deduplicação: Não ignorar, por E-mail do contato ou por Nome do cliente.
  • Bloqueios antes de iniciar:
    • é preciso mapear uma coluna para o Nome do cliente;
    • todos os campos personalizados obrigatórios existentes precisam estar mapeados (aparecem listados até você resolvê-los).

Quando estiver tudo certo, clique em Iniciar importação.

Passo 3 — Importar​

  1. A importação roda em segundo plano; a tela mostra o progresso (X de Y linhas) e um resumo ao vivo: importados · ignorados · com falha.
  2. Enquanto está na fila ou processando, você pode clicar em Cancelar importação.
  3. Ao terminar (concluída, falhou ou cancelada):
    • se houver linhas com falha, use Baixar relatório de erros (CSV com linha, código e detalhe do erro);
    • clique em Ver clientes para voltar à lista, ou Importar outro arquivo para começar de novo.

📷 Captura: passo Importar com a barra de progresso e o resumo "importados · ignorados · com falha".

Configuração​

Como o Strice interpreta os dados durante a importação:

  • Tipo (PF/PJ) — a coluna de tipo é convertida para pessoa física / jurídica; sem valor claro, usa o padrão do mapeamento.
  • Estágio e Responsável (CS) — casados pelo nome, sem diferenciar acentos e maiúsculas ("São Paulo" = "sao paulo"). Sem correspondência: o estágio fica em Onboarding e o responsável fica sem atribuição — isso não faz a linha falhar.
  • Campo de seleção com "criar opções automaticamente" — ao criar um campo de seleção, ligar essa opção faz qualquer valor da planilha que não esteja na lista virar uma nova opção automaticamente (ideal para migrar um campo legado). Desligada, um valor desconhecido faz a linha falhar.
  • Campos obrigatórios — na importação, um campo obrigatório com célula vazia faz a linha falhar (mais rígido que o cadastro manual).
  • Data de cancelamento — se preenchida e válida, é registrada; vazia = não cancelado; inválida = a linha falha.

Integrações com outros módulos​

  • Campos personalizados — a importação reaproveita e pode criar definições de campo; veja Campos personalizados de clientes.
  • Ciclo de vida — a coluna de estágio usa o funil da organização; veja Ciclo de vida e funil.
  • Contatos — o contato principal importado aparece na aba Contatos; veja Contatos e acesso ao portal.
  • Lista de clientes — os clientes importados entram na lista como clientes normais, em Onboarding (salvo estágio mapeado).

Dicas e limitações​

  • Somente inserção: a importação cria clientes; ela não atualiza nem mescla clientes existentes.
  • Um contato principal por linha — múltiplos contatos por cliente não são suportados na importação.
  • Falha parcial: linhas válidas são importadas mesmo que outras falhem; as com problema vão para o relatório de erros.
  • Correspondência por nome (estágio, responsável, opções) é tolerante a acentos e maiúsculas; nomes duplicados podem gerar ambiguidade.
  • Após concluir, o arquivo enviado é removido por segurança; o relatório de erros continua disponível para download.
  • Limite de 10 MB por arquivo.

Perguntas frequentes​

A importação atualiza clientes que já existem? Não. Ela apenas cria novos. Duplicatas podem ser ignoradas (pela regra que você escolher), nunca mescladas.

Uma linha com erro cancela a importação inteira? Não. As linhas boas entram normalmente; as com erro vão para o relatório de erros para você corrigir e reimportar.

Posso criar um campo personalizado direto na importação? Sim. No mapeamento, escolha Criar um novo campo para a coluna; o tipo é sugerido a partir dos dados e pode ser ajustado.

O que acontece se o estágio ou o responsável não baterem? O cliente é criado mesmo assim: o estágio fica em Onboarding e o responsável fica sem atribuição. A linha não falha por isso.

Posso importar vários contatos por cliente? Não nesta versão — apenas um contato principal por linha.

Como acompanho o andamento? O passo 3 mostra o progresso ao vivo e o resumo de importados/ignorados/com falha; você pode cancelar enquanto ainda está em andamento.