Importações

Use Importações para trazer uma lista existente de clientes para o Zellbox de uma só vez. Aceita CSV e Excel (.xlsx). O mapeamento de campos é interativo — o importador palpita, você confirma.

Importando uma lista de clientes

1. Abra Importações na barra lateral.
2. Clique em + Nova importação.
3. Escolha o arquivo (CSV ou Excel).
4. O assistente percorre quatro passos:
   • Escolher campos — o importador mapeia automaticamente os cabeçalhos das colunas para os campos de cliente do Zellbox (nativos + personalizados). Confirme ou escolha outro campo para cada coluna. Colunas não mapeadas são ignoradas. Colunas reconhecidas: nome / sobrenome / nome completo, e-mail, telefone, data de nascimento, gênero, idioma, tags, endereço (ou seus componentes), país, origem, e-mail do responsável (resolve para o gerente atribuído) e notas (vira uma nota do cliente criada logo após a linha).
   • Formato — formato de data (MDY / DMY / YMD / ISO) e formato de número (US / EU). Detectados automaticamente a partir dos dados, mude se o palpite estiver errado.
   • Padrões — controles tri-estado por campo (Pular / Fallback / Override) para os valores a aplicar em todas as linhas quando uma coluna estiver ausente ou vazia. Três slots relevantes para locale são pré-hidratados a partir de fontes sensatas para que você raramente precise tocar neles:
     • Idioma padrão: começa com sua última importação (lembrada no navegador) ou, na primeira importação, com o idioma padrão do cliente do workspace. Rede de segurança no backend: mesmo se você pular este passo, o worker cai no padrão do workspace por linha para que os clientes nunca cheguem com o campo de idioma vazio.
     • País padrão: lembrado entre importações.
     • Ordem do nome (nome primeiro / sobrenome primeiro): lembrada entre importações.
   • Confirmar — veja o cálculo dos limites do plano, linhas de exemplo já resolvidas e um Iniciar em um clique. Inicia a importação em segundo plano.
5. O importador processa as linhas em lotes e reporta o progresso ao vivo. Você recebe um resumo no fim: criados / pulados / com erro, com um CSV para baixar das linhas que falharam.

Para listas muito grandes, divida em vários arquivos — cada importação é um job.

Como o idioma é resolvido por linha

O customer.language de cada linha é resolvido por esta cascata, nesta ordem:

1. Célula do CSV — se a linha tiver uma coluna "Idioma" e ela não estiver vazia.
2. Fallback do assistente — o valor de Idioma padrão do passo Padrões (quando definido no modo Fallback).
3. Padrão do workspace — a rede de último recurso do worker, puxada de Conta → Geral → Idioma padrão do cliente.
4. Override do assistente — quando definido no modo Override, vence sobre tudo acima. Escolha isto quando "cada linha deste arquivo recebe idioma = pt-BR" independentemente dos dados de origem.

Esta é a mesma cascata que o formulário de criação individual de cliente segue, então uma linha importada aqui fica indistinguível de uma digitada manualmente no formulário.

Erros

Modos de falha comuns que erram uma única linha (o restante da importação continua):

• E-mail inválido — a linha vai para erro, não é criada.
• Falha ao interpretar a data — a data não combina com o formato escolhido no passo Formato. Corrija a entrada ou mude o formato escolhido.
• E-mail do responsável não corresponde a um membro do workspace — a linha vai para erro. Convide o membro primeiro, depois reimporte as linhas com falha.

Linhas com erro são retornadas como um CSV que você pode corrigir e reimportar.